MCP服务（Beta）

🔔 当前 MCP 服务处于 Beta 验证阶段，功能可根据用户反馈进行动态调整，为避免业务风险，请谨慎用于核心业务。

1. 简介

1.1 功能简介

MCP（Model Context Protocol） 是指生成成员个人身份的 MCP 服务授权链接，通过链接可将简道云无缝嵌入到 AI Agent、代码编辑器、命令行工具等第三方平台中，支持通过第三方平台直接查看简道云中的待办事项、查询数据、获取用户消息等操作，进一步实现跨平台自动化与数据协同。

MCP 服务与 OpenAPI 的区别：

1）MCP 服务为个人服务权限，并且将对应接口封装成了工具类，即配置完 MCP 服务后，用户就完成了身份授权，可以直接使用对应工具。

2）MCP 封装的工具对于 AI Agent 调用的场景会比直接调用 API 更友好。

1.2 使用场景

适用于通过 AI 助手操作简道云的各类场景中。如：

快速获取简道云待办和数据：通过 MCP 服务查询当前用户待办任务及关联表单数据，辅助智能决策；
聚合个人工作信息：将待办任务、可访问应用以及成员信息集中展示在自定义面板中，实现工作状态一站式管理。

1.3 预期效果

以在 VS Code 中获取当前登录成员信息为例，效果如下所示：

1.4 使用说明

本功能为付费高级功能，需简道云企业版及以上版本可用（试用版可进行试用）。详情参见：官网定价。

2. 操作步骤

2.1 开启MCP服务

在「账户中心 >> 管理后台 >> 企业设置 >> 企业安全」处，开启 MCP 服务。

2.2 新建MCP服务

进入「开放平台 >> 开发者工具 >> MCP 服务」中，点击「创建 MCP 服务」，输入服务名称后点击「创建」，即可创建成功。

注：

1）企业管理员开启 MCP 服务后，企业成员可以使用 MCP 服务，一个企业中每个成员仅支持创建 1 个 MCP 服务。

2）MCP 查看范围与成员在简道云中的权限保持一致，企业成员仅能查看自己有权限的表单和数据。

2.3 接入VS Code

添加至 Cursor 的方法与添加至 VS Code 的方法相同，本节以添加至 VS Code 为例为大家进行讲解。

1）在 MCP 服务卡片中，点击「添加至 VS Code」，打开 VS Code 后，在 MCP 服务器页面中点击「安装」，即可安装成功。

2）安装成功后，点击「聊天」按钮打开聊天对话框，在对话框中输入需要待查询内容，即可直接查询简道云中的相关数据。

注：支持查询的内容详见【4. 支持调用的接口】。

2.4 接入其他工具

不同 AI 工具所需的使用方法不同，具体可参见对应 AI 工具的 MCP 配置说明文档。本节以接入 Opencode 为例进行讲解，具体 MCP 配置文档参见：MCP 服务器。

1）Opencode 安装完成后，在用户根目录中找到并打开名为 opencode.json 文件。

2）在简道云「MCP 服务卡片 >> 使用方式」中点击「复制 JSON」按钮，将 JSON 代码复制进 opencode.json 文件中。如下所示：

3）打开 Opencode 后，即可在对话框中直接查询简道云中的相关数据。如下所示：

3. MCP 服务管理

3.1 编辑 MCP 服务

若需对 MCP 服务名称进行修改，点击 MCP 服务卡片右上角的「编辑」按钮，即可修改。

3.2 删除 MCP 服务

若确认当前企业不再需要 MCP 服务，点击 MCP 服务卡片右上角的删除按钮，进行删除二次确认后，即可删除成功。

3.3 查看 MCP服务调用日志

管理员进入「开发者工具 >> MCP 服务」中，点击右上角的「MCP 服务调用日志」，即可查看相关日志。系统支持通过以下维度进行筛选查看：

操作人
操作类型
操作时间

4. 支持调用的工具

MCP 服务目前支持调用如下工具：

member_app_entry_list：获取应用下的表单列表(个人视角)
member_app_entry_widget_list：获取表单字段列表(个人视角)
member_app_list：获取当前成员可访问的应用列表
member_data_get：查询单条数据详情(个人视角)
member_data_list：查询多条数据(个人视角)
member_managed_data_get：查询单条数据详情（同数据管理页面）
member_managed_data_list：查询多条数据（同数据管理页面）
member_user_info：获取当前登录成员的信息
member_workflow_task_list：获取个人工作流待办列表
get_tool_schema：获取指定工具的出参 JSON Schema。用于在 agent client 丢失返回值结构缓存时按需恢复；入参 schema 已通过 tools/list 提供，此处不重复返回。
get_tool_help：获取指定工具的 Markdown 格式深度使用帮助。当前支持如下工具:

member_data_list
member_managed_data_list
member_workflow_task_list

5. 注意事项

在与 MCP 交流过程中，若遇到以下问题，可以在对话中添加一个提示词：调用简道云MCP之前，优先调用 get_tool_help 这个工具，再执行具体的业务查询（如查询待办、查询表单数据）

无法精准识别参数名；
分页标记使用错误
参数大小写无法区分；
MCP 查询分页报错；
filter 过滤问题。

6. 咨询交流

若您在使用过程中有任何疑问，欢迎进入下方「个人 MCP 用户交流群」进行交流反馈～