功能对比
| 客户端 | 推荐设置 | Key 放在哪里 |
|---|---|---|
| Claude Code local | 用 --api-key 运行本地 @upstash/context7-mcp server | CLI 参数或本地 secret wrapper。 |
| Claude Code remote | 用远程 HTTP endpoint 和 CONTEXT7_API_KEY header | Header value，不要提交到仓库。 |
| Cursor | 把 context7 添加到 Cursor mcp.json，或使用可用的一键安装 | args 中的 --api-key 或本地 env 处理。 |
| Codex 或 VS Code MCP | 使用客户端支持的 MCP config 或扩展设置 | 本地配置、环境变量或安全客户端设置。 |
| Context7 直接 API | 发送 Authorization: Bearer CONTEXT7_API_KEY | 服务端环境变量。 |
创建 Key
打开 Context7 dashboard，创建带名称的 API key，并立即复制。建议用 Claude Code、Cursor、Codex 或 VS Code 这样的名称，方便之后单独撤销某个客户端。
- 把 key 当作密码处理。
- 保存在本地密钥管理器或环境变量中。
- 不要粘贴到公开仓库、截图、共享 issue 或文档里。
- 如果 key 被提交或分享，立即轮换。
Claude Code 设置
如果希望通过本机 npx 启动 server，选择本地 stdio。若 MCP client 支持 headers，并且更偏向托管 endpoint，则选择远程 HTTP。
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp
Cursor 设置
Cursor 中把 context7 server 加入 MCP 配置，修改后重启或重新加载 MCP tools。
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}
}
}Codex 和直接 API
Codex 或 VS Code MCP clients 使用各自支持的 MCP 配置路径或扩展设置。直接 HTTP API 请求应从服务端代码发送 bearer token。
Authorization: Bearer CONTEXT7_API_KEY
排错清单
大多数 Context7 API key 问题来自复制错误、local 和 remote MCP 使用了错误的认证位置，或修改的配置文件不是客户端实际读取的文件。
- 确认 key 使用 dashboard 中显示的 Context7 key 前缀。
- 如果第一次显示时没有复制，重新生成 key。
- 远程 MCP HTTP 连接使用 CONTEXT7_API_KEY header。
- 本地 @upstash/context7-mcp stdio 连接使用 --api-key。
- 修改 MCP 配置后重启客户端。
- 如果 npx 失败，先修 Node 或 PATH，再怀疑 Context7 key。
常见问题
Context7 API key 在哪里获取？
在 Context7 dashboard 的 API Keys 区域创建，并在第一次显示时立即复制，因为 key 只显示一次。
Context7 没有 API key 能用吗？
部分 Context7 MCP 使用可能在基础限制下无需 key，但建议使用 API key 获得更稳定的认证配置和更高限制。
Context7 unauthorized 怎么办？
检查 key 是否复制完整、本地和远程 MCP 是否用了正确认证方式，以及客户端是否读取了你修改的配置文件。
Context7 API key 应该写进 mcp.json 吗？
个人本地配置可以工作，但共享仓库不要提交 key，优先使用环境变量或客户端 secret 设置。