MCP 客户端接入

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

教你把腾讯 CodeBuddy 研发助手接到 HarmonyOS NEXT 真机上,通过局域网 MCP 直接看手机界面、找控件并执行点按滑动验证。

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

快速步骤概览

  1. 确认电脑已安装 Node.js(可用 npx),鸿蒙手机完成小贝无线调试并连入同一 Wi-Fi。
  2. 在 CodeBuddy 里发送自动接入指令,或在 CodeBuddy 的 MCP 设置里手动粘入 codebuddy 对应的 JSON 配置。
  3. 发送「用小贝检查一下手机连接」拉起配对二维码,并在手机小贝「AI 连接」点击允许连接。

用 CodeBuddy 写代码或排查界面问题时,把小贝的 xiaobei-harmony-mcp 接进 CodeBuddy 之后,就能在同一局域网下直接查看 HarmonyOS NEXT 手机画面、核对界面控件,甚至直接帮着把回归操作走一遍。

准备条件

  1. 手机已经装好 小贝自动点击器 并完成单机无线调试开启,账号处于登录且会员有效状态。
  2. 电脑(Mac 或 Windows)装好了 Node.js(确认终端可运行 npx -v),且和手机连在同一个 Wi-Fi 下。

方法一:发一句话让 CodeBuddy 自动接上

打开 https://mcp.aoqi360.com/?client=codebuddy#connect,或者把下面这段话直接发给 CodeBuddy:

请阅读小贝接入教程:https://mcp.aoqi360.com/autoclicker/llms.txt,帮我在 "CodeBuddy" 中连接小贝。

CodeBuddy 会按照自身的 MCP 配置格式替你把 xiaobei-harmony 服务添上(不会改动你原有的其他 MCP 工具)。如果环境受限无法自动写配置,它会给出完整字段供你手动导入。

方法二:生成凭证后手动贴进 CodeBuddy MCP 设置

  1. 在电脑终端运行下方命令,生成一份带着固定 XIAOBEI_MCP_INSTANCE_ID 的 codebuddy 配置:
npx -y xiaobei-harmony-mcp config --client=codebuddy
  1. 打开 CodeBuddy 的 MCP 配置面板,添加本地 STDIO 服务 xiaobei-harmony,参数与环境变量核对如下:
{
  "mcpServers": {
    "xiaobei-harmony": {
      "command": "npx",
      "args": ["-y", "xiaobei-harmony-mcp"],
      "env": {
        "XIAOBEI_MCP_CLIENT_ID": "codebuddy",
        "XIAOBEI_MCP_INSTANCE_ID": "替换为命令行生成的UUID",
        "XIAOBEI_MCP_APP_ID": "autoclicker",
        "XIAOBEI_MCP_HUB_URL": "https://api.aoqi360.com"
      }
    }
  }
}

Windows 环境若直接写 npx 无法拉起,请改为 npx.cmd。每个客户端实例保存固定一个 UUID 即可,不要每次修改。

手机扫码允许连接

  1. 保存并确认 xiaobei-harmony MCP 已启用后,在 CodeBuddy 对话框发送:
用小贝检查一下手机连接。
  1. 此时会打开二维码配对页面(同时给出 4 位配对码,10 分钟有效)。
  2. 拿起鸿蒙手机进入 小贝 -> AI 连接,扫描二维码或输入 4 位短码,确认客户端显示为 CodeBuddy,点 「允许连接」。
  3. 授权完成之后,就能在 CodeBuddy 里让助手直接查看当前真机页面并按步骤验证交互。

断开与隐私边界

  • 所有手机截图、控件节点和点击轨迹只在你自己的 Wi-Fi 局域网中点对点收发,云端不会留存画面。
  • 运行途中可随时从悬浮小窗、实况通知栏暂停或结束,也能随时在小贝「AI 连接」页面关闭权限。

相关常见问题

CodeBuddy 配好以后,换一个代码项目还要重新扫码吗?

如果你是把 MCP 加在 CodeBuddy 的全局/用户级配置里,且一直保留着同一个 XIAOBEI_MCP_INSTANCE_ID,切换项目目录后不用重新扫码,可以直接继续用。

如果 CodeBuddy 已经配过但手机上当前启用的是 Cursor 怎么办?

当多个客户端都在同一台手机授权过时,只需在手机端「小贝 -> AI 连接」里把当前客户端切回 CodeBuddy 即可,切完在 CodeBuddy 里重新验证一次连接就能立即生效。