MCP Salesforce

Activer le serveur MCP Salesforce

Dans Salesforce, ouvrez Setup.

1. Dans Quick Find, recherchez MCP Servers.
2. Ouvrez MCP Servers sous API Catalog.
3. Activez le serveur que vous souhaitez utiliser. Pour la première configuration, activez platform/sobject-reads.
4. Attendez jusqu'à 2 minutes que le serveur devienne actif.

Si vous prévoyez d'utiliser l'exemple d'accès complet, activez plutôt platform/sobject-all.

Créer une application cliente externe

Dans la configuration de Salesforce :

1. Dans Quick Find, recherchez External Client App Manager.
2. Cliquez sur New External Client App.
3. Remplissez les informations de base de l'application. Utilisez un nom clair, tel que LibreChat Salesforce MCP.
4. Développez API (Enable OAuth Settings) et activez OAuth.
5. Ajoutez l'URL de rappel LibreChat.

Pour le développement local :

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

Pour la production, remplacez l'URL de base par votre URL publique LibreChat :

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

Configurer les scopes OAuth et la sécurité

Dans les paramètres OAuth de l'application cliente externe, ajoutez ces scopes :

mcp_api
refresh_token

N'utilisez pas la portée api standard de Salesforce pour les serveurs MCP hébergés. Le serveur MCP attend la portée mcp_api.

Dans les paramètres de sécurité de l'External Client App :

• Sélectionnez Émettre des jetons d'accès basés sur des JSON Web Tokens (JWT) pour les utilisateurs nommés.
• Sélectionnez Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
• Laissez Require Secret for Web Server Flow désactivé pour la configuration de base dans ce guide.
• Laissez Require Secret for Refresh Token Flow désactivé pour la configuration de base dans ce guide.

Cliquez sur Create, puis ouvrez les paramètres de l'application et copiez la Consumer Key. Salesforce indique qu'une nouvelle External Client App peut prendre jusqu'à 30 minutes avant d'être disponible.

Ajouter l'identifiant client Salesforce à .env

Ajoutez la clé consommateur de l'application cliente externe à votre fichier .env de LibreChat :

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Si vous avez activé Require Secret for Web Server Flow, ajoutez également :

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Ajouter Salesforce MCP à librechat.yaml

Cet exemple configure le serveur SObject en lecture seule pour une organisation de production ou une 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'

Pour un environnement sandbox ou une scratch org, utilisez l'URL MCP sandbox et les endpoints OAuth Salesforce sandbox :

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'

Si votre application cliente externe nécessite un secret client, ajoutez ces champs à l'intérieur de oauth :

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

Si LibreChat est déployé sur une URL publique, mettez à jour redirect_uri pour qu'elle corresponde exactement à l'URL de rappel enregistrée dans Salesforce.

Passer à un accès complet à Salesforce, si nécessaire

Une fois que le serveur en lecture seule fonctionne, vous pouvez passer à un autre serveur Salesforce activé en modifiant l'url.

Pour un accès complet aux SObject dans une organisation de production ou Developer Edition :

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

Pour un accès complet aux SObject dans une sandbox ou une scratch org :

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

N'exposez les serveurs capables d'effectuer des mutations ou des suppressions qu'aux utilisateurs autorisés à créer, mettre à jour ou supprimer des enregistrements Salesforce via un assistant.

Redémarrer LibreChat

Redémarrez LibreChat pour qu'il recharge .env et librechat.yaml.

Pour confirmer que le serveur a bien été chargé dans Docker, vérifiez les logs de l'API :

docker logs LibreChat --tail 200 | grep MCP

Connecter Salesforce dans LibreChat

Ouvrez LibreChat, puis ouvrez MCP Settings ou le menu déroulant MCP Servers dans la zone de saisie du chat.

1. Cliquez sur Connect pour le serveur Salesforce.
2. Terminez le flux OAuth de Salesforce.
3. Examinez les portées mcp_api et refresh_token demandées.
4. Retournez sur LibreChat une fois que la page de succès OAuth se ferme.

Une fois l'authentification OAuth réussie et la connexion MCP initialisée, les outils Salesforce deviennent disponibles dans le chat et dans l'Agent Builder.