> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/avanzate/integrazioni/model-context-protocol-mcp-su-aisuru/mcp-di-aisuru-quali-sono-e-come-si-attivano/12.-salesforce-mcp-server.md).

# 12. Salesforce MCP Server

Salesforce MCP Server consente al tuo Agente di interagire con Salesforce tramite NPX(Node Package eXecute). Fornisce accesso ai dati e alle funzionalità di Salesforce utilizzando le credenziali client OAuth 2.0.

In parole semplici, è una piattaforma che le aziende usano per gestire clienti, vendite, contatti e dati aziendali, come una rubrica digitale combinata con uno strumento di monitoraggio delle vendite.

## **Cosa fa questo MCP?**

Attivando questo MCP, l'utente concede essenzialmente a un assistente IA la possibilità di **comunicare direttamente con il proprio account Salesforce**. Questo significa che il tuo Agente può:

* **Leggere i dati**, ad esempio cercando un cliente, una trattativa o un contatto archiviato in Salesforce;
* **Creare o aggiornare record**, ad esempio aggiungendo un nuovo contatto o aggiornando lo stato di una vendita;
* **Cercare tra le informazioni Salesforce dell'utente**, senza che l'utente debba accedere e farlo manualmente;
* **Eseguire azioni in Salesforce**, in base alle istruzioni dell'utente fornite in semplice linguaggio conversazionale.

## **Esempio**

Invece di accedere a Salesforce, navigare tra i menu e cercare un cliente, chiedi semplicemente all'IA: ad esempio, ***"Trova il valore dell'ultima trattativa con Acme Corp"***.

## Parametri di configurazione

| Parametro                    | Obbligatorio | Descrizione                                                                                                          |
| ---------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------- |
| `salesforce_client_id`       | Sì           | ID client dell'App connessa registrata su Salesforce.                                                                |
| `salesforce_client_secret`   | Sì           | Segreto client dell'App connessa Salesforce.                                                                         |
| `salesforce_instance_url`    | Sì           | URL della tua istanza Salesforce (ad es. `https://acme.my.salesforce.com`).                                          |
| `salesforce_connection_type` | No           | Tipo di connessione OAuth. Predefinito: `OAuth_2.0_Client_Credentials`. Modifica solo se utilizzi un flusso diverso. |

### Parametri personalizzati

* **apiVersion**: versione dell'API Salesforce;
* **timeout**: tempo massimo della richiesta (secondi);
* **retries**: tentativi in caso di errore;
* **loginUrl**: URL di autenticazione (diverso per sandbox);
* **maxRecords**: numero massimo di record per query.

```json
{
  "apiVersion": "v60.0",
  "timeout": 60,
  "retries": 3,
  "loginUrl": "https://login.salesforce.com",
  "maxRecords": 2000
}
```
