MCP / 配置

修复 Claude Code 报错

报错原文

MCP server failed to connect or authenticate

含义 / 原因

某个 MCP server 没能加载/连接/认证。这类问题归在 MCP 与配置调试范畴,而非 Claude API 报错;设置没生效、hook 没触发、MCP server 没加载也都属于配置层。

修复步骤

1在 Claude Code 里跑 /doctor 一次性自检安装、设置、MCP server 配置与上下文用量;若 claude 根本起不来,在 shell 里跑 claude doctor。
2跑 /mcp 查看/管理 MCP server 状态;没在用的用 /mcp disable <name> 关掉以释放上下文。
3排查配置问题(设置未生效 / MCP 未加载)参见官方 Debug your configuration;用 claude --safe-mode 起一个禁用全部定制的会话定位是哪个插件/MCP/hook 的锅。