/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 作用域,也不会绕过「项目服务器要人工批准」这类策略——连不上若是因为从未批准 / 被托管禁用,应先回到配置与批准流程。
什么时候该用
优先场景:
- 认证过期:早上一开,多个 OAuth / 登录态 MCP 一起红。
- 续跑 / resume 之后:会话恢复了,但若干 MCP 进程还没起来或半连着。
- 休眠、切网络、代理闪断:本地 stdio 服务或远程 MCP 成片掉线。
- 刚改完密钥或重启了某台 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 为主。
落地检查清单
claude --version≥ 2.1.284。/mcp看哪些 failed / needs auth。- 执行
/mcp reconnect all,按提示完成需要交互的认证。 - 仍红的单独打开该服务器日志:配置错误与策略拒绝不会被「全部重连」修好。
- 新项目先确认 local / project / user 作用域 与批准状态,再谈重连。
小结
- 2.1.284:交互终端
/mcp reconnect all—— 批量重试失败或需认证的 MCP。 - 适合认证过期、续跑后成片掉线;不适合替代修配置或绕过批准。
- 续跑时 MCP 工具调用会最多等约 10 秒连服务器,减少误报「No such tool available」。
工具在,链路也要在。挂了一片时,先一把 reconnect,再逐个抠配置。