怎样在 Codex 中添加 MCP？从一个文档连接开始
了解 Codex 的本地 MCP 配置和远程服务连接方式。以 OpenAI 官方只读文档服务为例，添加连接、检查配置，并核对是否真的可以调用。
先准备能使用的 Codex
先按官方指南安装并登录 Codex CLI。CLI 是在终端里运行的命令行工具；本文使用这一入口配置 MCP。你需要已能运行 Codex，再添加连接。这里不要求购买新的插件服务。
MCP 让 Codex 使用外部工具和资料。添加服务不是给模型重新训练，也不代表所有服务自动获得权限。
选清楚本地服务还是远程服务
本地服务由 Codex 启动一个命令，官方称为 STDIO；按项目说明准备运行环境和启动参数。远程服务提供一个地址，官方支持 Streamable HTTP；有些还需要登录或访问凭据。
Codex 默认把配置保存在 ~/.codex/config.toml；受信任项目也可以使用 .codex/config.toml。CLI 与同一 Codex 主机上的编辑器入口共享配置，不能据此假定另一台电脑或云端已经能连接。
用官方只读文档服务做例子
OpenAI 提供公开文档 MCP，读取开发文档，不替你调用 OpenAI API。它适合用来理解“添加一个远程连接”是什么。以下是官方给出的配置示例，本站没有替你执行。
- 在已安装 Codex CLI 的终端运行：codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
- 运行：codex mcp list。确认列表包含 openaiDeveloperDocs。
- 在 Codex 的终端界面输入 /mcp，检查当前会话的连接状态。再要求它从官方文档查一个问题并附上来源。
配置已保存，不等于连接已成功
列表里出现服务名称，只说明配置存在。还要检查它是否启动或连接、是否需要授权，以及实际调用有没有返回资料。需要 OAuth 登录的服务，可以按官方指引运行 codex mcp login 服务名；不是每个服务都需要这个步骤。
- 本地服务失败：核对项目需要的运行环境、可执行命令和参数。
- 远程服务失败：核对服务地址、当前网络和服务要求的授权。
- 修改配置后按所用客户端的说明重启或重新连接，再检查实际调用。
下一步按任务添加一个工具
读文档、查项目资料和操作浏览器需要不同的工具。选一个与你当前任务有关的服务，阅读来源、权限和设置说明，再开始一个可核对的小任务。密钥或登录凭据按客户端的本地配置方式保存，不写入公开仓库。
来源核对日期：2026-10-12。这里是官方配置的入门解释，未执行安装、登录、连通性或兼容性实测；具体操作以当前客户端与服务文档为准。