Phonebox (Android for AI agents)

Servidor MCP Android hospedado: dê ao Claude Code, Codex ou Cursor um telefone Android na nuvem para ler a tela, tocar, digitar, instalar APKs e estacionar. Sem ADB ou emulador.

GitHubExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://phonebox.dev/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidor MCP Phonebox para Android

Um servidor MCP Android hospedado para Claude Code, Codex, Cursor e qualquer cliente MCP, da Phonebox, o telefone em nuvem voltado para agentes. Seu agente recebe um telefone Android real na nuvem. Ele pode ler a tela, tocar, digitar, instalar seu APK, transferir para um humano e estacionar o telefone quando terminar. Você não precisa de ADB, Android Studio ou emulador.

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

Endpoint: https://phonebox.dev/mcp (HTTP Streamable, chave de API bearer)
Preço: US$ 0,06 por minuto de telefone, cobrado por segundo, com mínimo de 1 minuto. Telefones estacionados são gratuitos e mantêm seus aplicativos e logins.
Comece grátis: US$ 2 de crédito, sem cartão → phonebox.dev

Este repositório contém as configurações e exemplos. O servidor em si é hospedado pela Phonebox, então não há nada para executar.

Por que voltado para agentes

A maioria dos telefones em nuvem foi criada para painéis de mídia social ou suítes de teste de QA e adicionou uma API depois. A Phonebox foi criada para o agente: seu agente faz o cadastro pelo terminal, lê a tela como texto, recebe erros com uma etapa next e nunca tem uma gravação repetida sem seu conhecimento. Telefones ociosos se estacionam gratuitamente.

Por que hospedado em vez de um servidor MCP ADB?

	Servidor MCP ADB local	MCP hospedado Phonebox
Onde o telefone roda	Um emulador ou telefone USB na sua máquina	Nuvem da Phonebox
Configuração	Android SDK, ADB, uma imagem de sistema	Uma URL e uma chave de API
Funciona em CI, sandboxes e ambientes de desenvolvimento remotos	Somente com virtualização aninhada ou um dispositivo	Sim
Estado entre sessões	O que seu emulador mantém	Aplicativos, arquivos e logins mantidos enquanto estacionado
Transferência para humano	Alguém na máquina	Um link de visualização ao vivo em qualquer navegador

Obtenha uma chave de API

A maneira mais rápida é colar isto no seu agente de codificação. Ele faz seu cadastro pelo terminal, e você nunca cola uma chave no 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.

Ou crie uma chave no console e export PHONEBOX_API_KEY=pbx_….

Conecte seu cliente

Claude Code — execute o comando no topo ou faça commit do .mcp.json deste repositório. Ele lê a chave do ambiente de cada pessoa:

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

Cursor: adicione examples/cursor-mcp.json a ~/.cursor/mcp.json ou .cursor/mcp.json.

Codex: adicione examples/codex-config.toml a ~/.codex/config.toml.

Qualquer outro cliente: aponte para https://phonebox.dev/mcp com um cabeçalho Authorization: Bearer pbx_…. O servidor é HTTP Streamable sem estado e não usa OAuth.

Ferramentas

Ferramenta	O que faz
`create_phone`	Cria um telefone Android em nuvem e aguarda até que esteja pronto
`observe`	Lê a tela como uma lista de texto numerada, além de uma captura de tela de 720px
`act`	Executa até 20 ações em ordem: tocar, digitar, deslizar, rolar, abrir um aplicativo, aguardar um elemento
`install_app`	Instala a partir da biblioteca de aplicativos ou do seu próprio APK enviado
`create_app_upload` / `complete_app_upload`	Envia seu APK com um único comando `curl`
`live_view_url`	Um link para uma pessoa assistir e controlar o telefone
`start_phone` / `park_phone`	Retoma um telefone estacionado ou o estaciona para interromper a cobrança
`list_phones` / `get_phone` / `list_apps` / `reboot_phone`	Encontra telefones, aguarda por eles, lista aplicativos, reinicia um telefone travado

O que o agente lê 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)

Exemplos

Teste o APK que você acabou de criar: crie, instale, explore e relate bugs com o texto exato da tela.
Agente do SDK TypeScript: crie um telefone, leia a tela, toque, estacione.

O que não é

Somente Android (sem iOS), e não há números de telefone, SMS ou chamadas. A Phonebox dá ao seu agente o dispositivo, não a telefonia.