文档 MCP | OpenAI 开发者
来源: https://developers.openai.com/learn/docs-mcp 抓取时间: 2026-07-21 16:19:10
OpenAI 在 developers.openai.com、platform.openai.com 和 learn.chatgpt.com 上托管了一个公共的 Model Context Protocol (MCP) 服务器,用于提供文档。
服务器 URL(可流式 HTTP): https://developers.openai.com/mcp
它提供什么
- 对 OpenAI 开发者文档的只读访问(搜索 + 页面内容)。
- 一种在您工作时将文档拉入智能体上下文的方法。
这个 MCP 服务器仅用于文档。它不会代表您调用 OpenAI API。
快速入门
选择一个选项 CodexVS CodeCursorClaude Code 您可以在 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:
如果您需要使用 OpenAI API、ChatGPT Apps SDK、Codex 等,请始终使用 OpenAI 开发者文档 MCP 服务器,无需我明确要求。
VS Code 在 Agent 模式下使用 GitHub Copilot 时支持 MCP 服务器。
单击以下链接将文档 MCP 添加到 VS Code:
在 VS Code 中安装
或者,您可以在项目根目录手动添加 .vscode/mcp.json:
{
"servers": {
"openaiDeveloperDocs": {
"type": "http",
"url": "https://developers.openai.com/mcp"
}
}
}
为了让 VS Code 可靠地使用 MCP 服务器,请将此片段添加到您的 AGENTS.md:
如果您需要使用 OpenAI API、ChatGPT Apps SDK、Codex 等,请始终使用 OpenAI 开发者文档 MCP 服务器,无需我明确要求。
打开 Copilot Chat,切换到 Agent 模式,在工具选择器中启用服务器,然后提出与 OpenAI 相关的问题,例如:
在 OpenAI 开发者文档中查找 Responses API 工具的请求架构,并总结必填字段。 Cursor 具有原生 MCP 支持,并从
mcp.json读取配置。 使用 Cursor 安装: 在 Cursor 中安装 或者,创建~/.cursor/mcp.json(macOS/Linux)并添加:
{
"mcpServers": {
"openaiDeveloperDocs": {
"url": "https://developers.openai.com/mcp"
}
}
}
为了让 Cursor 可靠地使用 MCP 服务器,请将此片段添加到您的 AGENTS.md:
如果您需要使用 OpenAI API、ChatGPT Apps SDK、Codex 等,请始终使用 OpenAI 开发者文档 MCP 服务器,无需我明确要求。
重启 Cursor,并向 Cursor 的智能体提出与 OpenAI 相关的问题,例如:
在 OpenAI 开发者文档中查找 Responses API 工具的请求架构,并总结必填字段。 Claude Code 通过
claude mcpCLI 支持远程 HTTP MCP 服务器。 从您使用 Claude Code 的项目中添加文档 MCP 服务器:
claude mcp add --transport http openaiDeveloperDocs https://developers.openai.com/mcp
验证配置是否正确:
claude mcp list
要使服务器在您计算机上的所有 Claude Code 项目中可用,请使用用户作用域添加:
claude mcp add --transport http --scope user openaiDeveloperDocs https://developers.openai.com/mcp
在 Claude Code 中,运行 /mcp 以确认服务器已连接。然后提出与 OpenAI 相关的问题,例如:
在 OpenAI 开发者文档中查找 Responses API 工具的请求架构,并总结必填字段。
提示
- 如果您在 AGENTS.md 文件中没有该片段,则需要明确告诉您的智能体查阅文档 MCP 服务器以获取答案。
- 如果您有多个 MCP 服务器,请保持服务器名称简短且具有描述性,以帮助智能体选择服务器。
OpenAI 文档技能
如果您在 AI 工具中使用技能,请将此 MCP 服务器与 OpenAI 文档技能 配对。它告诉智能体首先使用文档 MCP 工具回答 OpenAI 问题,然后回退到官方 OpenAI 域名。
- 从 OpenAI 技能仓库 安装技能。
- 确认您在
https://developers.openai.com/mcp配置了此文档 MCP 服务器。 - 在您的智能体工具中为您的项目或会话启用该技能。
- 提出 OpenAI 产品/API 问题并请求引用,以便答案可以追溯到文档来源。