想要在Trae中接入外部工具、充分发挥AI能力,最关键的步骤就是通过MCP协议建立连接。简单来说,你需要启用MCP插件、正确配置SSE或Streamable HTTP服务器、验证tools/list响应,最后执行tools/call调用。下面为你详细拆解操作流程。

如果你发现Trae里的模型无法直接访问数据库、文件或外部API,很可能是因为缺少标准化的连接协议。MCP(Model Context Protocol)正是为此设计的通用接口标准,它让Trae能够通过统一的方式调用各类工具服务。接下来,我们逐步讲解具体实现方法。
一、确认Trae对MCP的支持状态
Trae必须具备MCP客户端能力,才能发起tools/call这类标准请求。当前版本默认不内置MCP支持,必须通过插件或配置手动启用。如果不激活此功能,后续所有步骤都无法进行。
1. 打开Trae设置界面,进入“扩展”或“插件管理”页面。
2. 搜索关键词MCP,查看是否有官方或社区提供的MCP连接插件。
3. 若找到对应插件,安装并重启Trae;如果搜不到,则建议更换一个支持MCP的替代客户端,或等待Trae后续版本更新。
二、配置SSE类型MCP服务器连接
SSE(Server-Sent Events)是Trae常用的MCP传输方式,适用于远程工具服务端持续推送响应的场景。使用前提是服务端已经部署并暴露了/sse端点。
1. 获取目标MCP服务器的SSE地址,格式通常为http://host:port/mcp/sse。
2. 在Trae的MCP工具配置界面,点击“添加新服务器”,选择类型为SSE。
3. 粘贴完整URL,并在高级设置中填写认证头信息,例如Authorization: Bearer xxx。
4. 保存后观察连接图标:绿色表示成功,红色则需要检查网络可达性以及服务端是否正常运行。
三、配置Streamable HTTP类型MCP服务器连接
Streamable HTTP是Copilot Studio等平台已经强制采用的方式——从2025年8月起SSE已被废弃。如果Trae基于较新内核构建,这是唯一兼容的选择。
1. 确认MCP服务端已启用HTTP传输模式,并开放/messages/或类似的REST端点。
2. 在Trae里新建MCP服务器条目,选择类型为Streamable HTTP。
3. 填写URL,确保Accept头中包含application/json,并禁用text/event-stream。
4. 在请求体中构造合法的JSON-RPC initialize请求,protocolVersion字段必须匹配服务端要求,例如2025-03-26。
四、验证工具列表与调用权限
连接完成后,Trae需要主动请求tools/list才能获取可用工具的元数据。如果返回空或报错,说明服务端未正确暴露工具,或者客户端尚未完成initialized通知。
1. 手动触发一次工具发现操作,或等待Trae自动发送tools/list请求。
2. 检查响应内容中是否包含非空的tools数组,每个tool对象必须包含name、description和parameters定义。
3. 如果响应里缺少queryCollection、get_weather_by_city等你预期会出现的工具名,就需要到服务端代码中检查是否遗漏了@Tool注解或server.tool()注册。
五、测试具体工具调用流程
真实的调用需要经历完整的MCP四阶段交互:建立连接 → initialize → initialized → tools/call。任何一个环节中断,工具都无法正常使用。
1. 在Trae里输入一句明确的自然语言指令,例如“查北京今天的天气”。
2. 观察Trae日志或调试面板,确认是否发出了tools/call请求,并且method字段是否为tools/call。
3. 检查请求params中是否包含合法参数对象,比如{"city": "北京"},且参数名必须与tools/list返回的定义严格一致。
4. 等待响应返回result字段。如果看到error.code为-32601,说明服务端尚未注册该工具。
