在 Codex 中接入 OpenAI Developer Docs MCP
OpenAI 提供了公开的文档 MCP，覆盖 developers.openai.com、platform.openai.com 和 learn.chatgpt.com。它只负责搜索和读取文档，不会替我调用 OpenAI API。
添加到 Codex
用 CLI 添加：
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list也可以直接写入用户级 ~/.codex/config.toml：
[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"配置修改后要新开任务。在 Codex 交互界面输入 /mcp，确认当前会话确实加载了 openaiDeveloperDocs。
什么时候使用
我主要用它核对这些会变化的内容：
- Codex 配置项、命令和 MCP 接入方式；
- OpenAI API 请求结构；
- Responses、Realtime 和工具调用；
- 模型能力与迁移说明。
查询应尽量具体，例如“查 Codex 自定义 model provider 的 env_key 和 wire_api”，不要一次取回整套 Codex 文档。范围越宽，返回内容越多，后续对话携带的上下文成本也越高。
验证边界
文档 MCP 能确认官方文档当前写了什么，但不能证明本机版本已经支持，也不能证明项目配置已经生效。完成查询后，我仍会运行本机 --help、静态检查或最小命令验证。
仓库里的配置、错误日志和实际命令输出是本地事实。官方文档与本地行为不一致时，应先记录版本，再判断是文档更新、客户端版本差异还是配置没有重载。