Codex MCP：连接工具并确认访问范围

中文实战指南 · 核验于 2026-11-14

当任务需要外部系统中的工具或信息时，可以通过 MCP 为 Codex 连接对应服务。先确定要连接什么，再按服务提供的方式配置本地进程或远程地址。

这份指南介绍 CLI 中的连接管理，以及如何检查工具是否出现、当前账号能否访问需要的内容。

先确定要连接的服务

准备服务的官方启动命令或地址、认证方式、所需环境变量，以及允许读取和修改的范围。不要把网上未知启动命令直接当成可信依赖运行。

本地 STDIO 服务由命令启动；远程 Streamable HTTP 服务通过地址访问。它们的进程环境、认证和故障来源不同，配置前先确认类型。

在 CLI 中管理连接

下面是官方命令形式，尖括号部分应替换成实际已确认的服务参数：

codex mcp add <server-name> -- <stdio server-command>
codex mcp list
codex mcp --help

支持 OAuth 的服务可以通过 codex mcp login <server-name> 登录；不是所有服务都用 OAuth，也不是所有工具都要求同一种权限。细粒度配置位于 config.toml 的 [mcp_servers.<server-name>] 表中。

验证三个层次

1. 检查服务是否初始化、是否出现预期工具名称。
2. 选择一条允许的只读操作，查询自己有权访问的具体记录。
3. 核对返回的业务内容、记录身份和权限边界；记录不存在与连接失败应分开处理。

工具缺失时，检查服务启动日志、客户端配置、认证及启用列表。给出失败工具和错误摘要，避免把凭据带进日志或反馈。

已移除的旧入口

codex mcp-server 及对应 binary 已从当前 Codex 中移除。Codex 连接外部 MCP 的能力仍在；不要把它与“将 Codex 自身当作 MCP server”混淆。App server 使用自己的协议，也不能当作相同替代品。

重复工具工作流可以整理为 Skill；配置未生效时回到 配置优先级。