Qoder CN 中文文档 下载 App

Qoder MCP 服务启动失败——STDIO、SSE、依赖排查

问题现象

在 Qoder CN 的 MCP 设置页面，某个 MCP 服务状态一直显示：

STDIO 类型排查

STDIO 是本地启动的进程，最常见的问题：

1. 运行时未安装

检查命令需要的 runtime 是否在系统里：

需要的命令需要的 runtime验证
npxNode.jsnode --version
python3 / pythonPythonpython3 --version
goGogo version

让 Agent 帮你验证：「检查本地有没有装 Node.js，版本是多少」。

2. 依赖未安装

STDIO MCP 服务需要先 npm install 或 pip install。Qoder CN 的「一键修复」会尝试安装，但失败了需要手动来：

  1. 在终端里进入 MCP 服务源码目录；
  2. 手动 npm install 或 pip install；
  3. 回到 Qoder CN 重新连接。

3. 命令写错

检查 JSON 配置里的 command 和 args：

// 正确
{ "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] }

// 错误：直接写 npx -y ... 不行，args 必须是数组
{ "command": "npx -y @modelcontextprotocol/server-github", "args": [] }

4. 环境变量未配置

某些 MCP 服务需要 API Key 才能启动：

{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "你的实际 token"
  }
}

env 字段必须填真实的值——不要保留占位符。

SSE / HTTP 类型排查

SSE 是远程托管的服务，主要排查方向：

1. URL 是否可访问

用浏览器打开 MCP 的 SSE URL：

2. 网络 / 代理

如果在中国大陆用海外 MCP 服务：

3. 服务端挂了

远程 MCP 服务可能暂时不可用：

工具调用超时

MCP 连接成功了，但调用某个工具时一直转圈然后超时：

1. 调大超时时间

进入 MCP 服务详情 → 下拉到「请求超时时长」；从默认值调到 60 秒或 120 秒。

2. 网络慢

远程 MCP 服务如果响应慢，调大超时就是解决办法。如果一直超时，考虑换国内的服务。

3. 工具本身执行慢

某些工具（如爬取大网页、复杂数据库查询）天生慢——这时候超时时长就是不够用，不是你的配置问题。

连接成功但 Agent 不会自动用

如果 MCP 服务正常、工具也加载了，但 Agent 执行任务时不调用：

可能原因解决
当前不是 Agent 模式切到 Agent 模式 / Quest 模式，Ask 模式不会调 MCP
任务描述没触发任务里明确提一下「用 GitHub MCP 查一下……」
工具名/描述不匹配让 Agent 列出当前可用的 MCP 工具，确认名称

Qoder CN 特定注意

注意原因
MCP 配置不跨设备同步每台设备的 MCP 配置要单独配
MCP 广场的服务可能不全Qoder CN 和国际版 MCP 广场的服务列表可能不同
自定义 JSON 格式要对JSON 写错一个逗号就整段失效

还不行

记录以下信息后提交反馈：

下一步