Claude Code Remote MCP 断线后不重连怎么办

2.1.243 修复 -p 与 SDK 会话里远程 MCP 掉线永不恢复；现会自动重连或报失败。桌面 Invalid redirect URI 一并修了。

Claude Code Remote MCP 断线后不重连怎么办

claude code remote mcp 断线重连：2.1.243 之前，非交互（-p）和 SDK 会话里，远程 MCP 一旦掉线就不会再起来。Changelog 写现已自动重连，或明确报失败，不再静默死掉。同版本还修了桌面端发起的 MCP 登录：支持 client ID metadata 的服务器（举例 Linear）不再报 Invalid redirect URI。

作者：CodePass 技术编辑

最小对照

  1. 用 -p 或 SDK 跑依赖远程 HTTP MCP 的任务。
  2. 中途掐一下网络或让 MCP 服务重启。
  3. 旧版本：后续工具调用一直空、也不报「MCP 已死」。
  4. 2.1.243+：应看到重连，或失败状态，而不是假成功。

交互式终端里你还能手动 /mcp 重连；流水线没有人点，所以这修对 CI 更要紧。

和传输类型的关系

远程 MCP 一般是 HTTP。stdio 是本地进程，掉的是子进程不是「远程连接」。云端 Cursor Agent 更推荐 HTTP，凭证不进 VM，见 Cloud MCP HTTP vs stdio。Claude Code 这边 SSE / 旧桥接是否还接，看你安装版本的 MCP 文档。243 点名修好的是 remote MCP servers。

桌面 Invalid redirect URI：OAuth 回调地址和服务器登记的不一致。升级后仍失败，去 MCP 服务器控制台核对 redirect，不要只重装客户端。

升级后仍失败

  • /mcp 看服务器是 failed 还是未配置。
  • /status 的 Skipped sources：托管配置没生效。
  • 公司代理对长连接下手，重连也会被复位。把 MCP 域名加入代理白名单。
  • --strict-mcp-config 会话不应再为「根本不会加载的 .mcp.json」弹批准框；243 之后若干补丁还在修后台会话卡在启动批准上。先升到 2.1.245+。

工具调用被进来的消息打断时，旧逻辑可能对模型谎称「已完成无输出」。更新后的 headless/remote 会报 interrupted。排障时看的是错误类型，不是「没输出就当成功」。

参考资料