# 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 <kbd>⇧⌘R</kbd>.

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](../devices/iphone-and-ipad.md#1-prepare-your-device).

## 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](../license.md).
* Confira se o Device MCP está na pasta **Aplicativos**. A configuração da página [MCP](../ai-agents/mcp.md) 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](../ai-agents/mcp.md#codex).

## 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](/contact) anexando o arquivo, e retornaremos o contato.