这次连接什么
OpenAI 提供官方文档 MCP 服务,用来检索和读取开发者文档。它是文档访问入口,不会替你调用 OpenAI API。以下命令以已安装并能正常运行的 Codex CLI 或 Claude Code 为前提,两种方式任选与你环境对应的一种。
方式一:Codex CLI
在终端添加服务,再列出配置。这里使用官方文档中的服务地址和示例名称。
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list确认列表里能看到对应名称。如果命令不存在,先检查已安装的 CLI 版本和当前官方配置说明,不要直接套用其他客户端的 JSON 格式。
方式二:Claude Code
在使用 Claude Code 的项目目录执行下面的命令。它按此命令的默认作用域配置;如果希望所有项目都可用,请查看官方文档中的 user scope 选项,再决定是否扩大范围。
claude mcp add --transport http openaiDeveloperDocs https://developers.openai.com/mcp
claude mcp list做一次有引用的读取验收
在新的或已刷新配置的会话里发送:
请使用 OpenAI 官方文档 MCP 查询:如何创建一个 Skill?
读取匹配页面,说明 SKILL.md 的基本组成,并附官方页面链接。
如果服务不可用,直接报告失败,不要用记忆替代本次检索。检查工具记录与返回链接,再打开引用页面核对。看到配置列表不等于这次问答已经实际调用了服务。
遇到问题怎么办
连接失败先确认地址、网络和客户端支持;服务配置存在但不可用时,按官方方式刷新会话或查看状态;调用成功但答案无依据时,要求明确读取支持结论的页面。保留具体错误比反复删除重装更容易定位原因。
完成标准
配置能列出、读取任务成功、结论有直接来源。这个练习完成后,再评估是否需要连接自己的私有资料。