結論：URL promptsは認証導線であり、MCP接続の安全証明ではない
Claude Code 2.1.287では、MCP serverが2025-11-25 protocolのURL promptを返し、サインインなどの確認先を案内できます。更新後にserverがつながらなくなった場合、公式changelogはMCP設定へ"bareElicitationCapability": trueを追加する対処を示しています。ただし、URLを開く前に接続先ドメイン、認証方法、scope、戻り値、利用者の承認を確認し、設定を足して終わりにしないでください。
Anthropic公式のClaude Code changelogは2.1.287のURL prompts追加と、旧serverが接続しない場合の設定を案内しています。公式のMCP referenceとMCP quickstartはserverの追加、確認、設定の場所を説明します。既存のMCPの使い方が導入の入口、本稿は更新後の接続不具合と認証導線の判断に限定します。
URL promptの流れを5段階で見る
- MCP serverが、ユーザーの追加操作を必要とする場面を検知します。
- serverが2025-11-25 protocolに沿ったURL promptを返します。
- Claude CodeがURLや説明を表示し、利用者が接続先と目的を確認します。
- 利用者が認証ページでサインインし、必要なscopeを承認します。
- serverへ戻った後、MCPのlist toolsとテスト呼び出しで状態を確認します。
この順序で重要なのは、Claude Codeへの接続と、外部サービスへの認証を別のイベントとして記録することです。MCPが接続済みでも、toolが必要な権限を持つとは限りません。逆に認証画面が表示されても、偽サイトや不要なscopeを自動で安全とは判定できません。接続先、ユーザー、scope、承認時刻を監査記録へ残します。
更新後に接続できない時の比較表
| 症状 | 最初に見る箇所 | 次の判断 |
|---|---|---|
| serverが起動しない | 設定JSON、command、環境変数 | 認証よりプロセス起動を直す |
| 起動するがtoolが出ない | protocol、capability、list tools | serverの対応versionを確認 |
| 認証URLが出ない | URL prompt対応とserverログ | 手動URLを勝手に作らず公式仕様を確認 |
| 更新後だけ接続しない | Claude Code versionとchangelog | 必要時のみbareElicitationCapabilityを検証 |
| toolは出るが実行できない | scope、ユーザー、権限、deny | 読み取り専用で再現する |
エラー文が「接続失敗」だけなら、起動、protocol交渉、認証、tool呼び出しを一つの原因にまとめないことが重要です。MCPの一般的な切り分けはMCPトラブルシューティング、切断後の再接続はMCP disconnect/reconnectも参照してください。
設定変更を8手順で検証する
claude --versionで2.1.287以上か記録します。- MCP設定のscope（local、project、user）と変更者を確認します。
- serverのprotocolと、URL promptを返す条件をserver側の公式資料で確認します。
- 認証URLのドメイン、HTTPS、redirect、scope、期限をレビューします。
- 最小権限のテストアカウントで、read-only toolだけを表示します。
- 更新前後のserverログ、Claude Codeログ、認証イベントを同じ時刻軸で比較します。
- 必要な場合だけ設定へ
"bareElicitationCapability": trueを追加し、変更理由を残します。 - 再起動後にlist tools、read-only呼び出し、認証取消、復旧を試します。
設定例はserverのエントリへ追加する形になりますが、実際のキーの置き場所やJSON構造は利用しているMCP設定形式に合わせます。既存設定を全置換せず、差分を保存してrollbackできるようにしてください。秘密情報をエラーログや画面共有へ出さないこともテスト項目です。
認証・tool・データ送信のチェックリスト
- Claude CodeとMCP serverのversion、protocol、変更時刻を記録した
- URL promptの接続先が公式ドメインまたは承認済みドメインである
- scope、tokenの保管場所、期限、失効方法を確認した
- bareElicitationCapabilityを追加する根拠とrollbackを記録した
- 認証後に表示されるtoolと、各toolの書き込み範囲を確認した
- read-only、認証取消、server停止、再接続の各ケースを試した
- 個人情報・秘密情報をテスト入力に使わず、ログのマスキングを確認した
企業運用では、MCPの接続可否だけでなく、誰がserverを登録できるかを決めます。managed MCPで組織提供に固定する場合はmanagedMcpServersの運用、秘密の診断値を扱う場合はMCP診断のsecret保護を併読してください。
FAQ
- URL promptが表示されたら認証してよいですか？
- 表示だけでは判断しません。ドメイン、HTTPS、求めるscope、サービスの所有者、利用目的を確認し、承認済みの認証先だけで進めます。
- bareElicitationCapabilityを追加しても直らない場合は？
- protocol不一致、serverの起動、認証期限、proxy、toolの権限を順番に切り分けます。追加設定を増やす前に、versionとserverログを保存してください。
- MCP接続の安全診断を相談できますか？
- できます。serverの出所、設定scope、認証情報、tool一覧、データ分類を無料診断（60秒）へまとめてください。
認証の成否を確認する時は、MCPのtoolが表示されたことだけでなく、認証に使ったアカウント、付与されたscope、tokenの期限、サービス側の監査イベントを照合します。URL promptの画面で利用者が別アカウントへ切り替えた場合、Claude Codeのsession利用者と外部サービスの主体がずれることがあります。業務データを読むtoolほど、この主体の一致を必須条件にします。
proxyや社内ネットワークを通る環境では、認証ページだけが開き、callbackまたはMCP serverへの戻りが失敗する場合があります。ブラウザの成功画面とserverログの成功を同じものと扱わず、時刻、request ID、HTTP status、redirect先を確認します。社内proxyの証明書やURL書き換えを無断で回避せず、ネットワーク担当者と承認済み経路を作ります。
更新の切り戻しは、Claude Codeを古いversionへ戻すことだけではありません。serverのprotocol、設定差分、認証token、client側のキャッシュ、利用者へ案内した手順も戻す必要があります。まずread-only toolで復旧を確認し、書き込みtoolは新しい接続の承認とテスト結果が揃うまで停止します。障害の再発防止には、version更新前のMCP smoke testをCIまたは定期点検へ組み込みます。