upstash/context7 skill 装 CLI 还是 MCP 更省排查

你给编码代理装 upstash/context7 后，如果回答还是旧 API，先别急着换工具。更常见的问题是接入方式和提问方式没对上：CLI + Skills 负责把取文档动作教给代理，MCP 负责让客户端原生调用文档工具。

这份 skill 教程只解决一个选择：先用 npx ctx7 setup 跑通最小链路；长期在 Cursor、Claude Code、Codex 里工作，再把 MCP 或规则固定下来。Context7 的价值是把当前文档放进上下文，不是替你判断所有库版本差异。

想少排查，先走一键安装

官方 README 给出的主路径是 npx ctx7 setup。它要求 Node.js 18 或更高版本，会完成认证、API Key 和对应配置。第一次只看它能不能完成安装，不要同时改多个客户端。

node -v
npx ctx7 setup
npx ctx7 remove

如果安装时只想覆盖一个客户端，加 --cursor、--claude 或 --opencode。这样排查范围更小。

MCP 适合稳定客户端，不适合盲填

手动 MCP 配置要确认地址和 header。地址是 https://mcp.context7.com/mcp，Key 放进 CONTEXT7_API_KEY。官方建议去 context7.com/dashboard 生成免费 API Key，提高请求限额。

测试时把库 ID 写出来

宽泛问“帮我写 Supabase 登录”容易先走库匹配。更省事的写法是把库 ID 或版本放进任务里，例如 use library /supabase/supabase，或者写清 Next.js 14、Cloudflare Worker 这类大版本。CLI 也能单独看结果：

ctx7 library next middleware
ctx7 docs /vercel/next.js "middleware auth redirect"

upstash/context7 适合解决“文档过期导致代码写错”的问题；它不替代人工审查，也不保证所有社区文档都完整。先用 CLI 验证，再把 MCP 固定进常用客户端，排错会轻很多。

真正跑顺以后，你要看到两个信号：代理回答里能引用当前文档里的 API 写法，遇到版本差异时会先查文档再生成代码。只要这两个信号稳定出现，Context7 就不是多装了一个工具，而是在减少后续返工。