Skip to content
← Back to release · 2.1.273
New features / v2.1.273

Notify when MCP reconnection gives up

CHANGELOG · original

Added a notification when an MCP server disconnects mid-session and automatic reconnection gives up, pointing at /mcp
Open official changelog ↗

Documentation

Documentation excerpt

Mid-session drops of a remote server

Claude Code first tries to reconnect a dropped remote server up to five times with exponential backoff, starting at a one-second delay and doubling it each time:

  • In an interactive session: /mcp shows the server as pending while Claude Code reconnects. After five failed attempts, Claude Code marks the server as failed, or as needing authentication when the server needs authorizing again. When it marks the server as failed, a notification tells you whether Claude Code is still retrying:
    • MCP server "<name>" disconnected · still retrying · open /mcp to reconnect now: Claude Code can keep retrying the server for up to about a day. In /mcp, the failed server shows as retrying. You can wait, or reconnect it from /mcp. To stop the retries, disable the server for the project from /mcp.
    • MCP server "<name>" disconnected · open /mcp to reconnect: Claude Code isn't retrying the server in the background. Reconnect it from /mcp.
  • In claude -p runs and Agent SDK sessions: Claude Code makes the same five attempts, with no /mcp panel to show them. If all five fail, the run continues without the server's tools:
    • After a transient error, such as a 5xx response or a timeout: Claude Code keeps retrying an HTTP or SSE server in the background. Retries last up to about half an hour, or about a day for some servers, and the server's tools become available again when one connects.

      Until then, an Agent SDK session reports the status failed, and your code can reconnect the server. To reconnect it in claude -p, start the run again.

    • When the server needs you to sign in again: an Agent SDK session reports the server's status as needs-auth. If claude mcp list shows the server, sign in with claude mcp login <name> in your shell. Then start the run again, or reconnect the server from your Agent SDK code.

Documentation snapshot · 2026-11-20

Change details