用途：诊断并修复Claude Code、Claude Desktop与MCP服务器之间的连接失败，适用于连接报错、MCP工具不出现、仅特定客户端失败、原本可用后中断、或在 Windows/WSL 新环境首次配置 MCP 等场景。输入需包含错误信息或症状、涉及哪个客户端、哪个 MCP 服务器，以及近期配置或环境变更。
主要流程：先定位客户端及其配置文件，Claude Code 可用 claude mcp list 与 claude mcp get server-name 查看，配置存于 ~/.claude.json；Claude Desktop 的配置文件为 claude_desktop_config.json。随后在客户端之外独立启动服务器验证，例如测试 R mcptools 或直接运行 mcp-remote。再按报错模式定位原因：Cannot attach the server 多与 Windows 参数解析有关，建议改用环境变量而非 --header，并确保 mcp-remote 全局安装；Connection refused 多为服务器未运行、端口错误、防火墙或传输类型不匹配；Command not found 多为缺少可执行文件完整路径或 PATH 未配置。若工具不出现但无报错，检查服务器启动时的初始化输出与协议版本。
必要检查：可用 curl 验证端点连通性与令牌有效性，用 python3 -m json.tool 校验配置 JSON 语法。平台差异上，Windows 路径中的空格会破坏命令执行，可用 8.3 短路径，环境变量比命令行头部参数更可靠；WSL 下 Unix 引号可用但需能从 /mnt/c/... 访问 Windows 可执行文件，NVM 环境需确保已加载。最后可通过 claude mcp remove 与 claude mcp add 重置服务器，并在修改配置后重启 Claude Desktop。
验证标准包括服务器可独立启动、配置 JSON 合法、客户端连接成功、工具出现在会话中并可执行且连接稳定。常见坑包括改错配置文件、修改后未重启、在受限环境依赖 npx、令牌过期以及客户端与服务器协议版本不兼容。该技能与 configure-mcp-server、build-custom-mcp-server、setup-wsl-dev-environment 相关。