Pular para o conteúdo
Device MCP

Agentes de IA

MCP

Conecte Claude Code, Codex, Cursor ou qualquer cliente MCP ao Device MCP para seu agente de IA ver, tocar, digitar e testar no iPhone e iPad.

O Device MCP conecta seu agente de programação com IA ao seu iPhone e iPad reais. Seu agente pode olhar a tela, tocar e digitar, abrir apps, compilar seu projeto e testá-lo no dispositivo, tudo a partir de uma conversa normal.

1. O que é o servidor MCP do Device MCP?

O MCP (Model Context Protocol) é o padrão aberto que os agentes de IA usam para se comunicar com ferramentas. O Device MCP tem um servidor MCP integrado, então o Claude Code, o Codex, o Cursor e outros agentes compatíveis com MCP podem controlar seu dispositivo do mesmo jeito que você.

O servidor roda apenas no seu Mac. Sua tela e seus apps nunca saem do Mac, exceto o que você pedir para o agente olhar. Veja Privacidade e segurança.

✅ Exemplos de prompts

  • Faça uma captura de tela do meu iPhone e me diga o que aparece na tela.
  • Abra os Ajustes e ative o Modo Escuro.
  • Compile meu app, execute no iPad e verifique se a tela de login funciona.
  • Faça login com a conta de teste, adicione um item ao carrinho e confira o total.
  • Meu app fechou inesperadamente no dispositivo. Encontre o relatório de falhas e corrija o bug.
  • Abra myapp://profile e faça uma captura de tela.
  • Grave um vídeo do fluxo de onboarding.

2. Benefícios

BenefícioDescrição
Teste em hardware realSeu agente testa em um iPhone ou iPad real, com desempenho, sensores e alertas do sistema reais.
Desenvolvimento em ciclo fechadoEditar, compilar, executar, tocar, capturar a tela, corrigir: seu agente confere o próprio trabalho sem você.
Ele vê o que você vêSeu agente lê as palavras e os botões na tela, então consegue tocar em Sign In pelo nome.
Você no comandoAções arriscadas pedem sua aprovação antes, toda ação fica registrada e você pode assumir o controle a qualquer momento.
Funciona com o seu agenteClaude Code, Codex, Cursor e qualquer outro cliente MCP.

3. Como adicionar o Device MCP ao seu agente

  1. Ative o servidor MCP
    • Abra Device MCP → Settings → MCP.
    • Ative Enable MCP Server.
  2. Copie a configuração do seu agente: em Settings → MCP → MCP Configuration, escolha Claude Code, Codex ou Manual e clique em Copy. A mesma configuração está na aba Agent do Inspector.
  3. Adicione ao seu agente seguindo os passos abaixo.

Claude Code

Execute isto no Terminal:

claude mcp add --scope user device-mcp -- "/Applications/Device MCP.app/Contents/MacOS/device-mcp"

--scope user deixa o Device MCP disponível em todos os seus projetos.

Codex

Adicione isto ao ~/.codex/config.toml:

[mcp_servers.device-mcp]
command = "/Applications/Device MCP.app/Contents/MacOS/device-mcp"
startup_timeout_sec = 30
tool_timeout_sec = 900

Cursor e outros clientes MCP

Adicione isto às configurações de MCP do seu cliente:

{
  "mcpServers": {
    "device-mcp": {
      "command": "/Applications/Device MCP.app/Contents/MacOS/device-mcp",
      "args": []
    }
  }
}
  1. Comece a usar o Device MCP
    • Mantenha o Device MCP aberto com seu dispositivo conectado.
    • Peça ao seu agente, por exemplo: "Liste meus dispositivos e faça uma captura de tela."

4. O que seu agente pode fazer

ÁreaO que seu agente pode fazer
DispositivosListar os dispositivos conectados, escolher um e ler os detalhes dele.
Ver a telaFazer capturas de tela e ler o texto e os botões na tela.
ToqueTocar, tocar em um texto, tocar duas vezes, tocar e manter pressionado, deslizar, rolar e pinçar.
DigitaçãoDigitar texto, pressionar teclas e ocultar o teclado.
SistemaPressionar os botões de Início, bloqueio, volume e Siri, abrir a Central de Controle ou o Seletor de Apps e girar a tela.
AppsListar, abrir, encerrar, instalar e desinstalar apps, e abrir links.
Build & RunCompilar seu projeto Xcode e executá-lo no dispositivo. Veja Build & Run.
DepuraçãoLer relatórios de falhas e baixar os dados de um app.
GravaçãoIniciar e parar uma gravação de tela.
Chamar vocêPedir que você intervenha, por exemplo, para Face ID ou código. Veja Human Handoff.

Seu cliente MCP mostra a lista completa de ferramentas da sua versão do Device MCP.

5. Mantenha o controle

  • Aprovações: instalar ou remover apps, compilar, abrir links e baixar dados de apps pedem sua aprovação antes. Veja Aprovações.
  • Atividade: toda ação do seu agente aparece na aba Agent. Veja Atividade do agente.
  • Agent is driving: o status na parte inferior da tela espelhada e um ✨ ao lado do dispositivo na barra lateral mostram quando um agente está usando o dispositivo.
  • Assuma a qualquer momento: seus cliques e o que você digita sempre chegam ao dispositivo, mesmo enquanto um agente trabalha.