Salesforce MCP

激活 Salesforce MCP 服务器

在 Salesforce 中，打开 Setup。

1. 在 Quick Find 中，搜索 MCP Servers。
2. 在 API Catalog 下打开 MCP Servers。
3. 启用您想要使用的服务器。对于首次设置，请启用 platform/sobject-reads。
4. 等待最多 2 分钟，直到服务器变为活动状态。

如果您计划使用全权访问示例，请改为启用 platform/sobject-all。

创建外部客户端应用

在 Salesforce 设置中：

1. 在 Quick Find 中，搜索 External Client App Manager。
2. 点击 New External Client App。
3. 填写基本的应用信息。请使用清晰的名称，例如 LibreChat Salesforce MCP。
4. 展开 API (Enable OAuth Settings) 并启用 OAuth。
5. 添加 LibreChat 回调 URL。

对于本地开发：

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

对于生产环境，请将基础 URL 替换为您公开的 LibreChat URL：

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

配置 OAuth 作用域和安全性

在 External Client App OAuth 设置中，添加以下 scope：

mcp_api
refresh_token

对于托管的 MCP 服务器，请勿使用标准的 Salesforce api 范围。MCP 服务器需要 mcp_api 范围。

在 External Client App 安全设置中：

• 选择 为指定用户签发基于 JSON Web Token (JWT) 的访问令牌。
• 选择 Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows。
• 在本指南的基础设置中，请保持 Require Secret for Web Server Flow 为禁用状态。
• 在本指南的基本设置中，请保持 Require Secret for Refresh Token Flow 为禁用状态。

点击 Create，然后打开应用设置并复制 Consumer Key。Salesforce 表示，一个新的 External Client App 可能需要最多 30 分钟才能生效。

将 Salesforce 客户端 ID 添加到 .env

将 External Client App 消费者密钥添加到您的 LibreChat .env 文件中：

SALESFORCE_MCP_CLIENT_ID=your-salesforce-consumer-key

如果您启用了 Require Secret for Web Server Flow，请同时添加：

SALESFORCE_MCP_CLIENT_SECRET=your-salesforce-client-secret

将 Salesforce MCP 添加到 librechat.yaml

此示例为生产环境或 Developer Edition 组织配置了只读 SObject 服务器：

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'

对于沙盒或临时组织，请使用沙盒 MCP URL 和 Salesforce 沙盒 OAuth endpoint：

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'

如果您的外部客户端应用需要客户端密钥，请在 oauth 中添加以下字段：

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

如果 LibreChat 部署在公共 URL 上，请更新 redirect_uri 以匹配在 Salesforce 中注册的确切回调 URL。

如有需要，切换至完整的 Salesforce 访问权限

在只读服务器正常工作后，您可以通过更改 url 切换到另一个已激活的 Salesforce 服务器。

若要在生产环境或 Developer Edition 组织中获得完整的 SObject 访问权限：

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

若要在沙盒或暂存组织中获得完整的 SObject 访问权限：

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

仅向应被允许通过助手创建、更新或删除 Salesforce 记录的用户公开具有变更或删除能力的服务器。

重启 LibreChat

重启 LibreChat 以便重新加载 .env 和 librechat.yaml。

要确认服务器已在 Docker 中加载，请检查 API 日志：

docker logs LibreChat --tail 200 | grep MCP

在 LibreChat 中连接 Salesforce

打开 LibreChat，然后打开 MCP Settings 或聊天输入框中的 MCP Servers 下拉菜单。

1. 点击 Salesforce 服务器的 Connect。
2. 完成 Salesforce OAuth 流程。
3. 请检查所请求的 mcp_api 和 refresh_token 作用域。
4. 在 OAuth 成功页面关闭后返回 LibreChat。

在 OAuth 验证成功且 MCP 连接初始化后，Salesforce 工具即可在聊天和 Agent Builder 中使用。