MCP 客户端接入

如何让 TRAE 操作你的纯血鸿蒙手机(MCP 接入教程)

介绍如何将 TRAE(包含国内版 TRAE CN)通过 xiaobei-harmony-mcp 无线连接纯血鸿蒙真机,直接在编辑器里看手机页面与自动测试交互。

兼容 HarmonyOS NEXT(API 24 及以上)更新日期:2026-11-14阅读时长:约 4 分钟

快速步骤概览

  1. 确认电脑已安装 Node.js(可用 npx),鸿蒙手机已完成小贝单机无线调试并与电脑在同一 Wi-Fi。
  2. 打开 TRAE 发送自动配置口令,或在 TRAE MCP 设置里填入 XIAOBEI_MCP_CLIENT_ID 为 trae-cn 的本地服务。
  3. 发送「用小贝检查一下手机连接」拿到二维码或 4 位短码,在手机小贝「AI 连接」确认授权。

如果你日常在电脑上用 TRAE(或国内版 TRAE CN) 开发、测试鸿蒙应用或写自动化工作流,连上小贝 MCP 后,TRAE 就能在同一个局域网里直接读取纯血鸿蒙真机界面并替你点击操作。

准备条件

  1. 手机装好 小贝自动点击器,完成单机无线调试配对且账号会员处于有效状态。
  2. 电脑(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 设置里手动添加

  1. 先在电脑终端跑一条命令生成一个专属配置文件片段与 XIAOBEI_MCP_INSTANCE_ID:
npx -y xiaobei-harmony-mcp config --client=trae-cn

(若使用国际版且想直接写入用户目录 .trae/mcp.json,也可运行 npx -y xiaobei-harmony-mcp init --client=trae。)

  1. 打开 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"。

手机扫码连接与测试

  1. 确认 TRAE 里 xiaobei-harmony 服务已开启后,在对话里发送:
用小贝检查一下手机连接。
  1. 浏览器会打开扫码页面(同时显示 4 位短码,10 分钟有效)。
  2. 打开手机端 小贝自动点击器 -> AI 连接,扫码或填短码,核对 TRAE 名称后点击 「允许连接」。
  3. 回到 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 状态为开启,对话框里问它「用小贝检查一下手机连接」时,它会直接调用状态检查工具并弹出扫码链接。