结论先说:在终端执行 codex mcp add opencpai --url https://api.opencpai.com/mcp 添加服务,再执行 codex mcp login opencpai 在浏览器里登录授权,Codex 就能调用审计 MCP 的全部工具。整个过程不需要填写任何密钥,浏览器和 Codex 必须在同一台电脑上。
Codex 接入审计 MCP 需要什么?
| 条件 | 说明 |
|---|---|
| Codex 版本 | 支持远程 MCP 服务与 codex mcp login 的版本;命令报"不认识的参数"时先升级 |
| 审小匠账号 | 没有账号可以在授权页上直接注册 |
| 同一台电脑 | 授权完成后浏览器会跳回本机地址,把令牌交给 Codex |
| 网络 | 能访问 https://api.opencpai.com |
审计 MCP 是指审小匠提供的标准 MCP 接口,Codex 作为客户端调用它的工具,完整介绍见审计 MCP 完全指南。
怎么连接?
在终端(PowerShell、Terminal 均可)依次执行:
codex mcp add opencpai --url https://api.opencpai.com/mcp
codex mcp login opencpai
第一条命令把服务登记为 opencpai,名字可以自己取。第二条命令会自动打开浏览器:
- 登录审小匠账号;
- 授权页列出客户端名称和申请的权限:只读(查看账号、任务进度与产物清单)和读写(代你上传资料并启动审计任务,会消耗额度);
- 点"允许",浏览器提示授权完成后回到终端。
授权页上的客户端名称由客户端自己填写,审小匠未做核实,只在你自己刚刚发起连接时点"允许"。
怎么确认连上了?
新开一个 Codex 对话,发送:
用审小匠 MCP 查一下我的账号信息。
Codex 会调用 whoami,返回套餐、剩余额度、单次上传上限、允许的文件类型和可用的服务模式。能看到这些就说明连接与授权都正常。有多个工作空间时,返回结果里会列出组织,后续指令里说明用哪一个即可。
第一条实际指令怎么写?
把文件路径换成自己电脑上的实际路径:
使用审小匠 MCP 清洗这份科目余额表:"D:\资料\2025 科目余额表。xlsx"。我同意把这份文件上传到审小匠云端处理。完成后下载结果到同一目录,并告诉我清洗出的行数和所有提示。
Codex 会依次申请上传地址、用 PUT 直传文件、调用清洗工具、查询作业、下载产物。想直接编制现金流量表,可以参考用 Codex 编制现金流量表。
| 你说的话 | Codex 调用的工具 |
|---|---|
| 查我的额度 | whoami |
| 清洗余额表 / 序时账 | create_upload_session → clean_balance_sheet / clean_journal |
| 编制现金流量表 | generate_cashflow |
| 生成财审底稿 | confirm_uploads → start_audit(两步确认) |
| 任务到哪一步了 | get_task_status / get_tool_status |
常见报错怎么处理?
| 现象 | 原因 | 处理 |
|---|---|---|
codex mcp login 后浏览器没跳回 |
浏览器与 Codex 不在同一台电脑,或本机防火墙拦截回调 | 在运行 Codex 的电脑上完成授权 |
| 提示授权失效 | 超过 60 天,或在官网改过密码 | 重新执行 codex mcp login opencpai |
| 提示需要读写权限 | 授权时只给了只读 | 重新登录并授予读写权限 |
| 上传返回 403 | PUT 没带 Content-Type: application/octet-stream 或地址过期 |
让 Codex 重新申请上传地址并带上该请求头 |
| 提示已有作业在处理 | 快速工具每个账号同时最多 3 个作业 | 等已有作业完成 |
| 下载链接打不开 | 链接 10 分钟有效 | 让 Codex 重新获取 |
怎么断开?
执行 codex mcp remove opencpai 删除这个服务。如果担心令牌泄露,在官网修改密码,所有 AI 助手上的授权会同时失效。
下一步
想了解全部 20 个工具、数据流向和额度规则,见审计 MCP 完全指南;关心资料安全的,见让 AI 助手处理审计资料安全吗。