Mobile MCP — Instalar & Demo ao vivo

Por que usar

Principais recursos

Agnóstico de plataforma: mesmas ferramentas para iOS e Android
Funciona com simuladores, emuladores e dispositivos reais
Screenshot + hierarquia de view equivalente ao DOM
Instalar APK/IPA a partir de URL ou caminho local
Sem necessidade de expertise em testes mobile

Demo ao vivo

Como fica na prática

mobile-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mobile-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mobile-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mobilenext/mobile-mcp@latest"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Mobile MCP

Smoke test do seu app em iOS + Android a partir de um único prompt

👤 QA mobile, devs sem um time de QA dedicado ⏱ ~20 min intermediate

Quando usar: Você acabou de gerar um build e quer saber se o fluxo de cadastro ainda funciona em ambas as plataformas.

Pré-requisitos

Simulador inicializado — xcrun simctl boot "iPhone 16" e emulator -avd Pixel_7
App instalado — Arraste o IPA/APK para o simulador ou use a ferramenta install_app

Fluxo

Iniciar sessão

Use mobile-mcp. Liste todos os dispositivos disponíveis.✓ Copiado

→ Simulador iOS + emulador Android listados
Executar o fluxo

Nos dois dispositivos em paralelo: abra meu app, toque em "Cadastrar", insira [email protected] / password123, toque em Continuar. Faça screenshot de cada passo.✓ Copiado

→ Sequência de screenshots dos dois dispositivos
Asserção

Em cada dispositivo, a tela "Verifique seu email" está visível? Se não, relate o que você vê.✓ Copiado

→ Resultado por plataforma com evidências

Resultado: Relatório de aprovação/falha com screenshots de ambas as plataformas em 2 minutos.

Armadilhas

Conta de teste bloqueada pelo anti-spam — Use emails descartáveis por build; alterne as contas de teste

Combine com: filesystem

Gerar screenshots da App Store em 5 tamanhos de dispositivo

👤 Devs indie submetendo para a App Store ⏱ ~25 min intermediate

Quando usar: Você precisa de screenshots de 6,5", 6,7" e 5,5" e não quer fazer isso manualmente.

Pré-requisitos

Simuladores para cada tamanho exigido — Crie via xcrun simctl com os tipos de dispositivo adequados

Fluxo

Montar a matriz

Inicialize os simuladores iPhone 15 Pro Max, iPhone 15 e iPhone SE. Instale meu app em cada um.✓ Copiado

→ Os três dispositivos prontos com o app instalado
Capturar fluxo

Em cada dispositivo, navegue para as 5 telas principais (onboarding, feed, detalhe, configurações, upgrade). Faça screenshot de cada uma em resolução máxima.✓ Copiado

→ Screenshots salvos por dispositivo com convenção de nomenclatura

Resultado: Screenshots prontos para a App Store em todos os tamanhos exigidos, em uma única execução.

Armadilhas

Screenshots incluem a barra de status do simulador — Use --status-bar-style=overridden ou pós-processe com crop

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

mobile-mcp + filesystem

Salvar screenshots em pastas de QA versionadas

Salve cada screenshot em /qa/$(date)/ com o nome do teste.✓ Copiado

mobile-mcp + xcodebuild

Compilar, instalar e testar em um único fluxo

Compile o app iOS via xcodebuild, instale via mobile-mcp, execute o smoke test.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_devices	none	Sempre primeiro — saiba o que está disponível	free
launch_app	device_id, bundle_id	Abrir seu app no dispositivo	free
tap	device_id, selector\|coords	Interagir com um botão ou controle	free
type_text	device_id, text: str	Preencher um campo de texto (deve estar em foco primeiro)	free
get_view_hierarchy	device_id	Descobrir o que está na tela	free
screenshot	device_id, path?: str	Verificação visual	free

Custo e limites

O que custa rodar

Cota de API: Local
Tokens por chamada: A hierarquia de view pode ter 10k+ tokens; screenshots são base64
Monetário: Gratuito
Dica: Prefira taps baseados em seletor a dumps completos da hierarquia de view para economizar tokens

Segurança

Permissões, segredos, alcance

Escopos mínimos: device access (physical USB requires trust dialog)

Armazenamento de credenciais: Nenhum

Saída de dados: Nenhum pelo MCP; screenshots chegam ao provedor LLM se compartilhados

Nunca conceda: production device access with PII

Não teste em dispositivos com dados de produção — use contas de QA dedicadas

Solução de problemas

Erros comuns e correções

Nenhum dispositivo listado

Inicialize um simulador primeiro: xcrun simctl boot / emulator -avd X

Verificar: `xcrun simctl list | grep Booted`

tap_at_coords erra o alvo

Execute get_view_hierarchy e use tap baseado em seletor — coordenadas quebram entre tamanhos de tela

Dispositivo real não confiado

No iOS: Ajustes → Geral → Gerenciamento de Dispositivos → Confiar. No Android: habilite o modo de depuração USB.

Alternativas

Mobile MCP vs. outros

Alternativa	Quando usar	Troca
XcodeBuildMCP	Você precisa apenas de build + teste no iOS, sem automação de UI multiplataforma	Sem Android; mais focado em ferramentas de build
Appium	Você quer um framework completo de testes mobile para CI	Muito mais configuração; não é nativo para MCP

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills