# 把官方文档接进 Codex 与 Claude Code

原文：https://itjc.com/tutorials/connect-docs-mcp/
主题：MCP；级别：实战；更新时间：2026-11-15。

> 添加 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 的基本组成，并附官方页面链接。
如果服务不可用，直接报告失败，不要用记忆替代本次检索。
```

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

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

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

## 官方资料与参考

- [OpenAI Docs MCP 官方配置](https://developers.openai.com/learn/docs-mcp)
- [Claude Code MCP 配置说明](https://code.claude.com/docs/en/mcp)
