AI 智能助手
怎么在豆包、WorkBuddy、ChatGPT 里用连接器接入云软 ERP？
云软 ERP 内置 MCP 服务，在「外部接入」面板开通数字员工并复制服务地址与两个请求头，再到豆包、WorkBuddy、ChatGPT 里新增 MCP 连接器，就能让外部 AI 直接查单据、查报表。
适用情况
适合希望在豆包、WorkBuddy、ChatGPT 等外部 AI 工具里直接连接云软 ERP 查数据、办业务的管理员和负责人。
开始前确认
- 拥有云软 ERP 管理员账号，能进入「AI 工作台」
- ERP 已绑定可访问的域名（测试/正式地址）
- 已在外部 AI 工具里具备添加自定义 MCP 连接器的权限
分岗位怎么做
管理员
- 开通数字员工
- 复制地址与凭据
- 在外部工具配置连接器
业务/财务
- 在外部 AI 中用自然语言查单据报表
- 核对 AI 返回结果
标准处理步骤
登录云软 ERP，进入「AI 工作台 → 能力目录 → 外部接入」标签页。
点击「一键开通全部」（或单独点某岗位卡片的「开通」），为数字员工生成 App Code 和 API Key。
API Key 明文仅在开通/轮换时显示一次，请立刻复制保存；后续可用「轮换 Key」重新获取。
复制本页顶部的「MCP 服务地址」，以及对应数字员工的 App Code 与 API Key。
在豆包 / WorkBuddy / ChatGPT 里新增一个 MCP 连接器，传输方式选 Streamable HTTP。
填入服务地址，并在自定义请求头中加入 X-GERP-MCP-APP-CODE 与 X-GERP-MCP-API-KEY 两个头。
保存后点「测试连接 / 发现工具」，能列出 erp_ 开头的工具即接入成功。
涉及的单据与自查清单
这一环涉及的单据 / 台账
做完后自查
- 数字员工卡片显示「已启用」
- 服务地址以 /api/v1/mcp 结尾
- 两个请求头名称与值都已正确填写
- 测试连接成功并列出 erp_ 工具
- 已把 API Key 妥善保存，不再随意外发
使用边界
外部 AI 仅能以对应数字员工被授予的权限访问数据，看不到无权数据；写操作（审核、收付款等）仍需本人确认。请使用 HTTPS 地址，不要把 API Key 提交到公开代码库。
这类操作的常见问题
在 AI 工作台里为什么看不到 MCP 地址？
需要先进入「AI 工作台 → 能力目录 → 外部接入」标签页；若旧版本没有该页，请升级到最新版本。
API Key 没记住、页面也不显示了怎么办？
出于安全考虑明文 Key 只在开通/轮换时显示一次，可在对应数字员工卡片点「轮换 Key」获取新 Key，旧 Key 随即失效。
外部 AI 能看到我所有数据吗？
不能，外部 AI 以所选数字员工的权限访问，看不到其无权的单据和报表；不同岗位（老板/财务/销售/采购/仓库）的工具范围不同。
测试连接时报 401 或会话不存在怎么办？
先确认数字员工卡片显示「已启用」，再检查两个请求头的名称和值是否复制完整、没有多余空格；并确认使用的是 HTTPS 可访问地址。