AgentHubAgentHub

使用指南·MCP

Qoder / 通义灵码 / Trae 配置 MCP 教程(国内 AI 编程工具图文步骤)

不用 Cursor 也能玩 MCP。本文分别给出 Qoder(IDE 与 CLI)、通义灵码、Trae 三个国内 AI 编程工具添加 MCP Server 的入口位置、配置 JSON 写法与生效方式,附三家对照表。

开始前的两个前提

  1. 装好环境:绝大多数 MCP 用 npx 或 uvx 启动,先看《MCP 环境准备教程》把 Node.js 装好;
  2. 拿到配置:在 AgentHub 打开目标 MCP 的详情页,复制它的 JSON 配置(mcpServers 那一段)。三家的 JSON 结构基本一致,差别只在从哪里进去配置。

三家工具都需要登录账号后才能使用智能体对话;MCP 工具调用一般要求处于智能体 / Agent 模式(纯问答模式不会调用工具)。

Qoder:IDE 面板与 CLI 两种方式

IDE(图形界面)

  1. 打开 Qoder 设置中的 MCP 面板
  2. 选择添加服务器,把详情页复制的 command / args / env 填入(或直接粘贴 JSON)
  3. 保存后在面板里查看连接状态,绿色 / Tools 数量 > 0 即成功

CLI(命令行,配置即文件)

Qoder CLI 的 MCP 写在 settings 文件里,全局与项目两个层级:

文件作用范围
~/.qoder/settings.json 的 mcpServers 节点全局,所有项目可用
<项目>/.qoder/settings.json仅当前项目
<项目>/.mcp.json(需顶层 mcpServers 键)仅当前项目,兼容通用格式

也可以不手改文件,直接敲命令:

qoder mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents/demo

验证与管理:在 Qoder 对话里输入 /mcp 查看在线服务器与健康状态;命令行用 qoder mcp list / qoder mcp remove <名称>。

传输类型上 Qoder 支持 stdio、sse、http、streamable-http、ws,远程托管的 MCP 也能接。

通义灵码:个人设置 → MCP 服务

通义灵码(VS Code / JetBrains 插件及独立 IDE 均可)的入口:

  1. 点击侧边栏灵码头像 → 个人设置
  2. 选择 MCP 服务 → 点击 添加
  3. 填入名称与启动命令(即详情页 JSON 里的 command + args,密钥放 env)
  4. 保存后回到对话,切到智能体模式并打开一个工程目录,工具才会被加载

要点:

  • 支持 STDIO(本地命令启动)与 SSE(远程服务 URL)两种类型
  • 本地类 MCP 依赖机器上的 Node.js v18+ 或 Python 环境——连不上先回环境教程自查
  • 添加高德地图、联网搜索这类需要 API Key 的服务时,Key 填在环境变量栏,不要写进对话

Trae:设置 → MCP,界面与 JSON 双通道

Trae(国际版与国内版均有 MCP 面板)的入口:

  1. 点击右上角头像 → 设置(或偏好设置)
  2. 选择 MCP 栏
  3. 两种加法任选:
    • UI 添加:点「添加 MCP Server」,按表单填名称、类型、命令
    • JSON 编辑:点「手动添加 / 编辑配置文件」,把 AgentHub 复制的整段 mcpServers 粘贴进去
  4. 保存后列表里出现该 Server,展开能看到工具清单即连接成功

配置作用域:全局配置对所有项目生效;在项目根目录放 .trae/mcp.json 则仅对该项目生效。本地服务用 command/args,远程 HTTP 服务直接填 url。之后在 Builder / 智能体对话里让 AI「用 xx 工具」即可触发。

三家对照速查表

Qoder通义灵码Trae
入口设置 MCP 面板 / qoder mcp add头像→个人设置→MCP 服务头像→设置→MCP
配置文件~/.qoder/settings.json、项目 .mcp.json面板内管理全局设置、项目 .trae/mcp.json
本地 stdio✅✅✅
远程 SSE/HTTP✅(含 streamable-http/ws)✅(SSE)✅(HTTP url)
生效模式智能体对话智能体模式 + 打开工程Builder / 智能体
验证方式对话内 /mcp面板连接状态面板工具清单

结构上你只需要记住一件事:三家的 JSON 都是 mcpServers → 名称 → command/args/env 这一套,在 AgentHub 复制配置时选对应 Tab(或通用 JSON),换个入口粘贴而已。

配置完不动、报错怎么办

按顺序自查:

  1. 终端里先跑通:把配置里的完整命令(去掉外层 JSON)直接粘到终端执行,能启动说明 MCP 本身没问题,问题在客户端配置
  2. 模式对不对:三家都必须处于智能体 / Agent 模式才会调用工具,纯聊天模式不会
  3. JSON 语法:多个 Server 时确认逗号齐全、没有多余括号
  4. 仍然连不上:查《MCP 连接失败排查指南》,覆盖 npx 超时、路径错误、权限弹窗等场景
Qoder / 通义灵码 / Trae 配置 MCP 教程(国内 AI 编程工具图文步骤) - AgentHub