MCP 客户端接入

如何让 Chatbox 操作你的纯血鸿蒙手机(桌面与手机双端教程)

同时覆盖手机版 Chatbox(免电脑 HTTP MCP 直连)与桌面版 Chatbox(Work Mode 本地 STDIO)两种接法,教你快速连上 HarmonyOS NEXT 真机。

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

快速步骤概览

  1. 在手机装好小贝并开启系统无线调试;决定使用手机端免电脑直连还是电脑桌面版 Chatbox。
  2. 若用手机版 Chatbox,直接打开 https://mcp.aoqi360.com/autoclicker/mobile?client=chatbox 生成 4 位码授权并复制 JSON 导入。
  3. 若用桌面版 Chatbox,生成 chatbox 配置后在 MCP 设置里加入 STDIO 服务并在 Work Mode 开启 xiaobei-harmony。
  4. 在对话框发送检查连接请求并完成手机小贝「AI 连接」确认后即可开始操作手机。

Chatbox 既有电脑桌面端,也有手机端。小贝对这两端都做了专门配对流程:想出门免电脑直接操作,走 路线 A(手机端 HTTP MCP);平时固定在电脑上用,走 路线 B(桌面版 STDIO MCP)。

准备条件

  • 不管走哪条路线,鸿蒙手机都要先装好 小贝自动点击器、做好单机无线调试开启,且小贝已登录、会员有效。

路线 A:手机版 Chatbox(免电脑、免 Node.js 直连)

  1. 打开手机端配对页:在手机浏览器访问 https://mcp.aoqi360.com/autoclicker/mobile?client=chatbox(已经帮你自动选中 Chatbox)。
  2. 生成配对码:点击 「生成配对二维码」(先保留这个浏览器标签页不要关闭)。
  3. 在小贝确认授权:
    • 打开 小贝自动点击器 -> AI 连接。
    • 同一台手机:输入网页上的 4 位配对码;两台设备分开放(同 Wi-Fi):直接扫网页二维码。
    • 核对客户端名称 Chatbox,点 「允许连接」。
  4. 复制并导入 JSON:回到刚刚的浏览器标签页,点击 「复制 JSON」,打开手机版 Chatbox -> MCP 设置 粘贴导入即可。

路线 B:电脑桌面版 Chatbox(Work Mode 本地 STDIO)

第一步:生成固定环境变量

确认电脑已经装好 Node.js(终端可用 npx),且电脑与手机连在同一个 Wi-Fi 下。在终端运行一次命令拿取配置与固定 UUID:

npx -y xiaobei-harmony-mcp config --client=chatbox

第二步:在 Chatbox 桌面端添加 MCP 服务

  1. 打开桌面版 Chatbox 的 MCP 设置,新建一个 STDIO 本地服务,名称填 xiaobei-harmony:
    • 命令:npx(Windows 若不识别可改为 npx.cmd)
    • 参数:-y 和 xiaobei-harmony-mcp
    • 环境变量:
      • XIAOBEI_MCP_CLIENT_ID=chatbox
      • XIAOBEI_MCP_INSTANCE_ID=<填上面命令生成并固定保留的UUID>
      • XIAOBEI_MCP_APP_ID=autoclicker
      • XIAOBEI_MCP_HUB_URL=https://api.aoqi360.com
  2. 保存并开启该服务后,在 Chatbox 的 Work Mode 对话里把 xiaobei-harmony 工具开关打开(确认当前所选大模型支持工具调用)。

第三步:发起首次配对检查

在 Chatbox 发送:

用小贝检查一下手机连接。

电脑会弹出扫码页面,用手机上的 小贝 -> AI 连接 扫码或输入 4 位短码,点击 「允许连接」 即可。

日常切端与 IP 变动恢复

  • 手机版与桌面版 Chatbox 可以各自保留一份授权记录,以后在哪端用,在手机「AI 连接」切过去就能直接用。
  • 如果手机换了 Wi-Fi 路由器导致手机端直连配置的局域网 IP 变动,去 小贝 -> AI 连接 -> 管理 -> 复制连接配置 把最新 JSON 粘回手机版 Chatbox 即可,不需要重扫码。

相关常见问题

用手机版 Chatbox 还需要电脑吗?

不需要电脑,也不用装 Node.js。手机版 Chatbox 可以直接通过小贝的手机端 HTTP MCP 页面领 JSON 配置,同机用 4 位配对码确认就能直连。

桌面版 Chatbox 加好了 MCP,为什么普通聊天调不动小贝?

在桌面版 Chatbox 里,MCP 服务需要配合支持工具调用的会话模式(如 Work Mode)并在当前会话启用该 MCP 工具。如果遇到无法拉起,请检查本机 Node.js / npx 路径以及 Work Mode 工具勾选状态。