Phonebox (Android for AI agents)
Servidor MCP de Android alojado: dale a Claude Code, Codex o Cursor un teléfono Android en la nube para leer la pantalla, tocar, escribir, instalar APKs y estacionar. Sin ADB ni emulador.
Servidor MCP alojado
npx add-mcp 'https://phonebox.dev/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP de Phonebox para Android
Un servidor MCP de Android alojado para Claude Code, Codex, Cursor y cualquier cliente MCP, de Phonebox, el teléfono en la nube pensado para agentes. Tu agente obtiene un teléfono Android real en la nube. Puede leer la pantalla, tocar, escribir, instalar tu APK, transferir a un humano y estacionar el teléfono cuando termina. No necesitas ADB, Android Studio ni un emulador.
claude mcp add --transport http phonebox https://phonebox.dev/mcp \
--header "Authorization: Bearer $PHONEBOX_API_KEY"
- Endpoint:
https://phonebox.dev/mcp(HTTP Streamable, clave API de tipo bearer) - Precio: $0.06 por minuto de teléfono, facturado por segundo, con un mínimo de 1 minuto. Los teléfonos estacionados son gratuitos y conservan sus aplicaciones e inicios de sesión.
- Comienza gratis: $2 de crédito, sin tarjeta → phonebox.dev
Este repositorio contiene las configuraciones y ejemplos. El servidor en sí está alojado por Phonebox, así que no hay nada que ejecutar.
Por qué está pensado para agentes
La mayoría de los teléfonos en la nube se crearon para paneles de redes sociales o suites de pruebas de control de calidad y añadieron una API después. Phonebox se creó para el agente: tu agente te registra desde la terminal, lee la pantalla como texto, recibe errores con un paso de next y nunca se reintenta una escritura sin que lo sepa. Los teléfonos inactivos se estacionan solos de forma gratuita.
Por qué está alojado en lugar de un servidor MCP de ADB
| Servidor MCP de ADB local | MCP alojado de Phonebox | |
|---|---|---|
| Dónde se ejecuta el teléfono | Un emulador o teléfono USB en tu máquina | La nube de Phonebox |
| Configuración | SDK de Android, ADB, una imagen de sistema | Una URL y una clave API |
| Funciona desde CI, sandboxes y entornos de desarrollo remotos | Solo con virtualización anidada o un dispositivo | Sí |
| Estado entre sesiones | Lo que conserve tu emulador | Aplicaciones, archivos e inicios de sesión conservados mientras está estacionado |
| Transferencia a un humano | Alguien en la máquina | Un enlace de vista en vivo en cualquier navegador |
Obtén una clave API
La forma más rápida es pegar esto en tu agente de codificación. Te registra desde la terminal y nunca pegas una clave en el chat:
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.
O crea una clave en la consola y export PHONEBOX_API_KEY=pbx_….
Conecta tu cliente
Claude Code — ejecuta el comando en la parte superior o confirma el .mcp.json de este repositorio. Lee la clave del entorno de cada persona:
{
"mcpServers": {
"phonebox": {
"type": "http",
"url": "https://phonebox.dev/mcp",
"headers": { "Authorization": "Bearer ${PHONEBOX_API_KEY}" }
}
}
}
Cursor: añade examples/cursor-mcp.json a ~/.cursor/mcp.json o .cursor/mcp.json.
Codex: añade examples/codex-config.toml a ~/.codex/config.toml.
Cualquier otro cliente: apúntalo a https://phonebox.dev/mcp con un encabezado Authorization: Bearer pbx_…. El servidor es HTTP Streamable sin estado y no usa OAuth.
Herramientas
| Herramienta | Qué hace |
|---|---|
create_phone | Crea un teléfono Android en la nube y espera hasta que esté listo |
observe | Lee la pantalla como una lista de texto numerada, más una captura de pantalla de 720px |
act | Ejecuta hasta 20 acciones en orden: tocar, escribir, deslizar, desplazarse, abrir una aplicación, esperar un elemento |
install_app | Instala desde la biblioteca de aplicaciones o desde tu propio APK subido |
create_app_upload / complete_app_upload | Sube tu APK con un solo comando curl |
live_view_url | Un enlace para que una persona vea y controle el teléfono |
start_phone / park_phone | Reanuda un teléfono estacionado, o lo estaciona para detener la facturación |
list_phones / get_phone / list_apps / reboot_phone | Encuentra teléfonos, espera por ellos, lista aplicaciones, reinicia un teléfono bloqueado |
Lo que el agente lee de 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)
Ejemplos
- Prueba el APK que acabas de compilar: compila, instala, explora y reporta errores con el texto exacto de la pantalla.
- Agente del SDK de TypeScript: crea un teléfono, lee la pantalla, toca, estaciona.
Lo que no es
Solo Android (sin iOS), y no hay números de teléfono, SMS ni llamadas. Phonebox le da a tu agente el dispositivo, no telefonía.