AI导哈

Salesforce连接器

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

  • by smn2gnt
  • Python
  • 本地部署
  • 180 星标
  • 更新于
在 GitHub 查看 smn2gnt/MCP-Salesforce

使用说明

MCP Salesforce连接器

Salesforce集成的模型上下文协议（MCP）服务器实现，允许LLM通过SOQL查询和SOSL搜索与Salesforce数据交互。

特性

  • 执行SOQL（Salesforce对象查询语言）查询
  • 执行SOSL（Salesforce对象搜索语言）搜索
  • 检索Salesforce对象的元数据，包括字段名、标签和类型
  • 列出所有可用的SObjects-发现标准和自定义对象
  • 检索、创建、更新和删除记录
  • 执行工具API请求
  • 执行Apex REST请求
  • 直接对Salesforce进行REST API调用

配置

模型上下文协议

要将此服务器与模型上下文协议一起使用，您需要在 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 -列出所有可用的SObjects（标准和自定义）

单记录操作

  • get_record -按ID检索特定记录
  • create_record -创建新记录
  • update_record -更新现有记录
  • delete_record -删除记录

批量操作

  • bulk_create_records -在一次操作中创建多条记录
  • bulk_update_records -更新多条记录（必须包括Id字段）
  • bulk_delete_records -使用记录ID删除多条记录

高级API工具

  • tooling_execute -执行工具API请求
  • apex_execute -执行Apex REST请求
  • restful -直接对Salesforce进行REST API调用

Salesforce身份验证方法说明

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

  • OAuth（推荐）： 集 SALESFORCE_ACCESS_TOKEN 和 SALESFORCE_INSTANCE_URL 作为环境变量。
  • 客户端凭据： 集 SALESFORCE_CLIENT_ID 和 SALESFORCE_CLIENT_SECRET OAuth 2.0客户端凭据流。这对于服务器到服务器的集成非常有用。
  • 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身份验证方法时，将其设置为针对特定的组织别名或用户名，而不是默认组织。

相关 MCP