MCP server failed to connect：MCP 连接失败
Claude Code / Cursor 的 MCP 服务器连接失败排查：命令路径、权限、启动超时。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
mcp工具连接
30 秒结论
MCP 服务器进程没能启动或没响应。看具体是启动失败还是握手超时。
报错原文对照
MCP server 'xxx' failed to connect: spawn ENOENT原因排序
| 概率 | 原因 |
|---|---|
| 40% | 配置问题（Key / Base URL / 变量名） |
| 30% | 服务方状态（限流 / 过载 / 故障） |
| 20% | 请求内容（参数 / 结构 / 长度） |
| 10% | 网络链路（DNS / 代理 / 证书） |
修法
- 手动跑一遍 MCP 命令看报错
- 确认 npx/uvx 在 PATH 里
- 加大启动超时
责任判定表
| 现象 | 责任方 |
|---|---|
| 换请求内容仍然报 | 配置或服务方 |
| 换站点/换网络就好 | 那一侧的问题 |
| 只有特定条件触发 | 你的请求 |
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证