Trae MCP 配置教程:手动添加远程服务器,读取推特数据
Trae 的 MCP 市场里找不到的服务器,可以手动贴一段 JSON 接入。本文讲 url 和 headers 的写法、40 个工具的上限,以及启动失败、缺少环境时怎么排查,附一次实测。
Tarun Khatri
发布于 · 更新于 · 阅读约 6 分钟
Trae 配置 MCP 有两条路:从内置的 MCP 市场添加,或者手动贴一段 JSON。
市场里没有的服务器,比如读取 X(推特)数据的 Weir,就用手动添加。Weir 只读,不会用你的账号发推。我们做的就是 Weir。
打开 Trae 的“设置 → MCP”,点“添加”→“手动添加”,粘贴这段,再换上你的 key:
{
"mcpServers": {
"weir": {
"url": "https://api.weirapp.io/mcp",
"headers": {
"Authorization": "Bearer weir_live_xxxxxxxx"
}
}
}
}
Trae MCP 配置:手动添加 Weir 的四步
Trae 从 2025 年 6 月 5 日的版本起支持 Streamable HTTP 和 header 字段。国际版是 v1.4.1,国内的 TRAE CN 是 v0.6.1。
我们没能在这里实际运行 Trae。下面的步骤来自 docs.trae.ai 上的中文文档,读取时最新的是 2026 年 10 月 15 日发布的 v3.6.4。
- 创建 key在 Weir 控制台的 API keys 页面新建。Sources 只勾 X,Monitors 和 Webhooks 选 No access。
- 打开 MCP 面板在 IDE 窗口或 Agent 窗口进入“设置 → MCP”,点“添加”→“手动添加”。
- 粘贴 JSON把上面的配置贴进“手动配置”窗口,换上你的 key,点“确认”。
- 交给智能体在输入框输入 @,选内置的 Agent,问它“我的 Weir 用量还剩多少?”
第 4 步会调用 get_usage,它不花积分,正好用来确认连通。
- Agent 窗口要先选运行环境。 本地任务和工作树任务用“本地”,云端任务用“云端”。
- 内置的 Agent 会自动拿到 Weir。 Trae 文档说,所有已配置的 MCP Server 都会加给它,不用的可以在编辑页关掉。
- 在别的 IDE 配过? 点“原始配置(JSON)”,把配置直接贴进 Trae 的 mcp.json。
- 只在一个项目里用? 先在“设置 → MCP”里打开“项目级 MCP”开关,再写项目根目录的 .trae/mcp.json。key 别写进会提交到 git 的文件。
请求头还是 OAuth:Trae 里怎么授权 Weir?
用请求头。Trae 文档里,远程服务器只有两个字段:必填的 url 和可选的 headers,示例写的正是 Authorization: Bearer。
Trae 的更新日志说,MCP Server 从 2026 年 4 月 14 日的版本起支持完整的 OAuth 授权流程。国际版是 v3.5.51,TRAE CN 是 v3.3.51。
Weir 支持动态客户端注册,也接受本机和桌面应用自己的回调地址。不过 Trae 怎么注册、回调到哪里,文档没写,我们也没测过。
还有一个更实际的原因:用 OAuth 登录时,Weir 会列出全部 45 个工具,超过了 Trae 的上限。
Trae 的 MCP 工具上限是多少?
40 个,算的是所有 MCP Server 加起来。Trae 的排错文档还写了另一条:所有 MCP Server 的描述信息,合计最多 8,000 个字符。
超过任何一条,Trae 会按工具丢掉放不下的描述,模型就看不到那些工具。
Weir 的 key 只列出它的权限允许的工具。Sources 只勾 X,12 个 Reddit 工具就不会出现;Monitors 和 Webhooks 选 No access,监控类工具也不会出现。剩下的是 25 个 X 工具,加上 get_usage 等 3 个免费的账户工具。
如果你还接了别的 MCP Server,总数照样可能超。这时到“设置 → 智能体”,点内置 Agent 的“查看详情”,只勾这次要用的 Weir 工具,比如 search_x、get_x_thread 和 get_usage。
想每次调用前先确认,就别打开“设置 → 对话流”里的“自动运行 MCP”。打开后,智能体调用 MCP 工具不再逐次确认,Weir 的付费调用也一样。
实测:让 Trae 的智能体查 Qwen 最近发了什么
在输入框里 @ 内置的 Agent,然后问:
用 Weir 查 @Alibaba_Qwen 最近 30 天在 X 上的推文,
跳过转推和回复,找出和编程或 Agent 有关的。
Agent 该调用的是 search_x。我们在 2026 年 10 月 24 日通过 Weir 的 MCP 服务器跑了这次调用:
→ search_x {"fromUsers": ["Alibaba_Qwen"], "query": "-filter:nativeretweets",
"since": "2026-09-24T00:00:00Z", "onlyOriginal": true, "limit": 3}
← 3 posts · 4 credits (1 + 3 × 1) · nextCursor set
2026-10-14 1,024 likes 社区把 Qwen3.8-Flash-Next 跑到每用户 685 token/s
2026-10-12 3,219 likes QwenGyre:给超长程 Agent 训练用的弹性强化学习
2026-10-09 5,317 likes Qwen-Image-2.1-Turbo,8 步出图,开放权重
三条里,只有 QwenGyre 和 Agent 直接相关。先拿 3 条看清方向,再决定要不要翻页。
onlyOriginal 去掉回复,-filter:nativeretweets 去掉转推。搜索条件怎么组合,可以先在推特高级搜索生成器里拼好。
Weir 每次调用收 1 积分,每条 X 推文再收 1 积分,失败的调用不收费。截至 2026 年 10 月,积分包 $5(美元)起,含 25,000 积分,永不过期。Trae 自己的套餐另算,Weir 的各项单价见价格页(英文)。
Trae MCP 启动失败或缺少环境怎么办?
先看日志:在 MCP Server 列表里点 Weir 右侧的齿轮,选“日志”。也可以按 Ctrl + Shift + U(macOS 是 Command + Shift + U)打开输出面板,在右上角选 MCP Server Host。
- 提示缺少 Node.js、npx 或 uvx。 这是本地 stdio 服务器要的环境,Trae 文档说标记为 Local 的服务器要先装 NPX 或 UVX。Weir 是远程地址,用不到它们。
- 报“您必须提供一个命令”。 用 npx 启动的服务器需要 Node.js 20 或更高版本,升级后重启 Trae。
- 智能体看不到 Weir 的工具。 多半是超了工具数或描述字数的上限。换只开 X 权限的 key,或者只勾要用的工具。
- 模型说读不全结果。 新开一个对话,把 limit 调小。
- 工具返回 401。 key 错了或过期了。检查值是不是
Bearer weir_live_...,中间只有一个空格。 - 工具返回 402。 Weir 积分用完了,重试没用。
什么时候不适合用 Weir
- 智能体要发推或私信。 Weir 只读,不能发推、点赞或关注。
- 你要读自己的私密数据。 Weir 只读公开推文,读不到书签、私信和首页时间线。
- 最在意单价。 截至 2026 年 10 月,TwitterAPI.io 标价每 1,000 条推文 $0.15,比我们 $5 积分包的单价低。
- 你需要稳定保证。 Weir 没有获得 X 授权,也和 X 没有关联,访问方式可能会变。
常见问题
Trae 的 MCP 市场里有 Weir 吗?
据我们所知没有,所以用手动添加。市场适合装社区里的热门服务器,Trae 文档《热门 MCP Server 详解》介绍了常用的 10 个,比如 Context7、GitHub 和 Playwright。它们管文档、代码和浏览器,读推特数据要靠 Weir 这类服务。
Trae 支持 SSE 和 Streamable HTTP 吗?
都支持。Trae 文档列出了三种传输方式:stdio、SSE 和 Streamable HTTP。Weir 只提供 Streamable HTTP,地址是 https://api.weirapp.io/mcp。
TRAE CN 和国际版的配置一样吗?
从更新日志看,两个版本的 MCP 功能是同步上线的:Streamable HTTP 和 header 字段同一天加入,OAuth 也是同一天加入。TRAE CN 的 MCP 概览页列出的传输方式也一样。本文步骤来自国际版的中文文档,国内版的界面我们没能核对。
Trae 能通过 Weir 发推吗?
不能。Weir 只读公开的 X 数据,不能发推、点赞或关注。要发推,得用持有你 X 账号权限的工具。
参考来源
以下均于 2026 年 10 月 24 日查阅:
- TRAE 文档,添加 MCP Server:https://docs.trae.ai/ide/add-mcp-servers?_lang=zh
- TRAE 文档,MCP 概览:https://docs.trae.ai/ide/model-context-protocol?_lang=zh
- TRAE 文档,在智能体中使用 MCP Server:https://docs.trae.ai/ide/use-mcp-servers-in-agents?_lang=zh
- TRAE 文档,内置智能体 Agent:https://docs.trae.ai/ide/built-in-agent?_lang=zh
- TRAE 文档,MCP Server 相关问题:https://docs.trae.ai/ide/troubleshoot-mcp-server-related-issues?_lang=zh
- TRAE 文档,查看 MCP Server 的日志:https://docs.trae.ai/ide/check-mcp-server-logs?_lang=zh
- TRAE 文档,自动运行 & 安全性:https://docs.trae.ai/ide/auto-run-and-security?_lang=zh
- TRAE 文档,热门 MCP Server 详解:https://docs.trae.ai/ide/01fzsij0?_lang=zh
- TRAE 更新日志,v1.4.1(2025 年 6 月 5 日)、v3.5.51(2026 年 4 月 14 日)、v3.6.1 ~ 3.6.4(2026 年 10 月 15 日):https://docs.trae.ai/ide/changelog?_lang=zh
- TRAE CN 更新日志,v0.6.1 与 v3.3.51(Wayback 存档,2026 年 6 月 13 日):https://web.archive.org/web/20260613083804/https://docs.trae.cn/ide_changelog
- TRAE CN 文档,MCP 概览(Wayback 存档,2026 年 5 月 19 日):https://web.archive.org/web/20260519131131/https://docs.trae.cn/ide/model-context-protocol
- TwitterAPI.io 价格页(英文):https://twitterapi.io/pricing
- Weir 文档,MCP、认证与计费(英文):https://docs.weirapp.io/mcp 、https://docs.weirapp.io/authentication 、https://docs.weirapp.io/billing
- Weir search_x 调用,2026 年 10 月 24 日(请求 e33af4e0-ffcc-4b3a-9f6f-7a92191d514f)