#14 no GitHub · Navegador e apps
Como instalar e usar o Mobile MCP
Um servidor MCP que deixa a IA controlar aplicativos de celular iOS e Android: tocar, deslizar, digitar, abrir e instalar apps, tirar capturas de tela. Funciona em simuladores, emuladores e aparelhos reais.
- Para quem
- Quem desenvolve ou testa apps de celular e quer automatizar fluxos pelo Claude Code sem escrever código de teste para cada plataforma.
- Estrelas (07/11/2026)
- 10.382, #14 no ranking
- Licença
- Apache 2.0
- Repositório
- mobile-next/mobile-mcp
Passo a passo
Antes de começar: Node.js v20 ou mais novo; Xcode command line tools (para iOS); Android Platform Tools (para Android); Um simulador, emulador ou aparelho conectado (aparelho real iOS ou Android conectado por USB e autorizado); Um cliente compatível com MCP, como o Claude Code.
Tenha os requisitos instalados
Para iOS você precisa do Xcode e de um simulador ligado. Para Android, do Android SDK e de um emulador rodando, ou de um aparelho com depuração USB ativada e autorizada.
Adicione o servidor ao Claude Code
Cole o comando no terminal. O README oferece também um plugin do Claude Code, mas indica este comando para quem não pode usar plugins.
Comandoclaude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
Ou use a instalação rápida
O README também oferece um comando que detecta os clientes MCP da máquina e deixa você escolher quais configurar. A opção --yes configura todos sem perguntar.
Comandonpx @mobilenext/mobile-mcp@latest install
Deixe um simulador ou emulador ligado
Antes de pedir qualquer coisa, suba um simulador iOS ou um emulador Android, ou conecte um aparelho. O README dá comandos de exemplo para iOS.
Comandoxcrun simctl list
Desligue a telemetria, se quiser
O README diz que o servidor coleta telemetria anônima e mostra como desligar com uma variável de ambiente. Na configuração em JSON, a variável vai dentro de 'env'.
ComandoMOBILEMCP_DISABLE_TELEMETRY=1 npx @mobilenext/mobile-mcp@latest
Verifique se funcionou
Peça ao agente a lista de dispositivos. Se vierem seus simuladores, emuladores e aparelhos, a conexão está certa. Se a lista vier vazia, confira se há um simulador ou emulador rodando.
Primeiro teste
Numa sessão com o servidor conectado, cole:
list available devices
Segundo o README, você deve receber de volta os simuladores, emuladores e dispositivos conectados que estão rodando.
Cuidados
- O README documenta telemetria anônima de uso, coletada por PostHog e Scarf. Para desligar, defina MOBILEMCP_DISABLE_TELEMETRY=1; na configuração em JSON, ponha a variável dentro de 'env'.
- O servidor controla o aparelho de verdade: toca, digita, instala e desinstala apps, limpa dados de apps, lê a área de transferência e grava a tela. Use primeiro em simulador ou emulador.
- O modo HTTP (opção --listen) aceita conexões sem autenticação quando a variável MOBILEMCP_AUTH não está definida, e o README diz que o servidor registra um aviso nesse caso.
- A ferramenta mobile_open_url bloqueia por padrão esquemas de URL fora do padrão; a variável MOBILEMCP_ALLOW_UNSAFE_URLS=1 libera.
- O serviço Mobile Next Cloud, com aparelhos reais na nuvem, é uma oferta à parte, citada no README, que exige login.
Como desfazer
O README não traz passo de remoção. Quem adicionou por 'claude mcp add' precisa remover a entrada do servidor 'mobile-mcp' da configuração do Claude Code. Essa orientação é da DNACX e não está no README.
O que o README não confirma
Esta página foi montada lendo o README. Estes pontos não estão escritos lá:
- Preço e limites do Mobile Next Cloud: o README não informa.
- O comando exato para remover o servidor do Claude Code.
- Quais dados a telemetria anônima envia além de ser 'anônima'.
- Se o plugin com /mobile-mirror funciona no seu terminal (o README exige um terminal com o protocolo gráfico kitty, como kitty ou Ghostty).
Dúvidas
Funciona com iPhone e Android?
Sim. O README lista simulador iOS, aparelho iOS real, emulador Android e aparelho Android real.
Preciso saber programar para testar apps?
O README diz que não é preciso conhecimento específico de plataforma, como XCUITest ou Espresso: você descreve o objetivo e o agente age.
Posso usar aparelhos na nuvem?
O README cita o Mobile Next Cloud, com aparelhos reais sob demanda, usando as mesmas ferramentas.
Como transformo o que a IA fez em teste repetível?
O README indica o Mobilewright, um projeto da mesma equipe, para virar o fluxo em teste determinístico que pode rodar em CI.
A DNACX usa o Mobile MCP?
Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.
Próximo da lista
Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de mobile-next/mobile-mcp, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.