---
title: "OpenAI Docs MCP 用 openaiDeveloperDocs，不要当成桌面 WebMCP"
summary: "CLI：codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp。覆盖 developers、platform、learn。这是只读文档检索，不会代你调 API。桌面浏览器里的 search_openai_docs 是另一套 WebMCP。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "文档", "HTTP", "AGENTS.md"]
canonical: /tips/mcp-openai-docs/
---

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

CLI：codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp。覆盖 developers、platform、learn。这是只读文档检索，不会代你调 API。桌面浏览器里的 search_openai_docs 是另一套 WebMCP。

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

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

```toml
[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。

## 来源

- [OpenAI · Docs MCP](https://developers.openai.com/learn/docs-mcp)
- [OpenAI · Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp)