MCP server

最近更新:2026/7/22

把 AI 助手接到你的云手机,用自然语言操作它们。托管的在线地址是最快的接入方式:一个地址、一枚密钥,无需安装。

Remote endpoint

https://mcp.waitpid.ai

传输:Streamable HTTP(MCP 2025-03-26+)
鉴权:Authorization: Bearer <机器凭据> —— 仅走 header,绝不放 URL
TLS:仅 HTTPS

1. 签发机器凭据

控制台打开 自动化 → API 凭据 签发一枚凭据,选择:

操作类别作用域 —— 默认含 observe、ui-action、app、file、lifecycle;逃生舱(run-command、local-bridge)须显式勾选。
云机范围 —— 全部设备、指定分组或指定设备。
有效期 —— 可选 TTL;随时轮换与吊销。

明文(wpa_...)仅展示一次,请存入 agent 的密钥管理。

2. 配置你的 agent

Claude Code

claude mcp add --transport http cloud-phone https://mcp.waitpid.ai \
  --header "Authorization: Bearer wpa_..."

Cursor(.cursor/mcp.json)

{
  "mcpServers": {
    "cloud-phone": {
      "url": "https://mcp.waitpid.ai",
      "headers": { "Authorization": "Bearer wpa_..." }
    }
  }
}

Codex(~/.codex/config.toml)

[mcp_servers.cloud-phone]
url = "https://mcp.waitpid.ai"
http_headers = { "Authorization" = "Bearer wpa_..." }

VS Code(.vscode/mcp.json)

{
  "servers": {
    "cloud-phone": {
      "type": "http",
      "url": "https://mcp.waitpid.ai",
      "headers": { "Authorization": "Bearer wpa_..." }
    }
  }
}

Zed(settings.json)

{
  "context_servers": {
    "cloud-phone": {
      "source": "custom",
      "url": "https://mcp.waitpid.ai",
      "headers": { "Authorization": "Bearer wpa_..." }
    }
  }
}

3. 工具全景

分组	工具	说明
会话	`device_list`、`device_use`	把设备绑定到 MCP 会话
观测	`ui_inspect`、`status`、`screenshot`	带稳定元素标识的语义 UI 树;能力位
动作	`ui_tap`、`ui_type`、`ui_wait`、`ui_swipe`、`ui_key`	语义元素优先,归一化坐标兜底
应用	`app_launch`、`app_stop`、`app_list`	包级操作
逃生舱	`run_command`	仅 `run-command` 作用域可见

所有动作工具都支持显式 device 参数,无状态 agent 可跳过 device_use。

设备选择

device_list —— 列举凭据范围内的云机
device_use { device: "42" } —— 绑定到当前会话
其后动作默认作用于选定设备;选定为内存态,随会话结束失效

作用域与安全

工具清单在握手时按作用域裁剪 —— 只读凭据永远看不到动作工具。
每次调用服务端二次校验(作用域 × 云机范围 × 属主);审计记录凭据与目标设备。
凭据轮换带宽限期,吊销即时生效。
面向公网客户端的 OAuth 2.1 在演进路线上;当前受支持的路径是 Bearer 机器凭据。

本地备选:stdio

若你的 client 无法访问远程 server(或需要本地端口桥接),在本地跑同一工具面:

wp_cli auth login          # 粘贴一次机器凭据
wp_cli mcp                 # stdio MCP server

stdio 形态额外提供 connect(需 local-bridge 作用域),其余与 remote 完全一致 —— 同工具、同 API、同审计。参见 wp_cli 指南。

文档中心