General Tutorial

Cursor

Open Cursor Settings → MCP → Add new MCP server; choose type stdio and name autoace. Paste the whole block below into it.

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

After adding it, Disable → Enable it in the MCP list (or restart Cursor), then start a new chat. Wait until you see pair_device.

Claude Code

Run the command below in your project root (or edit .mcp.json). Check the status with /mcp.

claude mcp add autoace -- autoace-cli

Then start a new session. Wait until you see pair_device.

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

Codex

Append the block below to ~/.codex/config.toml.

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

Restart Codex, start a new session. Wait until you see pair_device.

Any MCP client

This template works for any MCP-capable client. With autoace-cli installed globally, set command to autoace-cli and drop args.

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

Reload or start a new chat. Wait until you see pair_device.

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

Step 1 · Pair

Open Kuaiyou Master: Settings → Advanced → MCP Service. Enable it, tap Copy for Agent, and send the whole text to the AI.

Step 2 · Watch the screen, write the skill

Describe the goal in plain language. The AI looks at the current screen and writes the skill; you never hand-write JSON or memorize tool names.

Step 3 · Confirm on the phone

The AI validates and pushes the skill to the phone. When the confirmation appears, tap Confirm/Allow.

Step 4 · See the result

The skill runs locally on the phone and the AI sends you the log. If a tap missed, copy the matching line from Common issues.

Open WeChat and wait for the home screen

Prompt for your AI

First confirm autoace is connected, then observe_screen to look at my phone. Write a skill that opens WeChat and waits until the home screen appears (for example, the "Discover" or "Contacts" tab is visible). Validate with validate_kuaiyou_skill, then push_reactive_skill (run: true) and send me the log when done.

After it runs：The AI watches the screen, writes the skill, and pushes it; a confirmation appears on the phone, and the AI sends you the log when it finishes.

Same for Alipay: swap "WeChat" for "Alipay" in the prompt. If an agreement or teen-mode screen appears, dismiss it first and wait for home.

Note：Icons and labels follow the current screen — never guess widget IDs. If you are not sure what the home screen looks like, open WeChat once manually first.

Dismiss popups (update / teen-mode)

Prompt for your AI

observe_screen to look at the current popup. Write a skill that dismisses popups like "Not now", "Later", "Cancel", or "Got it" when they appear, up to 3 times, then stop and describe the screen. Validate, then push (run: true).

After it runs：It handles at most 3 popups, then stops, and the AI sends you a description of the screen.

Note：Use only real text from the current screen; no fixed coordinates; stop after handling popups, never loop.

Tap "Check-in" once when it appears

Prompt for your AI

observe_screen to look at the current screen. Write a skill that taps "Check-in" once when the text appears and ends — no other actions. Validate, then push (run: true).

After it runs：One tap and done — no check-in loops.

Note：One tap and stop (maxExecutions 1); decline any "check in every day" infinite-loop requests.

Smoke test: open Settings, confirm "About phone"

Prompt for your AI

Run a smoke test: open the Settings page and confirm the text "About phone" appears. observe_screen and write selectors against the real screen, validate, then push (run: true) and tell me whether it passed.

After it runs：When it finishes, the AI tells you whether it passed based on the log.

Note：Assert by text, not coordinates; one pass and stop, no automatic retry loops.

pair_device missing from the tool list

pair_device is missing from my tool list, but autoace-cli is installed via npm. Please follow the reload steps for my client from AI Agent setup above (Cursor: Disable→Enable; Claude Code: restart the session; Codex: restart), then start a new chat and run pair_device.

Device disconnected

The device is disconnected. Ask me to reopen the MCP service in Kuaiyou Master and send you the full "Copy to Agent" text, then pair_device again.

Missed tap

The tap missed. Fix the selector using the returned log and screenshot, validate_kuaiyou_skill, then push_reactive_skill (run: true).

Stale session catalog

observe_screen is missing from this session but CLI tools/list has it. That is a session cache issue — start a new chat, do not conclude the CLI is missing the tool.