如何让 TRAE 操作你的纯血鸿蒙手机(MCP 接入教程)
介绍如何将 TRAE(包含国内版 TRAE CN)通过 xiaobei-harmony-mcp 无线连接纯血鸿蒙真机,直接在编辑器里看手机页面与自动测试交互。
快速步骤概览
- 确认电脑已安装 Node.js(可用 npx),鸿蒙手机已完成小贝单机无线调试并与电脑在同一 Wi-Fi。
- 打开 TRAE 发送自动配置口令,或在 TRAE MCP 设置里填入 XIAOBEI_MCP_CLIENT_ID 为 trae-cn 的本地服务。
- 发送「用小贝检查一下手机连接」拿到二维码或 4 位短码,在手机小贝「AI 连接」确认授权。
如果你日常在电脑上用 TRAE(或国内版 TRAE CN) 开发、测试鸿蒙应用或写自动化工作流,连上小贝 MCP 后,TRAE 就能在同一个局域网里直接读取纯血鸿蒙真机界面并替你点击操作。
准备条件
- 手机装好 小贝自动点击器,完成单机无线调试配对且账号会员处于有效状态。
- 电脑(Mac 或 Windows)已安装 Node.js(终端可用
npx),与手机连着同一个 Wi-Fi。
方法一:直接对 TRAE 说一句话完成配置
打开 https://mcp.aoqi360.com/?client=trae-cn#connect,或把下面这句话直接发进 TRAE 的 AI 对话框:
请阅读小贝接入教程:https://mcp.aoqi360.com/autoclicker/llms.txt,帮我在 "TRAE" 中连接小贝。
TRAE 会按官方文档说明的入口为你写入 xiaobei-harmony MCP 配置。如果当前环境无法自动改设置,它会把准备好的配置字段列出来供你粘贴。
方法二:在 TRAE MCP 设置里手动添加
- 先在电脑终端跑一条命令生成一个专属配置文件片段与
XIAOBEI_MCP_INSTANCE_ID:
npx -y xiaobei-harmony-mcp config --client=trae-cn
(若使用国际版且想直接写入用户目录 .trae/mcp.json,也可运行 npx -y xiaobei-harmony-mcp init --client=trae。)
- 打开 TRAE 设置 -> MCP -> 手动添加 / JSON 配置,填入以下结构(注意把
XIAOBEI_MCP_INSTANCE_ID换成上一步生成的 UUID 并长期固定保留):
{
"mcpServers": {
"xiaobei-harmony": {
"command": "npx",
"args": ["-y", "xiaobei-harmony-mcp"],
"env": {
"XIAOBEI_MCP_CLIENT_ID": "trae-cn",
"XIAOBEI_MCP_INSTANCE_ID": "替换为上一步生成的UUID",
"XIAOBEI_MCP_APP_ID": "autoclicker",
"XIAOBEI_MCP_HUB_URL": "https://api.aoqi360.com"
}
}
}
}
Windows 如果遇到找不到
npx,把"npx"改成"npx.cmd"。
手机扫码连接与测试
- 确认 TRAE 里
xiaobei-harmony服务已开启后,在对话里发送:
用小贝检查一下手机连接。
- 浏览器会打开扫码页面(同时显示 4 位短码,10 分钟有效)。
- 打开手机端 小贝自动点击器 -> AI 连接,扫码或填短码,核对
TRAE名称后点击 「允许连接」。 - 回到 TRAE,你就可以让它查看当前真机界面结构、截屏确认报错位置,或依次执行点击、滑动和文本输入验证。
切换与安全提示
- 手机小贝「AI 连接」页面会记住所有曾经授权过的客户端(比如 Cursor、TRAE、CubeAgent),随时都能切过去或一键关掉授权开关。
- 手机页面画面和点击动作只通过你本机的无线局域网点对点发送,云端配对服务不接收手机截图。
相关常见问题
国内版 TRAE CN 和国际版 TRAE 的 client_id 有区别吗?
国内版 TRAE 对应 XIAOBEI_MCP_CLIENT_ID = "trae-cn";国际版用 "trae"。如果直接从 mcp.aoqi360.com 选 TRAE 让它自动配,默认会帮你选好合适的配置;已有配置想复用则直接保留旧 ID 即可。
怎么判断 TRAE 已经顺利加载小贝 MCP?
在 TRAE 的 MCP 服务列表里可以看到 xiaobei-harmony 状态为开启,对话框里问它「用小贝检查一下手机连接」时,它会直接调用状态检查工具并弹出扫码链接。