OpenAI Docs MCP 用 openaiDeveloperDocs，不要当成桌面 WebMCP

OpenAI 给开发者文档单独托管了一台公共 MCP，覆盖 developers.openai.com、platform.openai.com、learn.chatgpt.com。官方服务器名就是驼峰 openaiDeveloperDocs，不要改成带连字符的名字：

codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"
enabled = true

这是只读文档检索，不会用你的账号去调 OpenAI API。官方没要求 mcp login；也不要给它套 auth = "chatgpt"——那条只给受信任的 ChatGPT 同源服务器。

想让它在没被点名时也去查文档，可在 AGENTS.md 加一句官方建议的话，例如「涉及 OpenAI API、插件、ChatGPT、Codex 时，先用 OpenAI developer documentation MCP」。这是可选提醒，不是静默唯一路径。没写这句时，提示里要点名这台服务器。

这不是桌面内置浏览器里文档页的 Site tools。那边的 search_openai_docs / lookup_page 跟当前页面走，关标签就没了，也不写进 config.toml。两套都不要 required = true。

技能 agents/openai.yaml 里声明 MCP 依赖时，value 也用这个官方名，见技能依赖那条。也可以再配 OpenAI Docs Skill，让模型先走这台 MCP，再回落官方域名。

不要做这些：

• 不要抄 Claude 的 claude mcp add --transport http openaiDeveloperDocs …。Codex 远程用 --url，名字写在 add 后面。
• 不要把它和桌面 WebMCP 配成一台，也不要指望 iframe 里的站点工具出现在 codex mcp list。
• 不要给它 required = true 挂全局。查文档不是每条会话的硬依赖。
• 不要把工具名写成双下划线那种内部拼接。在会话里点名服务器名 openaiDeveloperDocs 即可。
• 不要抄 Cursor / VS Code 的 mcpServers JSON 进 Codex TOML。

网页 Cloud 不读这份 config.toml。改完新开会话。用 codex mcp get openaiDeveloperDocs 核对传输是 streamable_http。