MCP 配置格式错误:服务起不来
MCP常见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 里一个多余逗号就会整段失效,用编辑器校验。
还是没解决?把报错贴进来
新用户福利:先免费试,再决定充值
注册就送积分,可兑换 API 额度。拿真实请求验证本页结论,比看十篇教程都有用。
领免费额度