Salesforce MCP

Aktivieren des Salesforce MCP-Servers

Öffnen Sie in Salesforce Setup.

1. Suchen Sie in Quick Find nach MCP Servers.
2. Öffnen Sie MCP Servers unter API Catalog.
3. Aktivieren Sie den Server, den Sie verwenden möchten. Aktivieren Sie für die Ersteinrichtung platform/sobject-reads.
4. Warten Sie bis zu 2 Minuten, bis der Server aktiv ist.

Wenn Sie das Beispiel mit vollem Zugriff verwenden möchten, aktivieren Sie stattdessen platform/sobject-all.

Externe Client-App erstellen

In Salesforce Setup:

1. Suchen Sie in Quick Find nach External Client App Manager.
2. Klicken Sie auf New External Client App.
3. Geben Sie die grundlegenden App-Informationen ein. Verwenden Sie einen eindeutigen Namen, wie z. B. LibreChat Salesforce MCP.
4. Erweitern Sie API (Enable OAuth Settings) und aktivieren Sie OAuth.
5. Fügen Sie die LibreChat Callback-URL hinzu.

Für die lokale Entwicklung:

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

Für die Produktion ersetzen Sie die Basis-URL durch Ihre öffentliche LibreChat-URL:

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

OAuth-Scopes und Sicherheit konfigurieren

Fügen Sie in den OAuth-Einstellungen der externen Client-App diese Scopes hinzu:

mcp_api
refresh_token

Verwenden Sie nicht den standardmäßigen Salesforce api scope für gehostete MCP-Server. Der MCP-Server erwartet den mcp_api scope.

In den Sicherheitseinstellungen der External Client App:

• Wählen Sie Issue JSON Web Token (JWT)-based access tokens for named users.
• Wählen Sie Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows aus.
• Lassen Sie Require Secret for Web Server Flow für die grundlegende Einrichtung in dieser Anleitung deaktiviert.
• Lassen Sie Require Secret for Refresh Token Flow für die grundlegende Einrichtung in dieser Anleitung deaktiviert.

Klicken Sie auf Create, öffnen Sie dann die App-Einstellungen und kopieren Sie den Consumer Key. Salesforce gibt an, dass es bis zu 30 Minuten dauern kann, bis eine neue External Client App verfügbar ist.

Fügen Sie die Salesforce-Client-ID zur .env hinzu

Fügen Sie den Consumer-Key der External Client App zu Ihrer LibreChat .env Datei hinzu:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Wenn Sie Require Secret for Web Server Flow aktiviert haben, fügen Sie außerdem Folgendes hinzu:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Salesforce MCP zu librechat.yaml hinzufügen

Dieses Beispiel konfiguriert den schreibgeschützten SObject-Server für eine Produktions- oder Developer Edition-Org:

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'

Verwenden Sie für eine Sandbox oder Scratch Org die Sandbox MCP URL und die Salesforce Sandbox OAuth endpoints:

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'

Wenn Ihre externe Client-App ein Client-Secret erfordert, fügen Sie diese Felder innerhalb von oauth hinzu:

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

Wenn LibreChat unter einer öffentlichen URL bereitgestellt wird, aktualisieren Sie redirect_uri so, dass sie exakt mit der in Salesforce registrierten Callback-URL übereinstimmt.

Bei Bedarf zum vollständigen Salesforce-Zugriff wechseln

Nachdem der schreibgeschützte Server funktioniert, können Sie zu einem anderen aktivierten Salesforce-Server wechseln, indem Sie die url ändern.

Für den vollständigen SObject-Zugriff in einer Produktions- oder Developer Edition-Org:

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

Für vollständigen SObject-Zugriff in einer Sandbox oder Scratch Org:

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

Stellen Sie Server, die Mutationen oder Löschvorgänge ausführen können, nur Benutzern zur Verfügung, die berechtigt sein sollen, Salesforce-Datensätze über einen Assistenten zu erstellen, zu aktualisieren oder zu löschen.

LibreChat neu starten

Starten Sie LibreChat neu, damit .env und librechat.yaml neu geladen werden.

Um zu bestätigen, dass der Server in Docker geladen wurde, überprüfen Sie die API-Logs:

docker logs LibreChat --tail 200 | grep MCP

Salesforce in LibreChat verbinden

Öffnen Sie LibreChat und dann MCP Settings oder das Dropdown-Menü MCP Servers in der Chateingabe.

1. Klicken Sie auf Connect für den Salesforce-Server.
2. Schließen Sie den Salesforce OAuth-Flow ab.
3. Überprüfen Sie die angeforderten mcp_api- und refresh_token-Scopes.
4. Kehren Sie zu LibreChat zurück, nachdem sich die OAuth-Erfolgsseite geschlossen hat.

Nachdem OAuth erfolgreich war und die MCP-Verbindung initialisiert wurde, stehen Salesforce-Tools im Chat und im Agent Builder zur Verfügung.