OpenAI 为 developers.openai.com 和 platform.openai.com 上的开发者文档托管了一个公共模型上下文协议 (MCP) 服务器。
服务器 URL (可流式传输 HTTP): https://developers.openai.ac.cn/mcp
功能简介
- 对 文档的只读访问(搜索 + 页面内容)。
- 一种在工作时将文档引入代理(Agent)上下文的方法。
此 MCP 服务器仅用于文档查阅。它不会代表您调用 OpenAI API。
快速入门
您可以将 Codex 连接到 CLI 或 IDE 扩展中的 MCP 服务器。配置在两者之间共享,因此您只需设置一次。
使用 Codex CLI 添加服务器
codex mcp add openaiDeveloperDocs --url https://developers.openai.ac.cn/mcp验证配置是否成功
codex mcp list或者,您可以直接在 ~/.codex/config.toml 中添加
[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.ac.cn/mcp"为了让 Codex 稳定地使用该 MCP 服务器,请将此代码片段添加到您的 AGENTS.md 中
Always use the OpenAI developer documentation MCP server if you need to work with the OpenAI API, ChatGPT Apps SDK, Codex,… without me having to explicitly ask.当使用代理模式(Agent mode)下的 GitHub Copilot 时,VS Code 支持 MCP 服务器。
点击以下链接将 Docs MCP 添加到 VS Code
或者,您可以手动在项目根目录添加一个 .vscode/mcp.json 文件
{
"servers": {
"openaiDeveloperDocs": {
"type": "http",
"url": "https://developers.openai.ac.cn/mcp"
}
}
}为了让 VS Code 稳定地使用该 MCP 服务器,请将此代码片段添加到您的 AGENTS.md 中
Always use the OpenAI developer documentation MCP server if you need to work with the OpenAI API, ChatGPT Apps SDK, Codex,… without me having to explicitly ask.打开 Copilot Chat,切换到代理 (Agent) 模式,在工具选择器中启用该服务器,然后询问与 OpenAI 相关的问题,例如
在 文档中查找 Responses API 工具的请求架构,并总结所需的字段。
Cursor 原生支持 MCP,并从 mcp.json 读取配置。
使用 Cursor 安装
或者,创建一个 ~/.cursor/mcp.json (macOS/Linux) 并添加
{
"mcpServers": {
"openaiDeveloperDocs": {
"url": "https://developers.openai.ac.cn/mcp"
}
}
}为了让 Cursor 稳定地使用该 MCP 服务器,请将此代码片段添加到您的 AGENTS.md 中
Always use the OpenAI developer documentation MCP server if you need to work with the OpenAI API, ChatGPT Apps SDK, Codex,… without me having to explicitly ask.重启 Cursor 并询问 Cursor 代理一个与 OpenAI 相关的问题,例如
在 文档中查找 Responses API 工具的请求架构,并总结所需的字段。
Claude Code 通过 claude mcp CLI 支持远程 HTTP MCP 服务器。
从您使用 Claude Code 的项目中添加 Docs MCP 服务器
claude mcp add --transport http openaiDeveloperDocs https://developers.openai.ac.cn/mcp验证配置是否成功
claude mcp list若要使该服务器在您机器上的所有 Claude Code 项目中可用,请使用用户作用域添加它
claude mcp add --transport http --scope user openaiDeveloperDocs https://developers.openai.ac.cn/mcp在 Claude Code 中,运行 /mcp 以确认服务器已连接。然后询问与 OpenAI 相关的问题,例如
在 文档中查找 Responses API 工具的请求架构,并总结所需的字段。
提示
- 如果您没有在 AGENTS.md 文件中添加该片段,则需要明确告知您的代理咨询 Docs MCP 服务器以获取答案。
- 如果您有多个 MCP 服务器,请保持服务器名称简短且具有描述性,以帮助代理选择正确的服务器。
OpenAI 文档技能 (OpenAI Docs Skill)
如果您在 AI 工具中使用“技能 (Skills)”,请将此 MCP 服务器与 OpenAI Docs Skill 配对使用。它会告知代理优先使用 Docs MCP 工具来回答 OpenAI 相关问题,若无法回答,再回退到官方 OpenAI 域名。
- 从 OpenAI skills 仓库中安装此技能。
- 确认您已在
https://developers.openai.ac.cn/mcp配置了此 Docs MCP 服务器。 - 在您的代理工具中为您的项目或会话启用该技能。
- 询问 OpenAI 产品/API 相关问题,并要求提供引用来源,以便答案能够追溯到文档来源。