如何让 Qoder 操作你的纯血鸿蒙手机(MCP 接入教程)
覆盖国内版 Qoder CN(client_id lingma)与国际版 Qoder 的小贝 MCP 接入方法,让你用 Qoder 直接看纯血鸿蒙真机屏幕并测试点击滑动。
快速步骤概览
- 确认电脑已经装好 Node.js(可用 npx),鸿蒙手机装好小贝并开启系统无线调试。
- 在 Qoder 对话中发送一键配对口令,或者在 Qoder 的 MCP 设置中添加 xiaobei-harmony 服务配置。
- 发送「用小贝检查一下手机连接」,通过小贝扫码或 4 位短码点允许后即可操控真机。
在电脑上使用 Qoder CN(或国际版 Qoder)开发鸿蒙应用或调试自动化步骤时,接入 xiaobei-harmony-mcp 就能在同一 Wi-Fi 下直接操作你手边的纯血鸿蒙真机。
准备条件
- 手机装好 小贝自动点击器,完成单机无线调试配对且账号会员处于有效状态。
- 电脑(Mac 或 Windows)装有 Node.js(终端可用
npx -v),且和手机处于 同一 Wi-Fi 局域网。
方法一:发一句话让 Qoder 自动配置
打开 https://mcp.aoqi360.com/?client=lingma#connect,或者把下面这句话直接发给 Qoder CN:
请阅读小贝接入教程:https://mcp.aoqi360.com/autoclicker/llms.txt,帮我在 "Qoder CN" 中连接小贝。
(如果你使用的是国际版 Qoder,把引号里的 "Qoder CN" 改成 "Qoder" 再发送即可。)
方法二:生成配置手动添加到 Qoder MCP 设置
- 根据版本运行对应的配置命令,获取带固定 UUID 的片段:
# 国内版 Qoder CN
npx -y xiaobei-harmony-mcp config --client=lingma
# 国际版 Qoder
npx -y xiaobei-harmony-mcp config --client=qoder
- 打开 Qoder -> MCP 服务设置,添加一个 STDIO 服务
xiaobei-harmony(下例以国内版lingma演示,注意固定保留生成的 UUID):
{
"mcpServers": {
"xiaobei-harmony": {
"command": "npx",
"args": ["-y", "xiaobei-harmony-mcp"],
"env": {
"XIAOBEI_MCP_CLIENT_ID": "lingma",
"XIAOBEI_MCP_INSTANCE_ID": "替换为命令行生成的UUID",
"XIAOBEI_MCP_APP_ID": "autoclicker",
"XIAOBEI_MCP_HUB_URL": "https://api.aoqi360.com"
}
}
}
}
Windows 上如果出现
npx无法启动,把"npx"改成"npx.cmd"。
扫码确认与验证操作
- 在 Qoder MCP 面板确认
xiaobei-harmony处于开启状态后,在聊天区发送:
用小贝检查一下手机连接。
- 浏览器弹出配对二维码与 4 位短码后,拿起手机进入 小贝 -> AI 连接,扫码或填短码,核对客户端名称无误后点 「允许连接」。
- 接下来你就可以直接在 Qoder 里让它检查真机页面元素、截取画面、点击指定按钮或执行多步连点验证了。
安全与多客户端管理
- 小贝「AI 连接」页面可以同时保存多个桌面/手机端授权记录,随时手动切换当前接管的客户端。
- 手机画面与点击指令只经过你自己的 Wi-Fi 局域网点对点发送,随时可以通过悬浮小窗或实况通知栏暂停和结束任务。
相关常见问题
国内版 Qoder CN 和国际版 Qoder 配置里的 ID 一样吗?
不一样。国内版 Qoder CN 对应 XIAOBEI_MCP_CLIENT_ID = "lingma",国际版 Qoder 对应 XIAOBEI_MCP_CLIENT_ID = "qoder"。如果原本已经有配置能正常运行,沿用原有 ID 即可,不必特意去改。
写好配置之后 Qoder 对话里还是看不到手机工具怎么办?
先在 Qoder 的 MCP 服务设置页点一下刷新/重载,确认 xiaobei-harmony 启动成功;然后发一句「用小贝检查一下手机连接」触发初次工具加载即可。