claude-code - 💡(How to fix) Fix [Feature] Reconnect/restart MCP servers from Claude Code in Claude Desktop without Cmd+Q (expose /mcp UI or auto-reconnect) [2 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#54136Fetched 2026-04-28 06:38:17
View on GitHub
Comments
2
Participants
2
Timeline
6
Reactions
0
Author
Timeline (top)
labeled ×4commented ×2

Error Message

  1. Next tool call hangs, eventually fails with a transport error.

Root Cause

  • The CLI's /mcp slash command (which exposes per-server reconnect / status / OAuth re-auth) isn't reachable from the Desktop CC pane. The general missing-slash-commands gap is tracked in #45399, but /mcp deserves a specific call-out because it's not just a convenience — it's the only recovery affordance.
  • Auto-reconnect is broken for stdio (#43177) and there's no reload-on-config-change anywhere (#40059), so even waiting it out doesn't help.
  • The current workaround is Cmd+Q + reopen Claude Desktop, which kills every session in the app, not just the broken one. Users with multiple Desktop CC sessions, or with Desktop sessions sharing context with mobile / Cowork, lose all of that to recover one stuck MCP.

Fix Action

Fix / Workaround

  • The CLI's /mcp slash command (which exposes per-server reconnect / status / OAuth re-auth) isn't reachable from the Desktop CC pane. The general missing-slash-commands gap is tracked in #45399, but /mcp deserves a specific call-out because it's not just a convenience — it's the only recovery affordance.
  • Auto-reconnect is broken for stdio (#43177) and there's no reload-on-config-change anywhere (#40059), so even waiting it out doesn't help.
  • The current workaround is Cmd+Q + reopen Claude Desktop, which kills every session in the app, not just the broken one. Users with multiple Desktop CC sessions, or with Desktop sessions sharing context with mobile / Cowork, lose all of that to recover one stuck MCP.
RAW_BUFFERClick to expand / collapse

Setup

Claude Code now runs embedded inside the new Claude Desktop. When an MCP server dies, hangs, or needs to pick up a config change, there is no in-session way to recover from the Desktop UI:

  • The CLI's /mcp slash command (which exposes per-server reconnect / status / OAuth re-auth) isn't reachable from the Desktop CC pane. The general missing-slash-commands gap is tracked in #45399, but /mcp deserves a specific call-out because it's not just a convenience — it's the only recovery affordance.
  • Auto-reconnect is broken for stdio (#43177) and there's no reload-on-config-change anywhere (#40059), so even waiting it out doesn't help.
  • The current workaround is Cmd+Q + reopen Claude Desktop, which kills every session in the app, not just the broken one. Users with multiple Desktop CC sessions, or with Desktop sessions sharing context with mobile / Cowork, lose all of that to recover one stuck MCP.

What I'm asking for

Any one of the following would close the gap. They're listed in increasing scope; even (1) alone would unblock most users:

  1. Expose /mcp (or an equivalent affordance) inside the Desktop CC pane. A right-click on a server name, a status-bar icon, a button in a settings drawer — anything clickable that triggers the same reconnect path the CLI's /mcp already supports.
  2. Auto-reconnect on idle-disconnect for stdio MCP servers in Desktop. The pattern reported repeatedly in #43177 (transport closed after ~60s idle, server process still healthy, next call hangs 4 min) is especially painful in Desktop because the Cmd+Q reset is so heavy. The one-line fix proposed in #43177 would carry over.
  3. A "Restart MCP servers" menu item in Desktop's app menu that re-reads .mcp.json / ~/.claude.json and reconnects without tearing down the rest of the app — essentially #40059's /mcp-reload but exposed as a Desktop UI action.

Bonus: surface a status indicator (green/red dot) per MCP server in the Desktop CC pane so users can see which one is broken without opening the CLI to find out.

Repro

  1. Open Claude Desktop with Claude Code integration enabled.
  2. Configure any stdio MCP server in .mcp.json or via claude mcp add.
  3. Use it for a few tool calls, then idle the chat for ~60+ seconds.
  4. Next tool call hangs, eventually fails with a transport error.
  5. There is no UI in Desktop to reconnect just that server. The only path back to a working MCP is Cmd+Q + reopen Claude Desktop, which terminates every other open session.

Same flow happens after editing .mcp.json to add a new server, or after an OAuth token expires (#43789) — none of these have a Desktop-side recovery affordance.

Environment

  • Claude Desktop with Claude Code integration (latest)
  • macOS (also reported on Windows in adjacent issues)
  • Multiple stdio MCP servers configured

Related issues

These are adjacent but none of them, alone or together, close the specific Desktop-UI gap:

  • #43177 — stdio MCP servers never auto-reconnect (root cause + 1-line fix identified)
  • #40059 — Allow reloading MCP servers without restarting the session (CLI-focused)
  • #45933 — Add McpReconnect tool so the model can reconnect failed MCP servers
  • #51561 — Bulk MCP server reconnection for multi-server disconnect scenarios
  • #42627 — Programmatic MCP server reconnection (disable/re-enable via hook or API)
  • #53125 — Remote Control: allow MCP server reload / process restart from a remote session
  • #53298 — Reconnect action unreachable for mcpServers entries added by direct ~/.claude.json edit
  • #43789 — MCP OAuth tokens expire frequently, requiring manual /mcp reconnect
  • #45399 — Desktop app missing slash commands available in CLI (general; this issue is the MCP-specific subset)
  • #46623 — HTTP OAuth MCP servers silently fail in Claude Code inside Claude Desktop (silent-failure adjacent)
  • #47538 — Local MCP tool calls approved but never forwarded to server (Desktop + Claude Code in Desktop)

Filing this separately because the Desktop-specific UI affordance for MCP reconnect is the missing piece across all of the above — fixing /mcp parity in Desktop, or adding any of the alternatives in "What I'm asking for," would benefit users regardless of which underlying disconnect cause they hit.

extent analysis

TL;DR

Exposing the /mcp command or an equivalent affordance inside the Desktop CC pane would provide a direct way to recover from MCP server issues without requiring a full app restart.

Guidance

  • To address the issue, consider implementing one of the proposed solutions: exposing /mcp in the Desktop CC pane, auto-reconnect on idle-disconnect for stdio MCP servers, or adding a "Restart MCP servers" menu item.
  • Verify the fix by reproducing the issue (following the steps in the "Repro" section) and checking if the newly added affordance allows for recovery without a full app restart.
  • Ensure that any solution does not introduce additional issues, such as data loss or session termination, and that it works across different environments (e.g., macOS, Windows) and configurations (e.g., multiple stdio MCP servers).
  • Consider adding a status indicator (green/red dot) per MCP server in the Desktop CC pane to provide users with a clear visual cue about server status.

Example

No specific code example is provided due to the lack of detailed implementation details in the issue description. However, the solution would likely involve modifying the Desktop CC pane's UI to include the requested affordance and implementing the necessary backend logic to handle reconnects or server restarts.

Notes

The issue highlights a specific gap in the Desktop UI for recovering from MCP server issues, which is not addressed by existing related issues. Any solution should prioritize minimizing disruption to user sessions and providing a seamless recovery experience.

Recommendation

Apply a workaround by exposing the /mcp command or an equivalent affordance inside the Desktop CC pane, as this would provide the most direct and user-friendly solution to the issue, allowing users to recover from MCP server issues without a full app restart.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [Feature] Reconnect/restart MCP servers from Claude Code in Claude Desktop without Cmd+Q (expose /mcp UI or auto-reconnect) [2 comments, 2 participants]