MCP OAuth 2.1 デバッガー — 認証ヘルスチェック

任意のリモートMCPエンドポイントの OAuth 2.1 チェーンを一括診断:401 チャレンジ、RFC 9728 保護リソースメタデータ(PRM)、RFC 8414 認可サーバーメタデータ、DCR、CORS ヘッダー。

📋 主要クライアントの OAuth コールバック URL 早見表

「認可は成功したのにクライアントが応答しない」問題の多くはコールバック URL のブロックや誤記が原因です。まず下表でクライアントのコールバック形式を確認してください。

クライアントコールバックURL
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)は DCR の一部を代替する仕組みで、client_id として取得可能な HTTPS URL を使い、認可サーバーがそのドキュメントを取得してクライアントを検証します。下のデバッガーは 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 を使うか、AS コンソールで手動作成してください。デバッガーは DCR 対応の有無も表示します。

必要な CORS 露出ヘッダーは?

ブラウザクライアントが WWW-Authenticate と Mcp-Session-Id を読めるよう、Access-Control-Expose-Headers に両方を含める必要があります。欠けると認可状態が静かに失われます。