Skip to content

/mcp reconnect all:一次重连所有挂掉的 MCP ​

开了好几个 MCP 之后,最烦的不是「没有工具」,而是一半连着、一半红着:OAuth 过期、进程挂了、笔记本休眠后套接字死掉。CLI 2.1.284 在交互式终端加了 /mcp reconnect all:对连接失败或需要重新认证的 MCP 服务器,一次性全部重试。

作用域、项目批准怎么批,仍看 MCP 作用域;本文只讲「已经配好、现在挂了」时怎么一把捞回来。

命令做什么 ​

在交互终端输入:

text
/mcp reconnect all

行为要点:

点说明
范围失败连接与需要认证的服务器,一批重试
入口交互式终端(changelog 明确写在 interactive terminal)
目标少点「逐个 reconnect / 重新登录」,把舰队拉回可用

它不会替你改 .mcp.json 作用域,也不会绕过「项目服务器要人工批准」这类策略——连不上若是因为从未批准 / 被托管禁用,应先回到配置与批准流程。

什么时候该用 ​

优先场景:

  1. 认证过期:早上一开,多个 OAuth / 登录态 MCP 一起红。
  2. 续跑 / resume 之后:会话恢复了,但若干 MCP 进程还没起来或半连着。
  3. 休眠、切网络、代理闪断:本地 stdio 服务或远程 MCP 成片掉线。
  4. 刚改完密钥或重启了某台 MCP 宿主:不想在 UI 里点十次。

不太适合当第一反应:

  • 单个服务器配置写错(命令、路径、env)——应先修配置再连。
  • 托管策略禁止该 MCP——reconnect 解决不了策略拒绝。

同版本:续跑时工具先等 10 秒 ​

2.1.284 还修了一类续跑痛点:恢复会话后立刻调 MCP 工具,若服务器仍在连接中,以前容易直接报 「No such tool available」。现在会最多等待约 10 秒让服务器连上,再决定工具是否可用。

和 /mcp reconnect all 的配合:

  • 刚 resume、工具偶发「还没有」:可先等一轮(最多约 10s)或再试一次调用。
  • 多台明确失败 / 要重新登录:用 /mcp reconnect all 主动拉起,而不是干等。

非交互首轮若靠 --allowedTools 或 mcp_tool 钩子点名了某 MCP,同版本也调整了启动等待逻辑;日常交互排障仍以 /mcp 与 reconnect 为主。

落地检查清单 ​

  1. claude --version ≥ 2.1.284。
  2. /mcp 看哪些 failed / needs auth。
  3. 执行 /mcp reconnect all,按提示完成需要交互的认证。
  4. 仍红的单独打开该服务器日志:配置错误与策略拒绝不会被「全部重连」修好。
  5. 新项目先确认 local / project / user 作用域 与批准状态,再谈重连。

小结 ​

  • 2.1.284:交互终端 /mcp reconnect all —— 批量重试失败或需认证的 MCP。
  • 适合认证过期、续跑后成片掉线;不适合替代修配置或绕过批准。
  • 续跑时 MCP 工具调用会最多等约 10 秒连服务器,减少误报「No such tool available」。

工具在,链路也要在。挂了一片时,先一把 reconnect,再逐个抠配置。

Claude-cn.org,专注于 Claude Code 中文教程