Pular para o conteúdo
Device MCP

Ajuda

Solução de problemas

Soluções para problemas comuns do Device MCP, de um dispositivo que não aparece a um agente que não consegue se conectar.

1. Meu dispositivo não aparece

  • Verifique se o dispositivo tem iOS 27 ou iPadOS 27 ou posterior.
  • Desbloqueie o dispositivo e toque em Confiar se ele perguntar.
  • Se o macOS perguntou Allow accessory to connect? (permitir que o acessório se conecte?), clique em Permitir.
  • Tente outro cabo ou outra porta. Alguns cabos só carregam.
  • Por Wi-Fi, verifique se o Mac e o dispositivo estão na mesma rede e confira Settings → General → Connection no Device MCP.

2. O espelhamento parou ou congelou

Clique em Reconnect no menu More (…) ou pressione ⇧⌘R.

Se o Device MCP disser que outro app está espelhando o dispositivo, por exemplo, o Device Hub do Xcode, pare o espelhamento por lá e clique em Reconnect. Um dispositivo só pode ser espelhado por um app de cada vez.

3. Toques ou digitação não funcionam

  • Clique uma vez na tela espelhada para que o que você digita vá para o dispositivo.
  • Para outros idiomas e emojis, toque em Permitir quando o iOS perguntar Permitir Colar.
  • No dispositivo, abra Ajustes → Desenvolvedor e verifique se Enable UI Automation (ativar automação da interface) está ativado. Veja iPhone e iPad.

4. O dispositivo não mantém a rotação

O iOS só mantém uma rotação enquanto o dispositivo está deitado. Deite-o na mesa e gire de novo.

5. Meu agente não encontra o Device MCP

  • Abra o Device MCP e ative Settings → MCP → Enable MCP Server.
  • Verifique se você tem o Device MCP Pro.
  • Confira se o Device MCP está na pasta Aplicativos. A configuração da página MCP aponta para lá.
  • Reinicie seu agente depois de adicionar o Device MCP.

6. Meu agente para de esperar

Compilar seu app ou esperar sua aprovação pode levar alguns minutos. No Codex, defina tool_timeout_sec = 900 como mostrado na página MCP.

7. O Build & Run falha

  • Abra o projeto no Xcode e verifique se ele compila para dispositivo, com assinatura automática.
  • Leia o log na aba Build & Run para ver o motivo.
  • Por Wi-Fi, conecte o cabo e tente de novo.

8. Ainda precisa de ajuda?

Escolha Help → Export Diagnostics… no Device MCP. Isso salva um arquivo no seu Mac e não envia nada. Depois, fale com a gente anexando o arquivo, e retornaremos o contato.