跳到正文
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 官方域名。

  1. 从 OpenAI 技能仓库安装该技能。
  2. 确认你已在 https://developers.openai.com/mcp 配置此 Docs MCP 服务器。
  3. 在你的智能体工具中,为项目或会话启用该技能。
  4. 提出有关 OpenAI 产品/API 的问题,并要求提供引用,以便答案始终可追溯至文档来源。

来源:OpenAI Developers · developers.openai.com