MCP 连接不上，按进程、配置、认证、网络和权限排查

连接失败按层排，不反复重装

先看 Server 进程或远程端点是否可用，再查客户端是否读取正确配置，随后检查认证、工具发现、网络和目标资源权限。每一层都要有实际证据。

进程或服务

本地命令是否启动、退出码和 stderr；远程端点是否解析、连通和返回预期协议。

记录 Client、Server、配置位置、传输方式、认证范围、工具列表和一次真实调用结果。

配置

文件位置、语法、作用域、命令路径、参数和环境变量是否被当前客户端实际读取。

确认“配置”已经有可回查结果，再进入“认证”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

认证

Token 类型、过期、OAuth 回调、scope、用户和组织是否匹配目标资源。

确认“认证”已经有可回查结果，再进入“工具发现”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

工具发现

连接成功后是否列出能力，Server 是否声明工具，客户端是否支持并授权。

确认“工具发现”已经有可回查结果，再进入“调用与资源权限”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

调用与资源权限

使用最小参数调用，关联客户端与 Server 日志，确认失败来自工具、网络还是资源本身。

先用只读、小范围请求验证连接；涉及写入、删除、付款或外发时必须重新确认对象与权限。 完成后把证据归入“分层诊断报告”。

诊断报告只确认有证据的根因

记录环境、配置读取位置、日志、状态、已排除项、修复和复测。重新安装后偶然恢复但原因未知，只能写缓解。