Phonebox

Phonebox：为 AI Agent 提供云手机（Android MCP 服务）

Phonebox 提供托管式 Android MCP 服务，适用于 Claude Code、Codex、Cursor 和任何 MCP 客户端。Phonebox 是一款以 Agent 为先的云手机。 你的 Agent 可以在云端使用一部真正的 Android 手机。它可以读取屏幕、点击、输入、安装你的 APK、交由人工接手，并在完成后停放手机。你不需要 ADB、Android Studio 或模拟器。

claude mcp add --transport http phonebox https://phonebox.dev/mcp \
  --header "Authorization: Bearer $PHONEBOX_API_KEY"

▶ 观看 3 分钟设置教程： 为 Claude Code 配备 Android 手机：Android MCP 服务设置 · 文字稿 ▶ 观看 56 秒演示： 为 Claude Code 配备 Android 手机（MCP） · 文字稿

• 端点： https://phonebox.dev/mcp（Streamable HTTP，Bearer API 密钥）
• 价格： 每部手机每分钟 $0.06，按秒计费，最低 1 分钟。停放的手机免费，并保留应用和登录状态。
• 免费开始： $2 额度，无需银行卡 → phonebox.dev

此仓库包含配置和示例。服务本身由 Phonebox 托管，因此无需运行任何东西。

为何以 Agent 为先

大多数云手机最初是为社交媒体控制面板或 QA 测试套件打造，后来才添加 API。Phonebox 则是为 Agent 打造的：你的 Agent 可以从终端为你注册，以文本形式读取屏幕，遇到错误时会收到一个 next 步骤，而且写入操作绝不会在你不知情的情况下重试。闲置的手机会自动免费停放。

为何选择托管服务，而不是 ADB MCP 服务？

	本地 ADB MCP 服务	Phonebox 托管 MCP
手机运行位置	你机器上的模拟器或 USB 手机	Phonebox 云端
设置	Android SDK、ADB、系统镜像	一个 URL 和一个 API 密钥
能否用于 CI、沙箱和远程开发环境	仅支持嵌套虚拟化或设备	可以
会话间的状态	由模拟器保留	停放期间保留应用、文件和登录状态
人工接手	机器旁的人	可在任何浏览器中打开的实时查看链接

获取 API 密钥

最快的方法是将以下内容粘贴到你的编码 Agent 中。它会从终端为你注册，你无需在聊天中粘贴密钥：

Read https://phonebox.dev/setup.md and set me up with Phonebox from here: get me signed in and ready, then find out what I want to use phones for and help me with that.

或者在控制台中创建密钥，并执行 export PHONEBOX_API_KEY=pbx_…。

连接客户端

Claude Code — 运行顶部的命令，或提交此仓库的 .mcp.json。它会从每个人的环境中读取密钥：

{
  "mcpServers": {
    "phonebox": {
      "type": "http",
      "url": "https://phonebox.dev/mcp",
      "headers": { "Authorization": "Bearer ${PHONEBOX_API_KEY}" }
    }
  }
}

Cursor： 将 examples/cursor-mcp.json 添加到 ~/.cursor/mcp.json 或 .cursor/mcp.json。指南：为 Cursor 配备 Android 手机。

Codex： 将 examples/codex-config.toml 添加到 ~/.codex/config.toml，并执行 export PHONEBOX_API_KEY=$(phonebox token)。指南：为 Codex 配备 Android 手机。

Gemini CLI：

gemini mcp add --transport http --scope user \
  --header "Authorization: Bearer $PHONEBOX_API_KEY" \
  phonebox https://phonebox.dev/mcp

Windsurf、Cline 和 VS Code（GitHub Copilot）： 查看 Windsurf、Cline 和 GitHub Copilot 的设置页面。

任何其他客户端： 将其指向 https://phonebox.dev/mcp，并添加 Authorization: Bearer pbx_… 标头。该服务使用无状态 Streamable HTTP，不使用 OAuth。

工具

工具	功能
create_phone	创建一部云端 Android 手机，并等待其就绪
observe	以带编号的文本列表形式读取屏幕，并附带一张 720px 截图
act	按顺序执行最多 20 项操作：点击、输入、滑动、滚动、打开应用、等待元素出现
install_app	从应用库或你上传的 APK 安装应用
create_app_upload / complete_app_upload	使用一条 curl 命令上传你的 APK
live_view_url	提供一个链接，供他人查看并控制手机
start_phone / park_phone	恢复已停放的手机，或停放手机以停止计费
list_phones / get_phone / list_apps / reboot_phone	查找手机、等待手机就绪、列出应用、重启卡住的手机

Agent 从 observe 读取的内容：

app com.android.launcher3
screen 1080x2400
[1] EditText "Search apps" #search clickable editable (540,250)
[2] TextView "Chrome" #icon clickable (200,1900)
[3] TextView "Settings" #icon clickable (500,1900)

示例

• 测试刚构建的 APK：构建、安装、探索，并使用准确的屏幕文本报告 Bug。
• TypeScript SDK Agent：创建手机、读取屏幕、点击、停放手机。
• 为每位客户配备一部手机：根据你自己的 ID 查找或创建每位客户的手机。

使用场景

• 测试 Agent 刚构建的 Android 应用。 构建 APK、安装应用、浏览改动过的屏幕，并使用准确的屏幕文本报告 Bug。指南 · 可直接复制粘贴的测试提示词 · 通过屏幕录制复现 Bug 报告
• 使用没有 API 的应用。 Agent 在自己的手机上像人一样读取屏幕并点击应用，同时为支付和一次性验证码提供一个实时查看链接。指南
• 为 AI 产品的每位客户配备一部手机。 每位终端用户拥有一部持久化手机，并使用你的客户 ID 标记；任务间停放手机，因此闲置客户不会产生费用。指南 · 示例

常见问题

如何为 Claude Code 提供一部 Android 手机？ 在顶部运行带有 Phonebox API 密钥的 claude mcp add 命令。Claude Code 就能获得一部可读取和控制的云端 Android 手机，无需安装任何东西。如果你更愿意在本地运行所有内容，也可以使用模拟器搭配 adb，或使用 mobile-mcp 等本地服务；比较所有选项。

有没有可以与 Claude Code 或 Cursor 搭配使用的托管 Android MCP 服务？ 有，就是这个：https://phonebox.dev/mcp，使用带 bearer API 密钥的 Streamable HTTP。手机运行在 Phonebox 云端，因此可在 CI 运行器和无法运行模拟器的云沙箱中使用。

它与 mobile-mcp 或 Appium MCP 有何不同？ 这些工具在你的机器上运行，驱动你提供的模拟器或 USB 设备，也支持 iOS。Phonebox 提供手机，并在不同会话之间保持登录状态，且仅支持 Android。比较。

AI Agent 如何使用没有 API 的 Android 应用？ 通过应用屏幕来操作：Agent 将每个屏幕读取为带编号的元素列表，按标签点击和输入，并在每次操作后再次读取。Phonebox 为它提供一部手机来完成这些操作；需要人工介入时，还会提供一个实时查看链接。

费用是多少？ 手机运行期间每分钟收费 $0.06，按秒计费，最低计费时长为 1 分钟。停放的手机免费。进行一次 10 分钟的测试需要 $0.60。新账户可获得 $2 额度，无需绑定银行卡。

它不是什么

仅支持 Android（不支持 iOS），也没有电话号码、短信或通话功能。Phonebox 为你的 Agent 提供设备，而非电话服务。

了解更多

• AI Agent 云手机：它们是什么以及如何选择
• Android MCP 服务指南
• 使用 AI Agent 测试 Android 应用
• AI Agent 云手机对比：最佳选择
• 完整的 MCP 文档

---

Phonebox（phonebox.dev）是一个面向 AI Agent 的云手机平台。它不是移动运营商、手机套餐或 eSIM 提供商。