Context7 是什么？
Context7 是面向技术文档检索的远程 MCP 服务。Codex 可以按库名和版本查询近期文档与代码示例，用真实资料替代模型对旧 API 的模糊记忆。
一句话理解按具体技术库和版本检索近期文档，减少编码助手引用过时 API 的概率。
为什么需要它？
把模糊的模型记忆替换成按库检索的文档上下文，但仍需开发者核对最终版本。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
解析技术库标识
把真实信息带回当前任务，减少反复复制和手动核对。
检索相关官方或维护文档片段
在明确授权范围内调用工具，并保留执行过程和结果。
通过远程 MCP 或 CLI Skill 提供上下文
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 查当前版本的库文档和 API 用法
- 经常处理依赖升级、SDK 用法、框架配置和版本差异的开发者。
- 返回库名、版本和原始文档片段；关键配置仍回到官方文档和测试验证。
- 不适合替代编译、测试或安全审计，也不应发送私有代码。
- 查询和库名会发送给第三方服务
- 返回内容可能仍存在版本差异或缺页
怎么接入？
- 1准备
准备 Context7 账号；建议创建 API Key 以获得稳定限额。
- 2授权
运行
npx ctx7 setup并选择 MCP 模式，或按官方 README 登记远程端点。 - 3连接
在客户端确认 Context7 工具可见。
- 4开始使用
用一个公开技术库和明确版本测试文档检索。
安装命令
添加 Context7
codex mcp add context7 --url https://mcp.context7.com/mcp添加远程服务后，用一个公开技术库做首次查询。需要更高限额时再按官方说明配置账号。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Context7
请帮我在当前电脑上接入并验证 Context7。
官方来源：https://github.com/upstash/context7
目标接入命令：codex mcp add context7 --url https://mcp.context7.com/mcp
请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 Context7 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 Context7 查 React 19 的 useOptimistic 官方用法，并告诉我文档版本和限制；不要引用不明博客。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 Context7 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Context7 查 React 19 的 useOptimistic 官方用法，并告诉我文档版本和限制；不要引用不明博客。怎样算成功
返回库名、版本和原始文档片段；关键配置仍回到官方文档和测试验证。
- 先解析技术库标识。
- 给出库名、版本和具体问题。
- 检查返回片段是否对应当前版本。
- 关键配置继续回到项目官方文档复核。
权限与安全
凭证与连接方式
远程 HTTP；查询的库名和问题会发送给第三方文档服务。
- 查询和库名会发送给第三方服务
- 返回内容可能仍存在版本差异或缺页
- 不要把检索结果当成编译、测试或安全审计的替代品
