06 成员数据对接:个人与团队MCP配置
读完这篇,你能让悟帆直接连上你的简道云——查数据、写数据、读表单结构。个人用个人的权限,管理员不用操心每个人看得到什么。
1. 简道云 MCP 是什么,跟 API 有什么区别
很多人搞混这两个东西。一句话说清楚:
简道云 API | 简道云 MCP | |
权限范围 | 企业级——拥有 API 节点的全量权限,能访问所有表单和数据 | 个人级——等同于你本人在简道云里的权限 |
谁能用 | 团队管理员、IT 人员 | 每个企业员工都可以 |
典型场景 | 管理员统一对接系统,做全局数据同步 | 每个员工让悟帆用自己的身份查数据、写数据 |
安全性 | 一个 Key 管全部,泄露影响大 | 每人一个 KEY,权限自然隔离 |
简单说:API 是万能钥匙,管理员拿着。MCP 是个人门禁卡,每个员工自己刷自己的,能看到什么取决于你在简道云里本身有什么权限。
所以团队场景下,推荐用 MCP。 张经理的悟帆查到的数据就是他能在简道云里看到的数据,李专员查到的就是李专员能看到的数据——权限自动隔离,不用管理员额外配置。
2. 如何获得自己的 MCP 地址和 KEY
2.1 前提条件
- 简道云企业版及以上。如果不是企业版,联系管理员升级。
- 管理员已开放 MCP 功能。如果还没开放,让你的简道云管理员去后台开启。
2.2 操作步骤
- 登录简道云。
- 左上角切换到「开放平台」。
- 找到「MCP」入口,进入。
- 启用你自己的 MCP 服务。系统会生成一个属于你的 MCP 地址和 KEY。
- 复制 MCP 地址(类似 https://mcp.jiandaoyun.com/mcp/... 的长链接)和 KEY,保存好。
2.3 注意:授权需要手动续期
MCP KEY 的有效期是 1 个月。到期前需要回到简道云 MCP 页面手动续期。如果忘了续,悟帆连不上简道云了——到时候回来续一下就行,不影响已配置好的连接。
3. 在悟帆中启动简道云 MCP
三种方式,按你的情况选一种。
3.0 从探索市场一键安装(推荐)
最简单的方式——直接在悟帆的探索市场里安装简道云 MCP 服务,不需要手写任何配置。
点击「安装」按钮,悟帆会自动完成 MCP 服务的配置。安装后,在悟帆对话里输入:
"帮我测试简道云 MCP 服务。"
悟帆会弹出卡片让你填入 MCP KEY。把你在步骤 2 里拿到的 KEY 填进去,完成。
如果你是团队管理员,安装时选择安装到团队空间,这样全团队都能用。团队成员之后各自在「连接中心」填自己的 KEY 即可。
3.1 如果你是团队管理员:手动配置 MCP 服务
团队管理员负责把 MCP 服务"修好路",让团队成员都能用。在悟帆对话里输入:
你:"帮我配置简道云 MCP 服务。使用以下配置,把 mcp/ 后面的 token 替换成简道云 MCP 连接凭证(让每个成员填自己的 KEY):
代码块
{
"mcpServers": {
"fine-open-mcp": {
"url": "https://mcp.jiandaoyun.com/mcp/m-Gdluempc1mij18RrFNtKELkeI9Avn3nt2859198D09b6e645f288612C80939391"
}
}
}
悟帆会完成配置,并弹出连接凭证的配置卡。管理员先把自己的 MCP KEY 填进去,你的悟帆就能立刻用了。
团队成员之后会各自在自己的「连接中心」填自己的 KEY。
3.2 如果你是团队成员:管理员已经配好了
如果你们团队的管理员已经按 3.1 配好了 MCP 服务,你只需要做一件事。
在悟帆对话里输入:
"帮我测试简道云 MCP 服务。"
悟帆会弹出一张卡片,让你输入你的 MCP KEY。把你在步骤 2 里拿到的 KEY 填进去,配置完成。
以后你对悟帆说"查一下客户订单表",悟帆就会用你的身份和权限去简道云里查数据。
4. 配置完成后,你能做什么
简道云 MCP 提供个人视角的只读能力——查询和浏览数据,不做写入。
你想做的事 | 对悟帆这样说 |
看看有哪些应用 | "看看我有哪些简道云应用" |
查看应用里的表单 | "客户管理应用里有哪些表单" |
查看表单字段 | "客户订单表有哪些字段" |
查单条数据详情 | "帮我查一下订单 ORD-001 的完整信息" |
按条件筛选数据 | "查一下张三最近一周的所有订单" |
查看工作流待办 | "我有哪些待审批的任务" |
查看个人信息 | "我的简道云账号信息是什么" |
注意:MCP 不支持新增、修改、删除数据。如果你需要对简道云做写入操作(比如自动建工单、自动写整改任务),需要用简道云的 API 工具——这个在 03-场景实战 里已经用到了,对悟帆说"帮我在 xxx 表新增一条记录",悟帆会自动走 API 写入。
5. 常见问题
Q: MCP KEY 过期了怎么办?
回简道云 MCP 页面手动续期,然后在悟帆「连接中心」里更新你的 KEY 就行。
Q: 我填了 KEY 之后,能看到同事的数据吗?
看不到。你的 MCP KEY 等于你在简道云里的身份。你在简道云里能看到什么数据,悟帆就能查到什么。看不到的,悟帆也查不到。
Q: 我是管理员,需要帮每个同事拿 KEY 吗?
不需要。你只管把 MCP 服务配好(3.1),同事自己去简道云拿自己的 KEY,自己在悟帆连接中心里填(3.2)。各管各的。

400-111-0890
在线咨询