MCP OAuth 2.1 调试器 — 认证体检工具

一键体检任意远程 MCP 端点的完整 OAuth 2.1 链路:401 挑战、RFC 9728 受保护资源元数据(PRM)、RFC 8414 授权服务器元数据、DCR 动态注册与 CORS 头。

📋 主流客户端 OAuth 回调地址速查表

调试授权流程时,先在下方表格核对你的客户端使用的回调路径——多数「授权成功但客户端无响应」的问题都源于回调地址被拦截或拼写错误。

客户端回调地址
Claude Codehttp://localhost:<port>/callback(CLI 本地回环)
Claude.ai / Claude Desktophttps://claude.ai/api/mcp/auth_callback
Cursorcursor://anysphere.cursor-deeplink/oauth/callback
VS Codevscode://vscode.github-authentication/did-authenticate 或本地回环
ChatGPThttps://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 需同时包含二者,否则授权状态会被静默吞掉。