MCP 配置步骤——在 Qoder IDE 里接入 MCP 服务
打开 MCP 设置
- 在 Qoder IDE 右上角点击用户图标,或按
Ctrl + Shift + ,(Windows)/⌘ + Shift + ,(macOS)打开 Qoder IDE 设置。 - 在左侧导航窗格中点击 MCP。
MCP 设置页面有两个标签:我的服务(管理你已安装的服务)和 MCP 广场(浏览和安装公开服务)。
方式一:从 MCP 广场安装
最简单的方式,推荐初学者先用:
- 点击 MCP 广场 标签。
- 浏览可用服务列表,找到你要的(比如 GitHub、Notion、天气等)。
- 在目标服务上点击 安装。
需要注意
某些 MCP 服务需要额外的环境变量(如 API_KEY、ACCESS_TOKEN)才能运行,MCP 广场会提示你需要配置哪些。配置完成后,回到「我的服务」确认安装成功。
如果服务因缺少依赖启动失败,点击「一键修复」让 Qoder 帮你安装。仍不行再手动安装。
方式二:自己配置 MCP 服务
适合想用自己写的 MCP 服务或公开仓库里的服务:
STDIO 类型示例(本地 GitHub MCP)
- 「我的服务」页面点击右上角 + 添加。
- 在弹出的 JSON 文件中编辑:
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<你的 GitHub PAT>"
}
}
}
}
- 保存文件。新服务出现在列表中,状态显示为绿色已连接。
- 展开服务详情查看它提供了哪些工具(如 search_repositories、create_issue 等)。
SSE 类型示例(远程天气 MCP)
{
"mcpServers": {
"weather": {
"type": "sse",
"url": "https://your-weather-mcp.example.com/sse"
}
}
}
对于 Streamable HTTP,使用与 SSE 相同的 url 字段,Qoder 会自动识别。
配置项说明
| 字段 | 说明 | STDIO | SSE/HTTP |
|---|---|---|---|
command | 启动本地服务的命令 | ✅ | ❌ |
args | 命令参数数组 | ✅ | ❌ |
env | 环境变量(如 API Key) | ✅ | 可选 |
type | 传输类型 | 可省略(默认 STDIO) | 写 sse |
url | 远程服务端点 | ❌ | ✅ |
服务超时设置
每个 MCP 服务都可以单独设置 请求超时时长(Request Timeout):
- 进入服务详情;
- 在超时时长下拉框选择合适的值(比如 30 秒、60 秒、120 秒)。
超过超时时间的 MCP 调用会自动终止,并在会话中显示超时提示。
使用 MCP 工具
配置完服务后,在智能体模式中调用:
- 打开右侧会话面板,切换到 Agent 模式。
- 输入请求——Qoder 会自动匹配合适的 MCP 工具。比如:
- 「查看 GitHub 上有哪些 open pull requests」
- 「旧金山明天的天气怎么样」
- 调用 MCP 工具前,Qoder 会请求确认——按
Ctrl + Enter执行。 - 执行结果显示在对话中,Qoder 基于结果继续下一步。
故障排查
如果 MCP 服务启动失败:
- STDIO:检查本地环境是否装了对应的 runtime(Node.js / Python / Go);
- SSE:确认 URL 可访问、网络通畅;
- 环境变量:检查 API Key 是否正确填写;
- 依赖安装:某些 STDIO 服务需要先
npm install或pip install。
详见 MCP 常见问题。
下一步
- 想看实际能做什么 → MCP 实战场景
- 配好之后开始用 → 回到 右侧 Ask/Agent 会话