Trae MCP协议连接工具教程

要在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，说明服务端尚未注册该工具。

来源：互联网