MCP 配置格式错误：服务起不来
Claude Code / Cursor 的 MCP 配置文件写错导致加载失败。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
mcp配置
30 秒结论
mcpServers 的结构固定：command + args 数组，少一个字段就起不来。
报错原文对照
Invalid MCP configuration
MCP server failed to load原因排序
| 概率 | 原因 |
|---|---|
| 50% | JSON 结构错 |
| 30% | command 路径不存在 |
| 20% | args 类型错（应该是数组） |
修法
先在自己这边查
- 对照官方示例改 JSON
- command 用绝对路径或确保在 PATH
- args 必须是数组
再往服务方查
这一项不是你这边能解决的。
责任判定表
| 现象 | 责任方 |
|---|---|
| 所有 server 都不加载 | JSON 语法 |
| 只有某个不加载 | 该条配置 |
| 启动后退出 | command |
什么时候该换
JSON 里一个多余逗号就会整段失效，用编辑器校验。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证