项目简介

Salesforce MCP 连接器是一个基于 Model Context Protocol (MCP) 构建的服务器实现。它允许任何兼容 MCP 的大型语言模型 (LLM) 客户端通过标准化的协议与您的 Salesforce 组织进行交互。这意味着您可以使用自然语言向 LLM 发出指令，例如查询数据、管理记录或访问开发元数据，而连接器负责将这些指令转化为对 Salesforce API 的实际调用。

主要功能点

这个连接器提供了强大的能力，让您能以全新的方式与 Salesforce 互动：

• 数据查询： 使用自然语言提出复杂的数据查询，获取关于 Salesforce 记录的洞察。LLM 会自动将其翻译成适当的 Salesforce 查询。
• 全局搜索： 在您的整个 Salesforce 组织中查找包含特定信息的记录。
• 了解数据结构： 查询 Salesforce 对象的字段和结构信息，帮助理解您的数据模型。
• 记录管理： 通过自然语言创建、更新或删除 Salesforce 记录。
• 开发工具访问： 访问和管理 Salesforce 开发相关的元数据和组件（如 Apex 类）。
• 自定义应用交互： 调用自定义的 Salesforce API 端点或服务。
• 高级 API 功能： 直接访问 Salesforce 平台的各种 API 功能。

安装步骤

本项目提供了一个本地版本，供开发者或需要自定义配置的用户使用。要使用本地版本，您无需像传统应用那样安装到系统目录，而是需要配置您的 MCP 兼容 AI 助手（即 MCP 客户端）。MCP 客户端负责启动并与这个服务器进程通信。

基本的安装概念是在您的 MCP 客户端的配置文件中指定如何启动这个 Salesforce MCP 连接器，并提供必要的 Salesforce 账户凭据。

服务器配置

为了让您的 MCP 客户端（如某些桌面 AI 助手）能够连接并使用 Salesforce MCP 连接器，您需要在客户端的配置中添加一个服务器条目。这个配置通常是一个 JSON 格式的数据，用于指导客户端如何启动和连接到 MCP 服务器。

您需要配置以下关键信息：

• 服务器名称： 给这个服务器连接取一个标识名称，例如 'salesforce'。
• 启动命令 (command)： 指定用于启动 Salesforce MCP 连接器进程的命令，例如 'uvx'。
• 启动参数 (args)： 提供传递给启动命令的参数，用于定位并运行 Salesforce 连接器模块，例如 '--from mcp-salesforce-connector salesforce'。
• 环境变量 (env)： 设置连接 Salesforce 组织所需的凭据作为环境变量，这通常包括您的 Salesforce 用户名 ('SALESFORCE_USERNAME')、密码 ('SALESFORCE_PASSWORD') 和安全令牌 ('SALESFORCE_SECURITY_TOKEN')。请务必安全地管理这些敏感信息。

具体的配置方式和文件路径取决于您使用的 MCP 客户端应用程序。配置完成后，当客户端需要访问 Salesforce 上下文时，它将按照配置启动这个连接器进程并与其通信。

基本使用方法

配置并连接成功后，您即可通过您的 MCP 客户端与 LLM 进行交互。在与 LLM 对话时，您可以像与同事交流一样，用自然语言表达您对 Salesforce 数据或操作的需求。LLM 会识别出需要与 Salesforce 交互的意图，并通过配置好的 Salesforce MCP 连接器执行相应的操作（如查询数据、创建记录等），并将结果返回给您或用于生成回复。

例如，您可以尝试这样的指令：

• "显示过去 30 天创建的所有账户的名称和年收入。"
• "创建一条新的联系人记录，名字是张三，属于 Acme 公司，电话是 555-1234。"
• "找出所有名称中包含 'Widgets' 的产品记录。"