Codex对接简道云指南
1. 工具与适用范围
Codex 是能够理解任务、使用工具并执行操作的 AI Agent。连接简道云后,用户可以直接通过对话查询简道云数据,也可以安装简道云 API Skill,完成更多业务操作。
连接方式 | 简道云能力 | 适合的任务 |
MCP | 查询简道云应用、表单和数据,以及向已授权的表单新增数据 | 查询数据、筛选记录、整理清单或新增一条表单数据 |
API Skill | 通过简道云 API 查询、新增、修改或删除数据,并根据接口能力处理流程等任务 | 需要修改已有记录、提交或处理流程,以及使用更多 API 能力的任务 |
2. MCP 对接
2.1 创建简道云 AI 连接
1)登录简道云工作台,点击左上角九宫格选择「开放平台」。

2)在「AI 连接 >> AI 连接」处,点击「新建 AI 连接」。

3)在配置 AI 连接弹窗中填写 AI 连接名称、授权有效期和可用能力,其中新增数据能力需审核。

2.2 连接 Codex
1)创建完成后,在「使用方式 >> MCP」中点击「Codex」。

2)打开 Codex 客户端后,系统将自动填充提示词与 JSON,点击发送后等待连接完成即可。

2.3 测试连通性
在「新对话」中,可通过查询简道云应用来验证连接是否生效。
- 若正常返回应用名称、应用数量,代表 MCP 对接全部完成,可以正常使用简道云数据能力;
- 若返回报错或无数据,则可排查简道云账号权限是否正常、AI 连接能力是否可用。
提示词如下:
请查询我当前可以访问的简道云应用,并告诉我一共有多少个
3. API 对接
Codex 同样支持通过 API Skill 模式对接简道云。用户无需安装对应组件,直接将简道云 API Key 和 API Skill 文件传入对话对话框,即可完成简道云 API 能力的接入调用。
3.1 创建简道云 API Key
1)登录简道云工作台,点击左上角九宫格选择「开放平台」。

2)在「API Key」中点击「创建 API Key」,输入名称并设置好应用/接口授权范围后,点击「创建 API Key」完成创建。

3)点击复制按钮,复制并保存刚刚创建好的 API Key。

3.2 安装简道云 API
安装简道云 API,需先下载右侧简道云API技能包:jiandaoyun-api-skill-compatible.zip
1)打开 Codex 客户端,在「新工作任务」中点击「+」号按钮,选择「上传文件或图片」,上传下载好的简道云 API 技能包附件。

2)附件上传成功后,将【3.1 创建简道云 API Key】中获取到的 API Key 粘贴进去,即可连接成功。提示词如下所示:
API Key:xxxxxxxx,请帮我连接简道云
3.3 测试连通性
连接成功后,通过查询简道云应用来验证连接是否生效。
- 若正常返回应用名称、应用数量,代表 MCP 对接全部完成,可以正常使用简道云数据能力;
- 若返回报错或无数据,则可排查简道云账号权限是否正常、AI 连接能力是否可用。
提示词如下:
请使用简道云连接器,查询我当前可以访问的应用,并告诉我一共有多少个。

400-111-0890
在线咨询