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:
/mcpshows 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 asretrying. 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 -pruns and Agent SDK sessions: Claude Code makes the same five attempts, with no/mcppanel 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 inclaude -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. Ifclaude mcp listshows the server, sign in withclaude 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