MCP Salesforce 连接器

一个用于 Salesforce 集成的模型上下文协议 (MCP) 服务器实现，允许 LLM 通过 SOQL 查询和 SOSL 搜索与 Salesforce 数据进行交互。

功能

• 执行 SOQL (Salesforce 对象查询语言) 查询

• 执行 SOSL (Salesforce 对象搜索语言) 搜索

• 获取 Salesforce 对象的元数据，包括字段名称、标签和类型

• 列出所有可用的 SObject - 发现标准对象和自定义对象

• 检索、创建、更新和删除记录

• 执行 Tooling API 请求

• 执行 Apex REST 请求

• 向 Salesforce 发起直接 REST API 调用

Related MCP server: Salesforce MCP Integration

配置

模型上下文协议

要将此服务器与模型上下文协议配合使用，您需要在 claude_desktop_config.json 文件中进行配置。在 mcpServers 部分添加以下条目：

{
    "mcpServers": {
        "salesforce": {
        "command": "uvx",
        "args": [
            "--from",
            "mcp-salesforce-connector",
            "salesforce"
        ],
        "env": {
            "SALESFORCE_ACCESS_TOKEN": "SALESFORCE_ACCESS_TOKEN",
            "SALESFORCE_INSTANCE_URL": "SALESFORCE_INSTANCE_URL",
            "SALESFORCE_DOMAIN": "SALESFORCE_DOMAIN"
            }
        }
    }
}

可用工具

查询和搜索工具

• run_soql_query - 针对 Salesforce 执行 SOQL 查询

• run_sosl_search - 在对象中执行 SOSL 搜索

元数据工具

• get_object_fields - 检索特定对象的字段元数据

• list_sobjects - 列出所有可用的 SObject（标准和自定义）

单条记录操作

• get_record - 按 ID 检索特定记录

• create_record - 创建新记录

• update_record - 更新现有记录

• delete_record - 删除记录

批量操作

• bulk_create_records - 在单次操作中创建多条记录

• bulk_update_records - 更新多条记录（必须包含 Id 字段）

• bulk_delete_records - 使用记录 ID 删除多条记录

高级 API 工具

• tooling_execute - 执行 Tooling API 请求

• apex_execute - 执行 Apex REST 请求

• restful - 向 Salesforce 发起直接 REST API 调用

关于 Salesforce 身份验证方法的说明

此服务器支持四种身份验证方法：

• OAuth（推荐）： 将 SALESFORCE_ACCESS_TOKEN 和 SALESFORCE_INSTANCE_URL 设置为环境变量。

• 客户端凭据： 为 OAuth 2.0 客户端凭据流设置 SALESFORCE_CLIENT_ID 和 SALESFORCE_CLIENT_SECRET。这对于服务器到服务器的集成非常有用。

• Salesforce CLI（默认组织）： 如果未设置 OAuth 环境变量，服务器将尝试使用当前工作区中活动的 Salesforce CLI 默认组织（通过 sf org display --json 或 sfdx force:org:display --json）。可选择设置 SALESFORCE_CLI_TARGET_ORG 以指定特定组织。

• 用户名/密码（旧版）： 如果未设置 SALESFORCE_ACCESS_TOKEN 和 SALESFORCE_INSTANCE_URL，服务器将回退使用 SALESFORCE_USERNAME、SALESFORCE_PASSWORD 和 SALESFORCE_SECURITY_TOKEN。

环境配置

• SALESFORCE_DOMAIN（可选）： 设置为 test 以连接到 Salesforce 沙盒环境。如果未设置或留空，服务器将连接到生产环境。

• SALESFORCE_CLI_TARGET_ORG（可选）： 使用 Salesforce CLI 身份验证方法时，设置此项以指定特定的组织别名或用户名，而不是默认组织。