MCP OAuth 2.1 调试器 — 认证体检工具
一键体检任意远程 MCP 端点的完整 OAuth 2.1 链路:401 挑战、RFC 9728 受保护资源元数据(PRM)、RFC 8414 授权服务器元数据、DCR 动态注册与 CORS 头。
📋 主流客户端 OAuth 回调地址速查表
调试授权流程时,先在下方表格核对你的客户端使用的回调路径——多数「授权成功但客户端无响应」的问题都源于回调地址被拦截或拼写错误。
| 客户端 | 回调地址 |
|---|---|
| Claude Code | http://localhost:<port>/callback(CLI 本地回环) |
| Claude.ai / Claude Desktop | https://claude.ai/api/mcp/auth_callback |
| Cursor | cursor://anysphere.cursor-deeplink/oauth/callback |
| VS Code | vscode://vscode.github-authentication/did-authenticate 或本地回环 |
| ChatGPT | https://chatgpt.com/connector_platform_platform_oauth |
| Windsurf | 本地回环(由客户端自动分配端口) |
📖 RFC 9728 PRM 与 CIMD 详解
RFC 9728 定义了 OAuth 2.1 Protected Resource Metadata:受保护资源(MCP 服务器)在 /.well-known/oauth-protected-resource 发布自身支持的授权服务器与 scopes。客户端首次收到 401 后,从 WWW-Authenticate: Bearer resource_metadata=" 头中解析出元数据地址,再完成授权服务器发现(RFC 8414)与 PKCE 授权。
CIMD(Client ID Metadata Document)是 MCP 生态用于替代部分 DCR 场景的方案:客户端以一个可抓取文档的 HTTPS URL 作为 client_id,授权服务器通过拉取该文档校验客户端身份。下方调试器会自动报告端点是否声明了 resource_metadata、CIMD 与必要的 CORS 暴露头。
❓ 常见问题
401 挑战头里应该包含什么?
规范的 MCP OAuth 2.1 挑战应包含 WWW-Authenticate: Bearer realm="..." 以及 resource_metadata="。缺少后者时多数客户端无法自动完成授权——这是调试器最常见的拦截项。
PRM 与授权服务器元数据有什么区别?
PRM(RFC 9728)描述的是 MCP 资源服务器自己(接受的 AS、scopes、bearer 方法);RFC 8414 元数据描述的是授权服务器(端点、grant 类型、DCR 支持)。两者是接力关系:先读 PRM 找到 AS,再读 AS 元数据完成注册与授权。
本地开发时 DCR 被禁用怎么办?
部分授权服务器不开启动态注册。可改用预注册的 client_id、CIMD 文档,或在授权服务器控制台手动创建客户端——调试器会标注端点是否支持 DCR。
CORS 暴露头需要哪些?
浏览器客户端必须能读取 WWW-Authenticate 与 Mcp-Session-Id:Access-Control-Expose-Headers 需同时包含二者,否则授权状态会被静默吞掉。