MCP do Salesforce

Ativar o servidor MCP do Salesforce

No Salesforce, abra Setup.

1. No Quick Find, pesquise por MCP Servers.
2. Abra MCP Servers em API Catalog.
3. Habilite o servidor que você deseja usar. Para a configuração inicial, habilite platform/sobject-reads.
4. Aguarde até 2 minutos para que o servidor fique ativo.

Se você planeja usar o exemplo de acesso total, habilite platform/sobject-all em vez disso.

Criar um Aplicativo Cliente Externo

No Salesforce Setup:

1. Em Quick Find, pesquise por External Client App Manager.
2. Clique em New External Client App.
3. Preencha as informações básicas do aplicativo. Use um nome claro, como LibreChat Salesforce MCP.
4. Expanda API (Enable OAuth Settings) e ative o OAuth.
5. Adicione a URL de callback do LibreChat.

Para desenvolvimento local:

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

Para produção, substitua a base URL pela sua URL pública do LibreChat:

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

Configurar escopos de OAuth e segurança

Nas configurações de OAuth do External Client App, adicione estes escopos:

mcp_api
refresh_token

Não utilize o escopo api padrão do Salesforce para servidores MCP hospedados. O servidor MCP espera o escopo mcp_api.

Nas configurações de segurança do External Client App:

• Selecione Issue JSON Web Token (JWT)-based access tokens for named users.
• Selecione Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
• Deixe Require Secret for Web Server Flow desativado para a configuração básica neste guia.
• Deixe Require Secret for Refresh Token Flow desativado para a configuração básica neste guia.

Clique em Create, depois abra as configurações do aplicativo e copie a Consumer Key. A Salesforce informa que um novo External Client App pode levar até 30 minutos para ficar disponível.

Adicione o client ID do Salesforce ao .env

Adicione a consumer key do External Client App ao seu arquivo .env do LibreChat:

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

Se você habilitou Require Secret for Web Server Flow, adicione também:

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

Adicionar o MCP do Salesforce ao librechat.yaml

Este exemplo configura o servidor SObject somente leitura para uma organização de produção ou 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'

Para um sandbox ou scratch org, use a URL de MCP de sandbox e os endpoints de OAuth de sandbox do 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 o seu External Client App exigir um client secret, adicione estes campos dentro de oauth:

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

Se o LibreChat estiver implantado em uma URL pública, atualize o redirect_uri para corresponder exatamente à URL de retorno de chamada registrada no Salesforce.

Mude para o acesso completo ao Salesforce, se necessário

Após o servidor somente leitura funcionar, você pode alternar para outro servidor Salesforce ativado alterando a url.

Para acesso total a SObject em uma organização de produção ou Developer Edition:

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

Para acesso total a SObject em um sandbox ou scratch org:

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

Exponha servidores com capacidade de mutação ou exclusão apenas para usuários que devem ter permissão para criar, atualizar ou excluir registros do Salesforce por meio de um assistente.

Reiniciar o LibreChat

Reinicie o LibreChat para que ele recarregue o .env e o librechat.yaml.

Para confirmar que o servidor foi carregado no Docker, verifique os logs da API:

docker logs LibreChat --tail 200 | grep MCP

Conectar o Salesforce no LibreChat

Abra o LibreChat, depois abra as MCP Settings ou o menu suspenso MCP Servers na entrada de chat.

1. Clique em Connect para o servidor Salesforce.
2. Conclua o fluxo OAuth do Salesforce.
3. Revise os escopos mcp_api e refresh_token solicitados.
4. Retorne ao LibreChat após a página de sucesso do OAuth fechar.

Após o sucesso do OAuth e a inicialização da conexão MCP, as ferramentas do Salesforce tornam-se disponíveis no chat e no Agent Builder.