新機能 / v2.1.273
MCP再接続失敗時の通知
CHANGELOG 原文(英語)
Added a notification when an MCP server disconnects mid-session and automatic reconnection gives up, pointing at /mcp 公式の変更履歴を開く ↗ 日本語での補足
セッション中にMCPサーバーが切断し自動再接続が失敗した場合、/mcpを案内する通知を追加。
ドキュメント
ドキュメントの抜粋(参考訳)
セッション中にリモートサーバーが切断された場合
Claude Codeはまず、切断されたリモートサーバーへの再接続を、指数バックオフで最大5回まで試みます。最初は1秒の遅延から始まり、そのたびに倍になっていきます。
- 対話セッションの場合: Claude Codeが再接続を試みている間、
/mcpにはそのサーバーがpendingと表示されます。5回失敗すると、Claude Codeはそのサーバーをfailedとマークするか、サーバーの再承認が必要な場合はneeding authenticationとマークします。failedとマークされると、通知でClaude Codeが引き続き再試行しているかどうかが示されます。MCP server "<name>" disconnected · still retrying · open /mcp to reconnect now: Claude Codeは、そのサーバーへの再試行を最大で約1日続けられます。/mcpでは、失敗したサーバーはretryingと表示されます。待つか、/mcpから再接続できます。再試行を止めるには、/mcpからプロジェクトのサーバーを無効化してください。MCP server "<name>" disconnected · open /mcp to reconnect: Claude Codeはバックグラウンドでそのサーバーを再試行していません。/mcpから再接続してください。
claude -pの実行やAgent SDKセッションの場合: Claude Codeは同じ5回の試行を行いますが、試行状況を表示する/mcpパネルはありません。5回すべて失敗すると、実行はそのサーバーのツールなしで継続します。-
5xxレスポンスやタイムアウトなどの一時的なエラーの場合: Claude Codeは、HTTPまたはSSEサーバーへの再試行をバックグラウンドで続けます。再試行は最大で約30分間、一部のサーバーでは約1日間続き、接続できた時点でそのサーバーのツールが再び利用できるようになります。
それまでの間、Agent SDKセッションはステータスを
failedとして報告し、コードからサーバーを再接続できます。claude -pで再接続するには、実行をもう一度開始してください。 -
サーバーが再度のサインインを必要とする場合: Agent SDKセッションはサーバーのステータスを
needs-authとして報告します。claude mcp listにそのサーバーが表示されている場合は、シェルでclaude mcp login <name>を実行してサインインしてください。その後、実行をもう一度開始するか、Agent SDKのコードからサーバーを再接続してください。
-
取得日 · 2026-11-20