MCP

把官方文档接进 Codex 与 Claude Code

添加 OpenAI Docs MCP,检查连接,然后用一个带来源的小问题验收。

这次连接什么

OpenAI 提供官方文档 MCP 服务,用来检索和读取开发者文档。它是文档访问入口,不会替你调用 OpenAI API。以下命令以已安装并能正常运行的 Codex CLI 或 Claude Code 为前提,两种方式任选与你环境对应的一种。

方式一:Codex CLI

在终端添加服务,再列出配置。这里使用官方文档中的服务地址和示例名称。

sh
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list

确认列表里能看到对应名称。如果命令不存在,先检查已安装的 CLI 版本和当前官方配置说明,不要直接套用其他客户端的 JSON 格式。

方式二:Claude Code

在使用 Claude Code 的项目目录执行下面的命令。它按此命令的默认作用域配置;如果希望所有项目都可用,请查看官方文档中的 user scope 选项,再决定是否扩大范围。

sh
claude mcp add --transport http openaiDeveloperDocs https://developers.openai.com/mcp
claude mcp list

做一次有引用的读取验收

在新的或已刷新配置的会话里发送:

text
请使用 OpenAI 官方文档 MCP 查询:如何创建一个 Skill?
读取匹配页面,说明 SKILL.md 的基本组成,并附官方页面链接。
如果服务不可用,直接报告失败,不要用记忆替代本次检索。

检查工具记录与返回链接,再打开引用页面核对。看到配置列表不等于这次问答已经实际调用了服务。

遇到问题怎么办

连接失败先确认地址、网络和客户端支持;服务配置存在但不可用时,按官方方式刷新会话或查看状态;调用成功但答案无依据时,要求明确读取支持结论的页面。保留具体错误比反复删除重装更容易定位原因。

完成标准

配置能列出、读取任务成功、结论有直接来源。这个练习完成后,再评估是否需要连接自己的私有资料。

官方资料与参考

产品功能与命令可能调整。遇到差异时,以对应官方页面和当前环境为准。

读完了,动手试一次。

完成练习后,标记进度,方便继续学习。