Salesforce MCP

Activeer de Salesforce MCP server

Open Setup in Salesforce.

1. Zoek in Quick Find naar MCP Servers.
2. Open MCP Servers onder API Catalog.
3. Schakel de server in die je wilt gebruiken. Voor de eerste installatie schakel je platform/sobject-reads in.
4. Wacht maximaal 2 minuten tot de server actief is.

Als je van plan bent om het full-access voorbeeld te gebruiken, schakel dan in plaats daarvan platform/sobject-all in.

Een externe client-app maken

In Salesforce Setup:

1. Zoek in Quick Find naar External Client App Manager.
2. Klik op New External Client App.
3. Vul de basisinformatie van de app in. Gebruik een duidelijke naam, zoals LibreChat Salesforce MCP.
4. Vouw API (Enable OAuth Settings) uit en schakel OAuth in.
5. Voeg de LibreChat callback URL toe.

Voor lokale ontwikkeling:

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

Voor productie, vervang de base URL door je publieke LibreChat URL:

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

OAuth-scopes en beveiliging configureren

Voeg in de OAuth-instellingen van de externe client-app deze scopes toe:

mcp_api
refresh_token

Gebruik niet de standaard Salesforce api scope voor Hosted MCP-servers. De MCP-server verwacht de mcp_api scope.

In de beveiligingsinstellingen van de External Client App:

• Selecteer Issue JSON Web Token (JWT)-based access tokens for named users.
• Selecteer Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
• Laat Require Secret for Web Server Flow uitgeschakeld voor de basisconfiguratie in deze handleiding.
• Laat Require Secret for Refresh Token Flow uitgeschakeld voor de basisconfiguratie in deze handleiding.

Klik op Create, open vervolgens de app-instellingen en kopieer de Consumer Key. Salesforce geeft aan dat het tot 30 minuten kan duren voordat een nieuwe External Client App beschikbaar is.

Voeg de Salesforce client ID toe aan .env

Voeg de consumer key van de External Client App toe aan je LibreChat .env bestand:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Als je Require Secret for Web Server Flow hebt ingeschakeld, voeg dan ook het volgende toe:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Salesforce MCP toevoegen aan librechat.yaml

Dit voorbeeld configureert de alleen-lezen SObject-server voor een productie- of 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'

Gebruik voor een sandbox of scratch org de sandbox MCP URL en 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'

Als uw externe client-app een client secret vereist, voeg dan deze velden toe binnen oauth:

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

Als LibreChat is geïmplementeerd op een openbare URL, werk dan redirect_uri bij zodat deze exact overeenkomt met de callback-URL die is geregistreerd in Salesforce.

Schakel over naar volledige Salesforce-toegang, indien nodig

Nadat de alleen-lezen server werkt, kun je overschakelen naar een andere geactiveerde Salesforce-server door de url te wijzigen.

Voor volledige SObject-toegang in een productie- of Developer Edition-org:

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

Voor volledige SObject-toegang in een sandbox of scratch org:

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

Stel servers die mutaties of verwijderingen kunnen uitvoeren alleen bloot aan gebruikers die Salesforce-records mogen aanmaken, bijwerken of verwijderen via een assistent.

LibreChat herstarten

Herstart LibreChat zodat het .env en librechat.yaml opnieuw laadt.

Om te bevestigen dat de server is geladen in Docker, controleer je de API-logs:

docker logs LibreChat --tail 200 | grep MCP

Verbind Salesforce in LibreChat

Open LibreChat en open vervolgens MCP Settings of het MCP Servers-keuzemenu in het chat-invoerveld.

1. Klik op Connect voor de Salesforce-server.
2. Voltooi de Salesforce OAuth-flow.
3. Controleer de gevraagde mcp_api en refresh_token scopes.
4. Keer terug naar LibreChat nadat de OAuth-succespagina is gesloten.

Nadat OAuth is geslaagd en de MCP-verbinding is geïnitialiseerd, worden Salesforce-tools beschikbaar in de chat en in de Agent Builder.