OpenAI Developers·· 2026-01-06精选AI 评分56
OpenAI Docs MCP 接入指南:让 Codex 检索官方开发文档
Docs MCP
AI 导读
OpenAI 介绍如何为 Codex 配置 Docs MCP,以只读方式搜索官方开发文档并将页面内容引入智能体上下文,不会代用户调用 OpenAI API。
推荐理由
通过共享配置接入文档服务并配合技能优先检索官方资料,这套方法可用于让智能体的产品与 API 回答更易追溯到原始文档。
正文 · AI 翻译
OpenAI 托管了一个公共模型上下文协议(MCP)服务器,提供有关 developers.openai.com、platform.openai.com 和 learn.chatgpt.com 的文档。
服务器 URL(可流式传输的 HTTP): https://developers.openai.com/mcp
它提供什么
- 对 OpenAI 开发者文档的只读访问(搜索 + 页面内容)。
- 一种在工作时将文档引入智能体上下文的方式。
此 MCP 服务器仅用于文档。它不会代表你调用 OpenAI API。
快速入门
选择一个选项
你可以在 CLI 或 IDE 扩展中将 Codex 连接到 MCP 服务器。两者共享配置,因此你只需设置一次。
使用 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 服务器,请将此片段添加到你的 AGENTS.md 中:
Always use the OpenAI developer documentation MCP server if you need to work with the OpenAI API, plugins, ChatGPT, Codex,… without me having to explicitly ask.提示
- 如果 AGENTS.md 文件中没有该片段,你需要明确告诉智能体查阅 Docs MCP 服务器来获取答案。
- 如果你有多个 MCP 服务器,请使用简短且具有描述性的服务器名称,以帮助智能体选择服务器。
OpenAI Docs 技能
如果你在 AI 工具中使用技能,请将此 MCP 服务器与 OpenAI Docs 技能搭配使用。 它会指示智能体在处理 OpenAI 相关问题时优先使用 Docs MCP 工具,然后再回退到 OpenAI 官方域名。
- 从 OpenAI 技能仓库安装该技能。
- 确认你已在
https://developers.openai.com/mcp配置此 Docs MCP 服务器。 - 在你的智能体工具中,为项目或会话启用该技能。
- 提出有关 OpenAI 产品/API 的问题,并要求提供引用,以便答案始终可追溯至文档来源。
来源:OpenAI Developers · developers.openai.com