docai.cc

MCP 配置格式错误:服务起不来

MCP常见mcp配置

30 秒结论

mcpServers 的结构固定:command + args 数组,少一个字段就起不来。

报错原文对照

Invalid MCP configuration

MCP server failed to load

原因排序

概率 原因
50% JSON 结构错
30% command 路径不存在
20% args 类型错(应该是数组)

修法

先在自己这边查

  1. 对照官方示例改 JSON
  2. command 用绝对路径或确保在 PATH
  3. args 必须是数组

再往服务方查

这一项不是你这边能解决的。

责任判定表

现象 责任方
所有 server 都不加载 JSON 语法
只有某个不加载 该条配置
启动后退出 command

什么时候该换

JSON 里一个多余逗号就会整段失效,用编辑器校验。

还是没解决?把报错贴进来

纯本地判断,不上传你的报错内容。支持 400 / 401 / 403 / 404 / 413 / 429 / 500 / 502 / 503 / 504 / 529 及常见错误码文字。

新用户福利:先免费试,再决定充值

注册就送积分,可兑换 API 额度。拿真实请求验证本页结论,比看十篇教程都有用。

领免费额度