织信企业级AI开发平台文档

Appearance

Codex 对接织信 MCP ​

概述 ​

织信提供内置的 MCP Server。将织信 MCP 配置到 Codex 后，可以在对话中查询应用、创建数据表、配置工作流和仪表盘、编写脚本、创建定时任务，以及校验和发布应用。

本文介绍 Codex 对接织信 MCP 的配置方法，并以创建项目管理系统为例说明推荐的操作流程。

准备工作 ​

配置前需要准备：

  • 织信服务地址，例如 https://next.informat.cn
  • 织信用户 API Key
  • 已安装并可正常使用的 Codex

织信用户 API Key 可在以下地址获取：

text
https://{织信服务地址}/workbench/account/apikey

安全提示

API Key 代表当前用户身份，请勿提交到 Git 仓库、粘贴到公开文档或发送给无关人员。示例中的 <X-INFORMAT-USER-APIKEY> 必须替换为自己的 API Key。

在 Codex 中配置织信 MCP ​

第一步：打开 Codex MCP 配置 ​

在 Codex 设置中找到 MCP Server 配置。如果需要让配置对所有项目生效，请修改全局 Codex 配置；如果只希望当前项目使用，请使用项目级配置。

第二步：添加织信 MCP Server ​

添加以下配置：

json
{
    "mcpServers": {
        "informat_mcp": {
            "url": "{织信服务地址}/web0/mcp/event",
            "headers": {
                "X-INFORMAT-USER-AKEY": "<X-INFORMAT-USER-APIKEY>"
            },
            "disabled": false
        }
    }
}

配置说明

  • informat_mcp：MCP Server 名称，可以自定义，建议保持此名称以便识别。
  • url：织信 MCP Server 地址，例如 https://next.informat.cn/web0/mcp/event。
  • X-INFORMAT-USER-AKEY：织信用户 API Key。
  • disabled：是否禁用此 MCP Server，设置为 false 表示启用。

第三步：重新加载 Codex ​

保存配置后，重新启动 Codex 或新建一个任务，使 MCP 工具完成加载。

注意

在已经打开的 Codex 任务中新增 MCP 配置后，工具列表可能不会立即刷新。遇到这种情况时，应重新启动 Codex 或新建任务，不要把“当前任务中工具不可见”误判为织信 MCP 服务不可用。

第四步：验证连接 ​

可以在 Codex 中输入：

text
通过 informat_mcp 查询我的织信应用列表。

如果 Codex 能返回当前账号可访问的应用列表，说明连接成功。

使用 Codex 创建织信应用 ​

建议先让 Codex输出应用蓝图，确认后再创建，避免产生重复应用或不符合预期的数据结构。

示例提示词：

text
通过 informat_mcp 创建一个全新的项目管理系统。

要求：
1. 应用名称为“项目管理系统”。
2. 包含项目、任务、里程碑、风险、工时、项目成员六张表。
3. 创建项目立项审批流程。
4. 创建项目管理驾驶舱。
5. 创建逾期任务提醒脚本和每天执行的定时任务。
6. 创建前先输出应用蓝图，得到确认后再执行。
7. 完成后先校验，不要自动发布。

推荐创建顺序 ​

创建完整应用时，建议按照以下顺序执行：

  1. 查询已有应用，避免误修改或重复使用同名应用。
  2. 创建应用并保存返回的真实应用 ID。
  3. 查询应用设计端定义和已有数据表。
  4. 创建主表。
  5. 回查主表结构，获取真实表 ID 和字段 ID。
  6. 依次创建子表及 RelationRecord 外键字段。
  7. 回查子表结构，再为主表创建 LookupList 等关联字段。
  8. 创建工作流模块、流程定义、节点和流转线。
  9. 创建仪表盘模块并逐张创建卡片。
  10. 阅读织信脚本 SDK 文档后创建脚本。
  11. 使用脚本真实 ID 创建定时任务。
  12. 调用发布前校验工具检查草稿配置。
  13. 用户明确确认后发布应用。

为什么要反复回查结构

织信 MCP 的创建接口会返回真实对象 ID。后续关联、工作流、仪表盘和自动化配置必须使用平台返回的真实 ID，不能根据名称自行推测。

工作流创建注意事项 ​

创建工作流时，应先创建工作流模块和流程定义，再查询流程定义以获得系统生成的开始节点 ID。

建议遵循以下规则：

  • 启动表单和所有用户任务节点必须绑定同一张业务表。
  • 审批人、实例名称、流转条件等表达式应先阅读织信表达式文档。
  • 必须保证开始节点至少有一条流转线。
  • 驳回操作可使用跳转按钮返回“发起人修改”节点。
  • 创建节点和流转线后，应重新查询流程定义，检查节点与拓扑是否完整。

仪表盘创建注意事项 ​

创建仪表盘卡片前，应先查询数据表结构，并读取织信仪表盘 UI 预设。

  • 同一仪表盘使用统一主题。
  • 仪表盘采用 24 列网格，每行卡片宽度之和应为 24。
  • Number 卡片必须绑定真实数据表和业务字段。
  • ProChart 必须配置非空的真实数据源和图表系列。
  • 聚合计数的输出字段使用平台规定的 count。
  • Record 卡片的列 ID 必须来自真实表字段。

脚本与定时任务 ​

保存织信脚本前，必须先读取脚本 SDK 以及脚本中实际使用模块的文档，例如：

  • script/table.md
  • script/notification.md
  • script/date.md

可被定时任务、自动化或 API 调用的方法必须使用 ES Module 语法显式导出：

javascript
export function checkOverdueTasks() {
    // 业务逻辑
}

脚本语法边界

织信脚本是 JavaScript，不是织信表达式。脚本调用平台能力时使用 informat.table.*、informat.notification.* 等 SDK；不要把 ${...} 表达式语法直接复制到 .js 脚本中。

创建定时任务时，scriptId 必须来自脚本列表查询结果，scriptFunc 必须是脚本中真实导出的方法名。

校验与发布 ​

应用创建完成后，先执行发布前校验：

text
通过 informat_mcp 对当前应用执行发布前配置校验，不要发布。

校验结果为空列表 [] 表示未发现配置错误。

发布属于正式环境写操作，会立即对真实用户生效。只有用户明确确认发布后，Codex 才应执行发布。发布前还应查询应用历史发布次数，并按 MCP 工具要求传递确认参数。

获取正确的应用访问地址 ​

MCP 的应用 Web 根地址工具返回的是织信站点根地址，例如：

text
https://next.informat.cn/

它不是某个应用的完整访问地址。应用专属地址格式为：

text
https://{织信服务地址}/app/{appId}

例如应用 ID 为 jvz0rcb9hx1ji，则访问地址为：

text
https://next.informat.cn/app/jvz0rcb9hx1ji

设计器地址格式为：

text
https://{织信服务地址}/designer/{appId}/setting/info

常见问题 ​

MCP 配置后工具不可见 ​

保存配置后重新启动 Codex或新建任务。MCP 工具通常在任务初始化时加载。

返回 401 或无权限 ​

检查 X-INFORMAT-USER-AKEY 是否正确、是否已失效，以及当前用户是否拥有目标应用的访问或设计权限。

创建关联字段失败 ​

先查询目标表和字段结构，确认 tableId、nameFieldId 和外键字段 ID 均为平台返回的真实值。

脚本可以保存但定时任务无法调用 ​

检查函数是否使用 export function 显式导出，并确认定时任务绑定的是脚本列表返回的真实 scriptId。

发布后访问地址不正确 ​

不要直接使用 MCP 返回的站点根地址。应按 /app/{appId} 拼接应用专属地址。

是否可以在脚本创建后立即试跑 ​

需要谨慎。发送通知、修改记录或调用外部接口的脚本会产生真实副作用。可以先进行发布前配置校验；如果必须试跑，应明确说明影响并获得确认。