/mcp
管理 MCP 服务器连接和 OAuth 身份验证。
不带参数时会打开一个交互式列表,列出所有已配置的 MCP 服务器及其连接状态和各自的工具数量。在这里还可以为某个服务器启动或重新进行 OAuth 登录(Re-authenticate),例如当某次调用因为 401 Unauthorized 或 403 Forbidden 失败、服务器因此被标记为需要登录时。
带参数时,该命令可以针对单个服务器进行操作:/mcp reconnect <server> 会重新建立与某个已断开服务器的连接;/mcp enable/disable <server>(或 all)用来启用或禁用服务器,而不会删除其配置——被禁用的服务器仍会显示在列表中,只是标记为已禁用。对于 HTTP 或 SSE 服务器,Claude Code 会先自动尝试重新建立中断的连接(最多五次,等待时间逐次增加),只有在此之后才需要通过 /mcp 手动干预。
从版本 2.1.205 开始也支持非交互式(-p)使用;不带参数时,该命令会输出服务器状态的文字摘要,而不是交互式列表。新增服务器不是在这里完成的,而是通过 claude mcp add 来设置。
✅ 什么时候用?
修复某个 MCP 服务器的连接状态
某个 MCP 服务器不再响应 → 执行 /mcp reconnect <server> 重新建立连接。
有针对性地禁用单个 MCP 服务器
使用 /mcp disable <server> 临时关闭一个不常用的服务器,同时不丢失它的配置。
为某个服务器重新进行 OAuth 登录
如果 /mcp 在出现 401 错误后将某个服务器显示为需要登录,就在该服务器的菜单中选择 'Re-authenticate'。
⛔ 什么时候不该用?
首次设置一个新的 MCP 服务器
/mcp 只管理已有的连接(reconnect、enable、disable)和 OAuth 认证,不会创建新的服务器配置。
更好的选择: 先用 claude mcp add 添加服务器,之后再用 /mcp 进行管理。
在脚本中自动化读取服务器状态
交互模式下 /mcp 会打开一个选择对话框,不适合自动化检查。
更好的选择: 使用 -p 以非交互方式运行 /mcp(v2.1.205 起支持)获取文字摘要,或者用 claude mcp list 查看配置列表。
来源
- Claude Code 文档(官方) ↗ code.claude.com