简道云×AI：连接与应用

1. 功能简介

随着 AI 逐渐进入企业的日常工作，用户对 AI 的期待也从回答问题、生成内容，进一步延伸到使用企业自己的业务数据完成任务。

客户订单、生产进度、售后记录和审批流程等数据持续沉淀在简道云中，但 AI 在没有连接的情况下，并不了解这些数据，也无法直接调用简道云的功能。通过 API、MCP 等连接方式，可以在身份和权限明确的前提下，将简道云已经开放的数据与能力提供给外部系统或 AI 使用。

连接简道云后，用户不必每次都先导出 Excel，再将文件上传给 AI。当业务数据发生变化时，外部系统或 AI 可以在授权范围内重新获取最新数据。

例如，用户可以让 AI 查询个人待办、筛选未完成订单、整理客户跟进情况，或者分析生产进度中的异常记录；企业也可以开发自己的 AI 应用，通过程序读取简道云数据，再生成业务报告或处理建议。

注：连接并不意味着 AI 自动获得全部简道云数据。AI 能够使用哪些数据和功能，取决于连接方式、授权身份以及简道云当前开放的接口或工具。

2. 简道云 API

API（Application Programming Interface，应用程序编程接口）是不同系统之间按照约定规则调用数据和功能的一种方式。

简道云 API 主要面向具备开发能力的企业。开发人员可以按照接口文档编写程序，将简道云与 ERP、WMS、CRM、企业自建系统或自建 AI 应用连接起来。

如：企业可以开发一个订单分析助手。程序先通过简道云 API 查询当天的订单数据，再将订单金额、交付时间和完成状态交给 AI 分析，最终生成订单摘要和异常清单。

在这个过程中，API 负责调用简道云的数据和功能，企业程序负责控制调用顺序与处理逻辑，AI 负责理解数据、分析问题并生成内容。

API 本身不会直接理解用户的自然语言。企业需要通过程序或自建 Agent，将用户提出的任务转换成具体的接口调用。

当简道云将 API 调用封装为可安装的 Skill 后，业务用户无需自己编写程序，只需要安装 Skill，并在配置页面填写 API Key 等必要信息。具体安装方式可查看对应的 AI 对接指南。

2.1 简道云 API 支持的能力

根据当前开放的接口，简道云 API 可以用于调用以下能力：

应用与表单：查询用户有权访问的应用、表单及字段信息。
表单数据：查询、新增、修改或删除表单数据，并根据具体接口处理单条或多条记录。
文件：处理接口调用过程中涉及的文件。
流程：查询流程实例、审批意见、流程日志和个人待办，并根据具体接口处理流程任务。
通讯录：获取或管理企业成员、部门、角色等组织信息。
资源与审计：根据已开放接口查询资源用量或审计日志等信息。

调用 API 时，需要通过 API Key 验证身份，并为 API Key 配置相应的应用和接口权限。程序最终能够调用哪些数据和功能，取决于 API Key 的授权范围以及具体接口的使用要求。

查看简道云 API 文档 ↗

3. 简道云 MCP

MCP（Model Context Protocol，模型上下文协议）是一种便于 AI 发现和调用外部工具的连接方式。

简道云 MCP 将个人权限范围内的常用简道云能力封装成 AI 可以识别的工具。完成连接和授权后，用户可以直接描述自己想完成的任务，由 AI 理解任务并判断需要调用哪些简道云工具。

如：用户可以向 AI 提出：“帮我查询上个月还没有完成的订单，并按照负责人整理。”AI 理解任务后，可以通过 MCP 查找相关应用、表单和字段，查询符合条件的订单数据，再将结果整理为跟进清单。

如果任务涉及多张表单，AI 也可以分别查询相关数据，再根据表单中已有的订单编号、合同编号或客户编号进行整理。不同表单之间需要具有可以相互对应的业务字段，AI 才能准确关联相关记录。

3.1 简道云 MCP 支持的能力

根据当前简道云 MCP 服务文档，AI 可以通过 MCP：

获取当前成员可访问的应用、表单及字段。
查询单条或多条表单数据。
查询数据管理页面范围内的数据。
获取当前成员信息。
获取当前成员的个人工作流待办。
向指定表单新增一条数据。

个人 MCP 代表当前简道云成员的身份，能够访问的数据不会超过该成员原本在简道云中的权限范围。企业成员仅能查询和操作自己有权限的表单与数据。

其中，“新增数据”需要企业管理员审核通过后才能使用。通过 MCP 新增数据与用户在网页端填写表单并不完全相同，部分字段、数据联动、公式计算、前端事件和数据校验等能力存在使用限制。涉及复杂写入时，应先确认当前 MCP 支持范围。

能力分工：MCP 负责查找和返回简道云数据，理解用户任务、筛选记录和生成报告等工作由 AI 完成。

查看简道云 MCP 服务文档 ↗

4. AI Agent

AI Agent 可以理解为能够围绕目标调用工具并完成任务的 AI 助手。

在未连接外部工具时，AI 通常只能根据当前对话中获得的内容生成回答。具备 Agent 能力后，AI 还可以围绕目标选择和调用工具、读取工具返回的结果，并根据执行情况继续完成任务。

4.1 Agent 在连接中的作用

例如，当用户提出“查询本月未完成的订单，并列出需要优先跟进的负责人”时，Agent 会先理解查询范围，再通过已经连接的简道云能力获取相关数据，最后按照负责人、订单状态和交付时间整理跟进清单。

在这个过程中，业务数据来自简道云，API 或 MCP 提供调用简道云能力的通道，Agent 负责理解任务、调用工具并整理结果。

Agent 本身不会自动拥有企业数据。只有完成连接和授权，并且所使用的产品支持相应的连接方式后，Agent 才能调用简道云已经开放的能力。

4.2 可用于连接简道云的 AI 产品与开发工具

目前对接指南优先介绍悟帆，并覆盖 WorkBuddy、Codex、Claude Code 和千问办公。使用其他支持 MCP 的产品时，可参考其他 Agent 通用配置。

这些产品在办公协作、代码开发和任务执行方面的定位并不完全相同，因此本文不将它们统一定义为 Agent，而是统称为“可用于连接简道云的 AI 产品与开发工具”。不同产品支持的连接方式可能不同，具体配置方法将在对应的对接指南中单独介绍。

5. API 与 MCP 的区别

API 和 MCP 都可以用于调用简道云能力，但二者面向的使用者、调用方式和能力范围并不相同。

对比项	简道云 API	简道云 MCP
主要使用者	开发人员、企业技术团队；或使用封装 Skill 的业务人员	希望通过 AI 完成任务的业务人员或开发人员
调用方式	由程序按照接口文档发起调用	由 Agent 根据用户任务选择并调用工具
身份与权限	根据 API Key 的授权范围确定	根据当前简道云成员的个人权限确定
能力范围	覆盖应用、表单数据、文件、流程、通讯录等多类接口	主要覆盖应用和表单查询、数据查询、个人待办、成员信息及单条数据新增
典型场景	系统对接、数据同步、自建应用、自动化程序	AI 查询数据、整理信息、生成报告和辅助录入
使用特点	调用过程和业务逻辑由程序精确控制	用户可以通过自然语言描述任务，由 Agent 组织调用过程

API 更强调由程序控制调用过程，适合稳定、重复、规则明确的系统集成；MCP 更强调由 Agent 根据用户任务选择工具，适合通过自然语言完成查询、整理和辅助录入。

二者并不是互相替代的关系，也可以在同一个业务中组合使用。例如，开发团队可以通过 API 将 ERP 中的订单同步到简道云，再由业务人员通过 MCP，让 Agent 查询和分析这些订单。

6. 了解连接方式与业务场景

本文主要介绍简道云连接 AI 时涉及的基本概念、产品能力和方式差异，不展开具体的配置步骤。

如果已经确定需要使用的 AI 产品，可以进入 AI 对接指南，查看悟帆、WorkBuddy、Codex、Claude Code、千问办公及其他 Agent 的连接说明。如果还不确定连接后可以完成什么任务，可以进入 业务场景，查看简道云数据与 AI 结合后的应用案例。