Codex CLI教程（五） | MCP 之 Context7

前言

给 Codex 接入 Context7，常见有两种方式：Skills和MCP。

不过，如果你的目标是稳定获取最新文档，那么不建议优先选Skills。
原因很简单：根据官方文档的定位，Skills更偏向可复用的工作流和提示模板，而 Context7 的核心能力是文档检索与文档上下文接入，这类能力更适合通过MCP直接接入。

所以，下面重点只讲MCP。

第一章：MCP 接入前置要求

在正式配置之前，先准备一个Context7 API Key。因为无论你使用的是本地 MCP还是远程 HTTP MCP，手动配置时通常都要用到这个 Key。

申请步骤很简单：

1. 注册并登录 Context7
2. 进入 Dashboard
3. 打开 API Keys 页面
4. 创建一个新的 Key
5. 保存下来，后面配置时填入YOUR_API_KEY

准备好 Key 之后，就可以开始正式接入了。

第二章：MCP 接入方式

2.1 方式一：本地接入

本地 MCP 的意思是：在本机启动一个 Context7 MCP 进程。

Codex 不会直接连接 Context7，而是先连接这个本地进程，再由这个本地进程处理后续请求。它的链路可以理解为：

Codex -> 本地 MCP -> Context7

这也是为什么本地 MCP 看起来会“多一步”。因为它本质上就是先在本机起一个 MCP server，再由这个本地 server 去对接 Context7。

在 Codex 里的典型配置如下：

[mcp_servers.context7] command = "npx" args = ["-y", "@upstash/context7-mcp", "--api-key", "你申请的key"] startup_timeout_sec = 20

这段配置的含义很直接：

• command：用什么命令启动本地 MCP server
• args：传给它的启动参数
• --api-key：传入 Context7 的 API Key
• startup_timeout_sec：启动超时时间

如果你接受本机多起一个 MCP 进程，可以使用这种方式。

2.2 方式二：远程接入（推荐）

远程 HTTP MCP 的意思是：不在本机启动 Context7 MCP 进程。

Codex 会直接连接 Context7 官方提供的远程 MCP 服务。它的链路可以理解为：

Codex -> Context7

相比本地 MCP，它少了一层本地中转，所以更直接，也更适合作为默认选择。

在 Codex 里的典型配置如下：

[mcp_servers.context7] url = "https://mcp.context7.com/mcp" http_headers = { "CONTEXT7_API_KEY" = "你申请的key" }

这段配置的含义也很清楚：

• url：Context7 的远程 MCP 地址
• http_headers：请求头
• CONTEXT7_API_KEY：用于认证的 API Key

如果你只是想尽快接入并开始使用，远程 HTTP MCP 通常更适合作为默认方案。