MCP Salesforce

Aktywacja serwera MCP Salesforce

W Salesforce otwórz Setup.

1. W Quick Find wyszukaj MCP Servers.
2. Otwórz MCP Servers w sekcji API Catalog.
3. Włącz serwer, którego chcesz użyć. W przypadku pierwszej konfiguracji włącz platform/sobject-reads.
4. Poczekaj do 2 minut, aż serwer stanie się aktywny.

Jeśli planujesz użyć przykładu pełnego dostępu, włącz zamiast tego platform/sobject-all.

Tworzenie zewnętrznej aplikacji klienckiej

W konfiguracji Salesforce:

1. W Quick Find wyszukaj External Client App Manager.
2. Kliknij New External Client App.
3. Wypełnij podstawowe informacje o aplikacji. Użyj jasnej nazwy, takiej jak LibreChat Salesforce MCP.
4. Rozwiń API (Enable OAuth Settings) i włącz OAuth.
5. Dodaj adres URL wywołania zwrotnego (callback URL) LibreChat.

Do lokalnego programowania:

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

W środowisku produkcyjnym zastąp adres bazowy swoim publicznym adresem URL LibreChat:

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

Konfiguracja zakresów (scopes) OAuth i bezpieczeństwa

W ustawieniach OAuth zewnętrznej aplikacji klienckiej dodaj następujące zakresy (scopes):

mcp_api
refresh_token

Nie używaj standardowego zakresu (scope) api Salesforce dla serwerów Hosted MCP. Serwer MCP oczekuje zakresu mcp_api.

W ustawieniach zabezpieczeń External Client App:

• Wybierz Wydawaj tokeny dostępu oparte na JSON Web Token (JWT) dla nazwanych użytkowników.
• Zaznacz Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
• Pozostaw opcję Require Secret for Web Server Flow wyłączoną na potrzeby podstawowej konfiguracji w tym przewodniku.
• Pozostaw opcję Require Secret for Refresh Token Flow wyłączoną dla podstawowej konfiguracji w tym przewodniku.

Kliknij Create, a następnie otwórz ustawienia aplikacji i skopiuj Consumer Key. Salesforce informuje, że udostępnienie nowej aplikacji External Client App może zająć do 30 minut.

Dodaj identyfikator klienta Salesforce do .env

Dodaj klucz konsumenta External Client App do swojego pliku .env w LibreChat:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Jeśli włączyłeś Require Secret for Web Server Flow, dodaj również:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Dodawanie Salesforce MCP do librechat.yaml

Ten przykład konfiguruje serwer SObject tylko do odczytu dla organizacji produkcyjnej lub 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'

W przypadku środowiska typu sandbox lub scratch org, użyj adresu URL MCP dla sandboxa oraz punktów końcowych OAuth dla sandboxa 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'

Jeśli Twoja zewnętrzna aplikacja kliencka wymaga klucza tajnego klienta (client secret), dodaj te pola wewnątrz oauth:

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

Jeśli LibreChat jest wdrożony pod publicznym adresem URL, zaktualizuj redirect_uri, aby odpowiadał dokładnemu adresowi URL wywołania zwrotnego (callback URL) zarejestrowanemu w Salesforce.

Przełącz na pełny dostęp do Salesforce, jeśli to konieczne

Gdy serwer tylko do odczytu zacznie działać, możesz przełączyć się na inny aktywny serwer Salesforce, zmieniając url.

Aby uzyskać pełny dostęp do SObject w organizacji produkcyjnej lub Developer Edition:

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

Aby uzyskać pełny dostęp do SObject w środowisku sandbox lub scratch org:

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

Udostępniaj serwery z możliwością modyfikacji lub usuwania tylko tym użytkownikom, którzy powinni mieć uprawnienia do tworzenia, aktualizowania lub usuwania rekordów Salesforce za pośrednictwem asystenta.

Restart LibreChat

Zrestartuj LibreChat, aby ponownie wczytać .env oraz librechat.yaml.

Aby potwierdzić, że serwer załadował się w Docker, sprawdź logi API:

docker logs LibreChat --tail 200 | grep MCP

Połącz Salesforce w LibreChat

Otwórz LibreChat, a następnie otwórz MCP Settings lub rozwijane menu MCP Servers w polu wprowadzania czatu.

1. Kliknij Connect dla serwera Salesforce.
2. Dokończ proces OAuth Salesforce.
3. Przejrzyj wymagane zakresy mcp_api oraz refresh_token.
4. Wróć do LibreChat po zamknięciu strony sukcesu OAuth.

Po pomyślnym zakończeniu OAuth i zainicjowaniu połączenia MCP, narzędzia Salesforce stają się dostępne na czacie oraz w Agent Builder.