---
title: Codex 怎么接入审计 MCP：两条命令完成连接与浏览器授权
summary: 在 Codex 命令行或 IDE 插件里接入审计 MCP 只需两条命令：codex mcp add 添加服务地址，codex mcp login 打开浏览器授权。本文给出步骤、验证方法、第一条指令示例和常见报错处理。
category: 产品动态
published: 2026-10-13T18:45:04.484768
source: https://www.opencpai.com/blog/codex-audit-mcp-setup/
---

# Codex 怎么接入审计 MCP：两条命令完成连接与浏览器授权

结论先说：在终端执行 `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 完全指南](/blog/audit-mcp-complete-guide/)。

## 怎么连接？

在终端（PowerShell、Terminal 均可）依次执行：

```bash
codex mcp add opencpai --url https://api.opencpai.com/mcp
codex mcp login opencpai
```

第一条命令把服务登记为 `opencpai`，名字可以自己取。第二条命令会自动打开浏览器：

1. 登录审小匠账号；
2. 授权页列出客户端名称和申请的权限：只读（查看账号、任务进度与产物清单）和读写（代你上传资料并启动审计任务，会消耗额度）；
3. 点"允许"，浏览器提示授权完成后回到终端。

授权页上的客户端名称由客户端自己填写，审小匠未做核实，只在你自己刚刚发起连接时点"允许"。

## 怎么确认连上了？

新开一个 Codex 对话，发送：

> 用审小匠 MCP 查一下我的账号信息。

Codex 会调用 `whoami`，返回套餐、剩余额度、单次上传上限、允许的文件类型和可用的服务模式。能看到这些就说明连接与授权都正常。有多个工作空间时，返回结果里会列出组织，后续指令里说明用哪一个即可。

## 第一条实际指令怎么写？

把文件路径换成自己电脑上的实际路径：

> 使用审小匠 MCP 清洗这份科目余额表："D:\资料\2025 科目余额表。xlsx"。我同意把这份文件上传到审小匠云端处理。完成后下载结果到同一目录，并告诉我清洗出的行数和所有提示。

Codex 会依次申请上传地址、用 PUT 直传文件、调用清洗工具、查询作业、下载产物。想直接编制现金流量表，可以参考[用 Codex 编制现金流量表](/blog/codex-mcp-cash-flow-statement-steps/)。

| 你说的话 | 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 完全指南](/blog/audit-mcp-complete-guide/)；关心资料安全的，见[让 AI 助手处理审计资料安全吗](/blog/ai-assistant-audit-data-security/)。