快游大师 MCP 服务让电脑上的本地 Agent 通过局域网连接手机，读取与当前 App 版本一致的技能 Schema，编排、校验并部署自动化技能或领域教练计划。技能进入 App 后仍由用户确认，并在手机本机执行；MCP 不是让技能在运行过程中持续请求云端大模型。

MCP 连接能做什么

MCP 是 Model Context Protocol（模型上下文协议）的缩写。在快游大师中，它用于把电脑端 Agent 的编排能力和手机端可执行动作连接起来。

典型流程是：

开启服务 → 复制连接信息 → pair → 拉取设备 Schema → 编排 → 校验 → 部署 → 手机确认

适合这些需求：

  • 在 Cursor、Claude、Codex 等支持 MCP 的客户端中编排自动化技能。
  • 读取手机当前版本提供的技能或领域教练计划 Schema。
  • 查看已有技能、修改步骤并重新部署。
  • 用界面树或截图辅助理解当前手机页面。
  • 在写入 App 前先校验技能结构。

不适合把账号、密码、验证码、支付信息或其他敏感内容交给 Agent。第三方客户端名称仅用于说明可对接的 MCP 客户端，不代表快游大师与其存在合作或背书关系。

开始前准备

确认以下条件：

  1. 手机和电脑连接同一局域网。
  2. 手机已安装支持 MCP 服务的快游大师版本。
  3. 电脑已安装 Node.js 18 或以上版本、npm 9 或以上版本。
  4. MCP 客户端能够注册 stdio MCP server。
  5. 只在可信的本地网络中开启服务。

快游大师自动化技能无需 Root；读取界面树、截图或执行点击时，仍需要用户按具体功能开启无障碍或屏幕读取权限。

第一步：在手机找到 MCP 服务

打开快游大师，依次进入：

  1. 「我的」。
  2. 「应用设置」。
  3. 「高级设置」。
  4. 找到「MCP 服务」和「MCP 使用指引」。
快游大师设置页中的 MCP 服务与使用指引入口
在设置的高级设置中找到 MCP 服务，并通过 MCP 使用指引查看同网连接和部署流程。

此时开关可以保持关闭。先确认入口存在，再准备电脑端配置。

第二步：开启服务并复制连接信息

打开「MCP 服务」开关。服务启动后，设置页会显示：

  • 当前局域网地址与端口。
  • 已掩码的配对码。
  • 「等待连接」或「已连接」状态。

点击 MCP 服务条目，可以复制地址、配对码和设备画像等连接信息。

快游大师设置中 MCP 服务已开启并显示连接地址与等待配对状态
打开 MCP 服务后，副标题会显示局域网地址与配对状态；点击该条目可复制给电脑端 Agent 的连接信息。

截图中的 192.168.x.x 地址只是采集设备当时的局域网示例。请始终使用你手机当前显示的地址和端口，不要照抄截图。

端口与配对码只对当前 MCP 服务实例有效。关闭再开启服务后，应重新复制连接信息。

第三步：在电脑配置 autoace-cli

电脑端使用 npm 包 autoace-cli。它是 stdio MCP server，应注册到 MCP 客户端，而不是只在普通终端里保持前台运行。

以下配置只展示字段关系，地址和配对码必须替换为 App 当前复制的值：

{
  "mcpServers": {
    "autoace": {
      "command": "npx",
      "args": ["-y", "autoace-cli"],
      "env": {
        "KUAIYOU_DEVICE_IP": "<手机当前显示的 ip:port>",
        "KUAIYOU_MCP_PAIRING_CODE": "<当前配对码>"
      }
    }
  }
}

不要把配对码写入项目文件、日志、截图或 Git 提交。配置后重新加载 MCP server；如果当前客户端不能动态加载，则重新打开会话。

第四步：先完成 pair，再拉取设备 Schema

连接后推荐先调用 pair。手机设置页显示「已连接」后，再让 Agent 从设备读取当前契约：

  • 技能 Schema：/api/mcp/schema
  • 领域教练计划 Schema：/api/mcp/plans/schema

设备 Schema 是当前 App 可执行能力的依据，不要让 Agent 使用另一份过期模板代替。

推荐顺序：

health → pair → schema → 读取已有技能或计划 → 本地编排

如果连续输入错误配对码并收到 429，请按 Retry-After 等待，再使用当前配对码重试。

第五步：验证并部署技能或计划

让 Agent 先调用校验能力，再部署到手机。部署请求成功只表示内容已经通过校验并进入待确认流程，并不等于已经写入「我的技能」或「领域教练」。

手机端仍需要用户确认：

  1. App 在前台时，显示导入确认。
  2. App 在后台时，可能先显示待确认通知。
  3. 用户确认后，技能或计划才会保存。
  4. 保存后先试运行，再决定是否配置定时或无人值守。

技能中的动作必须是手机本机能执行的点击、输入、滑动、等待、启动应用、条件判断等步骤。MCP 负责生成和部署，不会把“运行时询问云端 Agent”变成手机执行动作。

权限与网络边界

  • MCP 服务只应在可信局域网中使用，不要把地址或端口暴露到公网。
  • 配对码每次开启服务都会重新生成，应按临时凭据管理。
  • 用完后可以在设置中关闭 MCP 服务。
  • 获取截图或界面树时，手机端权限不足会导致请求失败。
  • 部署技能和计划需要手机确认，不应声称电脑端可以静默写入。
  • 自动化执行仍受目标 App 页面变化、系统权限和锁屏状态影响。

常见问题

Q: 使用 MCP 需要 Root 手机吗？

不需要。快游大师基于 Android 无障碍等系统能力执行自动化；使用截图、界面树或自动点击时，按手机提示开启对应权限即可。

Q: 为什么截图里的地址不能直接使用？

截图展示的是采集设备当时的局域网地址。你的手机 IP、端口和配对码可能不同，而且服务重启后也可能变化，必须使用 App 当前复制的连接信息。

Q: Agent 返回部署成功，为什么技能列表里还没有？

部署成功只表示已经进入手机待确认流程。请回到快游大师查看导入确认或系统通知，用户确认后才会保存。

Q: MCP 服务可以一直开着吗？

不建议无需要时长期开放。完成编排和部署后可以关闭服务；下次开启时重新复制地址与配对码。

Q: MCP 会让技能运行时持续调用 AI 吗？

不会。Agent 在编排阶段生成符合设备 Schema 的技能，导入后由手机执行本地动作。需要重新分析或修改时，再回到电脑端 Agent 编排并部署新版本。

下一步