通用教程

Cursor

打开 Cursor Settings → MCP → Add new MCP server；类型选 stdio，名称填 autoace。把下面整段贴进去。

{
  "mcpServers": {
    "autoace": { "command": "autoace-cli", "args": [] }
  }
}

装完在 MCP 列表里 Disable → Enable（或重启 Cursor），然后新开对话。看到 pair_device 再开始。

Claude Code

在项目根目录执行下面这条命令（或编辑 .mcp.json）。用 /mcp 查看状态。

claude mcp add autoace -- autoace-cli

配置后新开对话。看到 pair_device 再开始。

claude mcp add autoace -- npx -y autoace-cli@latest

Codex

把下面这段追加到 ~/.codex/config.toml。

[mcp_servers.autoace]
command = "autoace-cli"

改完重启 Codex 并新开对话。看到 pair_device 再开始。

通用 MCP 客户端

任何支持 MCP 的客户端都可以用这个模板。已全局安装 autoace-cli 时，把 command 换成 autoace-cli 并去掉 args。

{
  "mcpServers": {
    "autoace": { "command": "npx", "args": ["-y", "autoace-cli@latest"] }
  }
}

装完重载或新开对话。看到 pair_device 再开始。

{
  "mcpServers": {
    "autoace": {
      "command": "autoace-cli",
      "args": [],
      "env": {
        "KUAIYOU_DEVICE_IP": "<DEVICE_IP:PORT>",
        "KUAIYOU_MCP_PAIRING_CODE": "<PAIRING_CODE>"
      }
    }
  }
}

第 1 步 · 配对

打开快游大师：设置 → 高级设置 → MCP 服务，开启后点「复制给 Agent」，把全文发给 AI。

第 2 步 · 看屏写技能

用自然语言说出目标。AI 会看当前屏幕再写技能；你不用手写 JSON，也不用记工具名。

第 3 步 · 手机确认

AI 校验通过后推到手机。弹出确认框时，点「确认/允许」。

第 4 步 · 看结果

技能在手机本地跑完，AI 把 log 发给你。没点中就到「常见问题」复制那句。

打开微信并等到首页

给 AI 的提示词

请先确认 autoace 已连接，然后 observe_screen 看当前屏幕。写一个技能：打开微信，等到首页出现（比如看到「发现」或「通讯录」标签）。先 validate_kuaiyou_skill 再 push_reactive_skill（run: true），跑完把 log 发我。

完成后：AI 看屏写技能并推送；手机弹出确认，跑完把 log 给你。

支付宝同理：把提示词里的「微信」换成「支付宝」；若弹出协议或青少年模式，先关掉再等首页。

注意：图标和文案以当前屏幕为准，不要猜控件 ID。不确定首页长什么样时，先手动打开一次微信。

关掉更新 / 青少年模式等弹窗

给 AI 的提示词

observe_screen 看现在的弹窗。写一个技能：出现这类弹窗时点掉（比如「以后再说」「暂不升级」「取消」「知道了」），最多处理 3 次，处理完停止并把界面描述发我。validate 后 push（run: true）。

完成后：最多处理 3 次，处理完停止，AI 把当时界面描述发你。

注意：只按当前屏幕看到的真实文案写；不用固定坐标；处理完必须停，不要循环点。

屏幕出现「签到」点一次就结束

给 AI 的提示词

observe_screen 看当前屏幕。写一个技能：当「签到」文本出现时点它一次，点完就结束，不做其他动作。validate 后 push（run: true）。

完成后：点一次就结束，不会循环签到。

注意：一次即止（maxExecutions 1）；拒绝「连续签到」类无限循环需求。

冒烟：打开设置，确认「关于手机」

给 AI 的提示词

做个冒烟：打开「设置」页，确认页面上出现「关于手机」。observe_screen 对着当前屏幕写选择器，validate 后 push（run: true），跑完告诉我是否通过。

完成后：跑完 AI 根据 log 告诉你是否通过。

注意：断言用文本不用坐标；一次通过即停，不自动重试循环。

工具列表里没有 pair_device

工具列表里没有 pair_device，但 npm 已装 autoace-cli。请按上方「AI Agent 接入」里我所在客户端的重载步骤（Cursor：Disable→Enable；Claude Code：重启会话；Codex：重启）后，新开对话再执行 pair_device。

设备已断开

设备已断开。请我重新打开快游大师的「MCP 服务」，并把「复制给 Agent」的全文发给你，然后重新 pair_device。

没点中

没点中。用这次返回的 log 和截屏改选择器，validate_kuaiyou_skill 通过后再 push_reactive_skill（run: true）。

会话缓存（工具列表缺项）

会话里没有 observe_screen，但 CLI tools/list 有。这是会话缓存问题，请新开对话，不要判定 CLI 没装。