MCP 服务器连不上：Connection closed / MCP error -32000

现象

• 客户端显示 “Connection closed”、“MCP error -32000” 或服务器状态为 failed
• 工具列表为空，日志里只有一行启动命令

常见原因

• 启动命令在客户端的环境里找不到（图形界面应用的 PATH 和终端不同，npx、uvx 找不到）
• stdio 传输模式下，服务器把日志写到了 stdout，破坏了 JSON-RPC 消息
• 缺少必需的环境变量（API key 等），服务器启动即退出
• Windows 上直接调用 npx 失败，需要通过 cmd /c 启动

解决步骤

1. 先在终端里手动运行配置里的完整命令，确认它能启动且不报错
2. 用 MCP Inspector 单独测试服务器：npx @modelcontextprotocol/inspector <你的启动命令>，看能否列出工具
3. 在配置里把 command 写成绝对路径（如 which npx 的结果），并在 env 里显式传入需要的变量
4. 检查服务器代码：stdio 模式下日志只能写到 stderr
5. 查看客户端自己的 MCP 日志（各客户端位置不同，见其文档），根据第一条报错定位

注意

• 不要为了排错把密钥贴到公开 issue 里