- 装好环境：绝大多数 MCP 用
npx或uvx启动，先看《MCP 环境准备教程》把 Node.js 装好； - 拿到配置：在 AgentHub 打开目标 MCP 的详情页，复制它的 JSON 配置（
mcpServers那一段）。三家的 JSON 结构基本一致，差别只在从哪里进去配置。
三家工具都需要登录账号后才能使用智能体对话；MCP 工具调用一般要求处于智能体 / Agent 模式（纯问答模式不会调用工具）。
使用指南·MCP
Qoder / 通义灵码 / Trae 配置 MCP 教程（国内 AI 编程工具图文步骤）
不用 Cursor 也能玩 MCP。本文分别给出 Qoder（IDE 与 CLI）、通义灵码、Trae 三个国内 AI 编程工具添加 MCP Server 的入口位置、配置 JSON 写法与生效方式，附三家对照表。
开始前的两个前提
Qoder：IDE 面板与 CLI 两种方式
IDE（图形界面）
- 打开 Qoder 设置中的 MCP 面板
- 选择添加服务器，把详情页复制的
command/args/env填入（或直接粘贴 JSON） - 保存后在面板里查看连接状态，绿色 / 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 均可）的入口：
- 点击侧边栏灵码头像 → 个人设置
- 选择 MCP 服务 → 点击 添加
- 填入名称与启动命令（即详情页 JSON 里的
command+args，密钥放env） - 保存后回到对话，切到智能体模式并打开一个工程目录，工具才会被加载
要点：
- 支持 STDIO（本地命令启动）与 SSE（远程服务 URL）两种类型
- 本地类 MCP 依赖机器上的 Node.js v18+ 或 Python 环境——连不上先回环境教程自查
- 添加高德地图、联网搜索这类需要 API Key 的服务时，Key 填在环境变量栏，不要写进对话
Trae：设置 → MCP，界面与 JSON 双通道
Trae（国际版与国内版均有 MCP 面板）的入口：
- 点击右上角头像 → 设置（或偏好设置）
- 选择 MCP 栏
- 两种加法任选：
- UI 添加：点「添加 MCP Server」，按表单填名称、类型、命令
- JSON 编辑：点「手动添加 / 编辑配置文件」，把 AgentHub 复制的整段
mcpServers粘贴进去
- 保存后列表里出现该 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），换个入口粘贴而已。
配置完不动、报错怎么办
按顺序自查：
- 终端里先跑通：把配置里的完整命令（去掉外层 JSON）直接粘到终端执行，能启动说明 MCP 本身没问题，问题在客户端配置
- 模式对不对：三家都必须处于智能体 / Agent 模式才会调用工具，纯聊天模式不会
- JSON 语法：多个 Server 时确认逗号齐全、没有多余括号
- 仍然连不上：查《MCP 连接失败排查指南》，覆盖 npx 超时、路径错误、权限弹窗等场景