Context7 MCP 远程连接如何改用 OAuth 认证？

Context7 MCP 远程连接如何改用 OAuth 认证【免费下载链接】context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors项目地址: https://gitcode.com/gh_mirrors/co/context7如果你的 MCP 客户端目前通过远程 HTTP 连接 Context7服务端地址https://mcp.context7.com/mcp并用Authorization: Bearer YOUR_API_KEY请求头传递 API key想把认证方式换成 OAuth 2.0只需要做两件事把客户端配置里的服务端地址从/mcp改为/mcp/oauth然后在客户端里显式触发一次认证流程。认证完成后token 刷新由客户端自动处理不再需要在配置里维护 API key。适用前提OAuth 只对远程 HTTP 连接生效改端点之前先确认你的连接方式因为 Context7 文档对两种传输方式的认证路径做了明确区分见 docs/howto/oauth.mdxOAuth只适用于远程 HTTP 连接。如果你本地跑npx -y upstash/context7-mcp这类 stdio 方式OAuth 不可用只能继续用 API key。你的 MCP 客户端需要实现了 MCP OAuth specification。不支持 OAuth 的客户端仍应使用 API key 认证。远程连接支持三种模式匿名低限额、API key、OAuth。改用 OAuth 后请求走 OAuth 通道不再依赖 API key。切换前后各认证方式的能力对照文档原文能力OAuthAPI Key无需手动管理密钥支持不支持自动刷新 token支持不支持支持 stdio 传输不支持支持如果你的客户端在 All MCP Clients 列表中且属于npx ctx7 setup支持的客户端如 Claude Code、Cursor也可以用npx ctx7 setup --claude/npx ctx7 setup --cursor让 CLI 代为完成认证与配置本文按手动改配置的路径展开。第一步把服务端地址从 /mcp 改为 /mcp/oauth端点改法对所有远程配置一致见 docs/howto/oauth.mdx- url: https://mcp.context7.com/mcp url: https://mcp.context7.com/mcp/oauth也就是说你原来的配置里指向https://mcp.context7.com/mcp的字段改成https://mcp.context7.com/mcp/oauth即可认证信息由 OAuth 流程接管原先的 API key 请求头不再需要。下面以两个客户端为例展示切换前后的完整配置。示例一Cursor~/.cursor/mcp.json改动前远程连接配置长这样YOUR_API_KEY是文档中的占位符代表你在 Context7 dashboard 创建的密钥{ mcpServers: { context7: { url: https://mcp.context7.com/mcp, headers: { Authorization: Bearer YOUR_API_KEY } } } }改用 OAuth 后只需把 URL 换成/mcp/oauth{ mcpServers: { context7: { url: https://mcp.context7.com/mcp/oauth } } }示例二OpenClaw命令行注册OpenClaw 的文档把 OAuth 列为推荐方式。注册 OAuth 端点并在浏览器中登录openclaw mcp add context7 \ --url https://mcp.context7.com/mcp/oauth \ --transport streamable-http \ --auth oauth openclaw mcp login context7如果之前是按 API key 或匿名方式注册的--url https://mcp.context7.com/mcp --transport streamable-http可选追加--header Authorization: Bearer YOUR_API_KEY把端点换成/mcp/oauth并加上--auth oauth后执行openclaw mcp login context7即可。可选分支HermesHermes 直接编辑~/.hermes/config.yamlAPI key 配置与 OAuth 配置的区别在文档中有现成对照# API key 方式改前 mcp_servers: context7: url: https://mcp.context7.com/mcp headers: CONTEXT7_API_KEY: YOUR_API_KEY# OAuth 方式改后 mcp_servers: context7: url: https://mcp.context7.com/mcp/oauth auth: oauthHermes 也可用等价命令hermes mcp add context7 --url https://mcp.context7.com/mcp/oauth --auth oauth。触发认证并验证连接这里是最容易漏掉的一步。Context7 文档明确警告多数客户端添加 OAuth 端点后不会自动完成认证你需要在客户端的 MCP 设置里显式发起一次。完整的 OAuth 流程是见 docs/howto/oauth.mdx你的 MCP 客户端连接到 OAuth 端点浏览器被重定向到 Context7 登录页登录完成后重定向回客户端后续 token 刷新由客户端自动处理。具体到客户端验证方式如下Claude Code运行/mcp选中 Context7 服务器选择 Authenticate完成浏览器登录。OpenClaw运行以下命令验证能连上并发现 Context7 的工具openclaw mcp doctor context7 --probeHermes运行hermes mcp test context7触发认证流程并验证连接。文档补充在无头headless环境里Hermes 可能把授权 URL 打印到 stdout 或日志中需要手动在浏览器打开如果hermes mcp add ... --auth oauth进入交互式界面而没有保存服务器条目就手动在mcp_servers.context7里补上上面的配置再运行hermes mcp test context7。完成认证并看到客户端正常发现resolve-library-id、query-docs等工具后说明切换成功之后再向客户端提问库文档时请求会走 OAuth 通道不再读取配置里的 API key。限制与回退OAuth 端点/mcp/oauth只对远程 HTTP 连接开放stdio本地npx -y upstash/context7-mcp连接没有 OAuth 路径只能走 API key。客户端不支持 MCP OAuth specification 时维持 API key 认证不变在 Context7 dashboard 创建 API key格式ctx7sk-...配置中传Authorization: Bearer YOUR_API_KEY请求头详见 docs/howto/api-keys.mdx。如果切换后出现认证失败先回到触发认证一节确认是否已在客户端里显式完成了一次 OAuth 登录而不是反复修改端点地址。【免费下载链接】context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors项目地址: https://gitcode.com/gh_mirrors/co/context7创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考