参考

连接外部 AI 客户端

定义

如果你平时在 WorkBuddy、豆包或其他支持自定义 MCP 服务的 AI 客户端中工作，可以把企企智客作为一个 MCP 服务接入。接入后，外部 AI 客户端可以在你授权的范围内查询工作空间中的业务数据，把客户、联系人和商机信息带入当前对话。

产品内的智客 AI 不需要 MCP。MCP 只用于把工作空间连接到外部兼容的 AI 客户端或工作流；工具是否可见、是否允许写入，取决于当前运行环境的工具策略、账号权限和配置状态。

支持范围

查询能力

数据类型	可以做什么
客户	按关键词或记录 ID 查询客户信息
联系人	按关键词或记录 ID 查询联系人信息
商机	按关键词或记录 ID 查询商机信息
业务清单	列出可见业务清单、发现字段，并按 View、筛选和排序查询业务清单记录

创建和修改能力

当前代码已经注册以下外部 MCP 写入工具，外部客户端重新加载工具列表后，实际可用范围以客户端显示的工具和当前权限为准：

创建、修改客户、联系人和商机记录。
转移客户负责人和商机负责人。
更新商机阶段。
创建、修改和完成任务。
创建和修改活动，用于写入电话、会议、拜访或跟进等沟通记录。
创建和修改笔记；联系人笔记是否可用以当前工具定义为准。
在当前开放策略和权限范围内，把记录加入业务清单、更新业务清单局部属性，或从业务清单移除；这些操作不会自动修改或删除父级客户、联系人或商机。

当前代码中未注册外部 MCP 邮件发送工具。

选项与说明

适用场景

在外部 AI 对话中查找某个客户或联系人。
根据客户资料准备沟通背景或问题清单。
查询商机当前已有的基础记录，再继续整理分析。
在不离开当前 AI 客户端的情况下获取企企智客中的业务信息。
查询一次市场活动、大客户攻坚或售前 POC 业务清单，整理待处理对象，并在用户确认后更新局部进展。

开始前准备

你需要满足两个条件：

已经登录企企智客，并进入正确的工作空间。
外部 AI 客户端支持添加自定义 MCP 服务，或支持粘贴包含 mcpServers 的 JSON 配置。

WorkBuddy、豆包等客户端的设置名称和操作位置可能不同，请以当前客户端页面为准。企企智客侧不要求专门的 WorkBuddy OAuth 登录跳转，而是使用每份配置中的独立授权 token。

创建 MCP 配置

打开“设置 → AI 客户端连接”。
选择“创建配置”。
为配置填写一个容易识别的名称，例如“WorkBuddy”或“豆包”。
创建成功后，在右侧“MCP JSON”区域确认配置。
选择复制按钮，复制完整 JSON。

每个外部客户端都可以创建独立配置。这样可以单独识别、停用或删除某个客户端，不影响其他客户端的连接。

添加到外部客户端

在 WorkBuddy、豆包或其他客户端中找到添加 MCP 服务的入口，将刚才复制的完整 JSON 粘贴进去并保存。配置通常包含服务地址和 Authorization 请求头，不要手动改写 token、服务地址或 JSON 结构。

配置示例的结构如下，示例中的地址和 token 仅用于说明格式，不能直接使用：

{
  "mcpServers": {
    "企企智客": {
      "url": "https://你的产品域名/api/external-mcp/mcp",
      "headers": {
        "Authorization": "Bearer 仅示例"
      }
    }
  }
}

保存后，让外部客户端重新加载 MCP 工具列表。客户端能看到当前环境开放的查询或写入工具，并成功返回当前账号可见的数据，就说明接入完成。

确认接入成功

可以在外部客户端中提出一个范围明确的问题，例如：

查询名称中包含“某某”的客户，只返回我当前工作空间可见的记录。

然后检查结果：

客户端是否识别到企企智客 MCP 服务。
是否能够返回客户、联系人或商机查询结果。
结果是否属于当前工作空间和当前账号可见范围。
没有匹配记录时，是否明确返回没有结果，而不是猜测一条记录。

首次接入建议先使用查询请求确认对象和权限范围，再使用一条可回滚或容易核对的测试记录验证写入工具。涉及真实客户数据时，先确认外部客户端展示的工具名称、参数和即将产生的变更。

用 WorkBuddy 查询业务清单

可以先提出只读请求：

查看“秋季客户交流会邀约推进”，列出还没有明确反馈的客户、当前负责人和下一步。只使用企企智客返回的数据，没有值时标记待补充，不要猜测，也不要修改任何数据。

需要写入时，把工作空间、业务清单、对象和业务清单局部字段说清楚，并要求客户端先展示将要发生的变化。业务清单局部属性只在当前清单中成立；不要把它当成客户或商机的正式字段。

限制

查询结果遵守当前账号、成员和工作空间的数据访问范围。
MCP 不会绕过权限，也不会返回其他工作空间的数据。
写入操作仍经过字段可写性、对象关系、权限和业务治理校验。
业务清单查询和写入同时受到业务清单访问权、父记录权限和字段合同限制；共享清单不会扩大客户、联系人或商机权限。
只有客户端工具列表中已经开放的操作可以执行，改变提示语不会获得额外权限。
当前未注册外部 MCP 邮件发送工具。
WorkBuddy、豆包等客户端的设置位置和 MCP 支持方式以其当前页面为准。

注意事项

MCP 配置中的 Authorization 是可以调用企企智客数据的长期凭证，应当像密码一样管理：

只粘贴到你信任的客户端。
不要把完整 JSON 发到群聊、工单、截图或公开代码仓库。
不要把 token 写进提示语、脚本、日志或共享文档。
为不同客户端创建不同配置，便于单独停用。
怀疑泄露时，立即在“设置 → AI 客户端连接”中停用或删除对应配置。

停用后，该配置保留在列表中但不能继续调用；删除后，这份配置永久失效，不影响其他 MCP 配置。重新启用或新建配置后，需要将新的 JSON 重新复制到外部客户端。

常见连接问题：

客户端提示无法连接

先确认复制的是完整 JSON，服务地址没有被换行或截断，客户端支持远程 MCP / Streamable HTTP，并且网络可以访问企企智客域名。再确认对应配置没有被停用或删除。

客户端能连接，但看不到工具

重新加载 MCP 工具列表，并确认登录的企企智客账号属于正确工作空间。工具列表受当前账号权限和产品版本影响；不要把其他 MCP 服务的工具名称手动写进配置。

查询结果为空

先缩短关键词，或使用客户、联系人、商机的记录 ID 查询。确认外部客户端没有把问题改写成了另一个对象，也确认当前账号在企企智客页面中本来就能看到这条记录。

为什么有些外部 AI 请求不能修改业务数据

外部 MCP 的写入能力由当前工具策略、账号权限、字段可写性和业务治理共同决定。即使客户端支持写入，也只有工具列表中已开放的操作可以执行；不在工具列表中的操作不会因为改变提示语而获得权限。涉及真实客户数据时，建议先核对工具参数和变更结果，再决定是否继续。

定义