MCP Salesforce

Attiva il server MCP di Salesforce

In Salesforce, apri Setup.

1. In Quick Find, cerca MCP Servers.
2. Apri MCP Servers sotto API Catalog.
3. Abilita il server che desideri utilizzare. Per la configurazione iniziale, abilita platform/sobject-reads.
4. Attendi fino a 2 minuti affinché il server diventi attivo.

Se prevedi di utilizzare l'esempio ad accesso completo, abilita invece platform/sobject-all.

Crea un'applicazione client esterna

In Salesforce Setup:

1. In Quick Find, cerca External Client App Manager.
2. Fai clic su New External Client App.
3. Compila le informazioni di base dell'app. Usa un nome chiaro, come LibreChat Salesforce MCP.
4. Espandi API (Enable OAuth Settings) e abilita OAuth.
5. Aggiungi l'URL di callback di LibreChat.

Per lo sviluppo locale:

http://localhost:3080/api/mcp/salesforce/oauth/callback

Per la produzione, sostituisci il base URL con il tuo URL pubblico di LibreChat:

https://chat.example.com/api/mcp/salesforce/oauth/callback

Configura gli scope OAuth e la sicurezza

Nelle impostazioni OAuth dell'External Client App, aggiungi questi scope:

mcp_api
refresh_token

Non utilizzare lo scope api standard di Salesforce per i server MCP ospitati. Il server MCP richiede lo scope mcp_api.

Nelle impostazioni di sicurezza dell'External Client App:

• Seleziona Emetti token di accesso basati su JSON Web Token (JWT) per utenti nominati.
• Seleziona Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
• Lascia Require Secret for Web Server Flow disabilitato per la configurazione di base in questa guida.
• Lascia Require Secret for Refresh Token Flow disabilitato per la configurazione di base in questa guida.

Fai clic su Create, quindi apri le impostazioni dell'app e copia il Consumer Key. Salesforce afferma che una nuova External Client App può impiegare fino a 30 minuti per diventare disponibile.

Aggiungi il client ID di Salesforce a .env

Aggiungi la consumer key dell'External Client App al tuo file .env di LibreChat:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Se hai abilitato Require Secret for Web Server Flow, aggiungi anche:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Aggiungi Salesforce MCP a librechat.yaml

Questo esempio configura il server SObject in sola lettura per un'organizzazione di produzione o Developer Edition:

mcpServers:
  salesforce:
    type: streamable-http
    url: 'https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads'
    timeout: 90000
    initTimeout: 150000
    requiresOAuth: true
    startup: false
    oauth:
      authorization_url: 'https://login.salesforce.com/services/oauth2/authorize'
      token_url: 'https://login.salesforce.com/services/oauth2/token'
      client_id: '${SALESFORCE_MCP_CLIENT_ID}'
      scope: 'mcp_api refresh_token'
      redirect_uri: 'http://localhost:3080/api/mcp/salesforce/oauth/callback'

Per una sandbox o una scratch org, utilizza l'URL MCP della sandbox e gli endpoint OAuth della sandbox di Salesforce:

mcpServers:
  salesforce:
    type: streamable-http
    url: 'https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-reads'
    timeout: 90000
    initTimeout: 150000
    requiresOAuth: true
    startup: false
    oauth:
      authorization_url: 'https://test.salesforce.com/services/oauth2/authorize'
      token_url: 'https://test.salesforce.com/services/oauth2/token'
      client_id: '${SALESFORCE_MCP_CLIENT_ID}'
      scope: 'mcp_api refresh_token'
      redirect_uri: 'http://localhost:3080/api/mcp/salesforce/oauth/callback'

Se la tua External Client App richiede un client secret, aggiungi questi campi all'interno di oauth:

oauth:
  client_secret: '${SALESFORCE_MCP_CLIENT_SECRET}'
  token_exchange_method: default_post
  token_endpoint_auth_methods_supported: ['client_secret_post']

Se LibreChat è distribuito su un URL pubblico, aggiorna redirect_uri affinché corrisponda esattamente all'URL di callback registrato in Salesforce.

Passa all'accesso completo a Salesforce, se necessario

Dopo che il server in sola lettura funziona, puoi passare a un altro server Salesforce attivato modificando l'url.

Per un accesso completo agli SObject in un'organizzazione di produzione o Developer Edition:

url: 'https://api.salesforce.com/platform/mcp/v1/platform/sobject-all'

Per un accesso completo agli SObject in una sandbox o in una scratch org:

url: 'https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-all'

Esponi i server con capacità di modifica o eliminazione solo agli utenti a cui dovrebbe essere consentito creare, aggiornare o eliminare record Salesforce tramite un assistente.

Riavviare LibreChat

Riavvia LibreChat in modo che ricarichi .env e librechat.yaml.

Per confermare che il server sia stato caricato in Docker, controlla i log dell'API:

docker logs LibreChat --tail 200 | grep MCP

Connettere Salesforce in LibreChat

Apri LibreChat, quindi apri MCP Settings o il menu a discesa MCP Servers nell'input della chat.

1. Fai clic su Connect per il server Salesforce.
2. Completa il flusso OAuth di Salesforce.
3. Esamina gli scope mcp_api e refresh_token richiesti.
4. Torna a LibreChat dopo la chiusura della pagina di successo OAuth.

Dopo che l'OAuth ha avuto successo e la connessione MCP è stata inizializzata, gli strumenti Salesforce diventano disponibili nella chat e nell'Agent Builder.