Skip to content
← リリースに戻る · 2.1.273
新機能 / 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

変更の詳細