# Solución de problemas

Soluciones a problemas habituales de Device MCP, desde un dispositivo que no aparece hasta un agente que no puede conectarse.

## 1. Mi dispositivo no aparece
* Asegúrate de que el dispositivo tenga iOS 27 o iPadOS 27 o posterior.
* Desbloquea el dispositivo y toca **Confiar** si te lo pregunta.
* Si macOS preguntó **Allow accessory to connect?** (¿Permitir que se conecte el accesorio?), haz clic en **Permitir**.
* Prueba con otro cable u otro puerto. Algunos cables solo sirven para cargar.
* Si usas Wi-Fi, asegúrate de que tu Mac y el dispositivo estén en la misma red, y revisa **Settings → General → Connection** en Device MCP.

## 2. La duplicación se detuvo o se congeló
Haz clic en **Reconnect** en el menú **More (…)** o presiona <kbd>⇧⌘R</kbd>.

Si Device MCP dice que otra app está duplicando la pantalla del dispositivo, por ejemplo, el Device Hub de Xcode, detén la duplicación en esa app y luego haz clic en **Reconnect**. Solo una app a la vez puede duplicar la pantalla de un dispositivo.

## 3. Los toques o la escritura no funcionan
* Haz clic una vez en la pantalla duplicada para que lo que teclees llegue al dispositivo.
* Con otros idiomas y con emojis, toca **Permitir** cuando iOS muestre **Permitir pegar**.
* En el dispositivo, abre **Ajustes → Desarrollador** y asegúrate de que **Enable UI Automation** esté activado. Consulta [iPhone y iPad](../devices/iphone-and-ipad.md#1-prepare-your-device).

## 4. El dispositivo no se queda girado
iOS solo mantiene la rotación mientras el dispositivo está apoyado en plano. Déjalo sobre la mesa y vuelve a girarlo.

## 5. Mi agente no encuentra Device MCP
* Abre Device MCP y activa **Settings → MCP → Enable MCP Server**.
* Asegúrate de tener [Device MCP Pro](../license.md).
* Comprueba que Device MCP esté en tu carpeta **Aplicaciones**. La configuración de la página [MCP](../ai-agents/mcp.md) apunta ahí.
* Reinicia tu agente después de añadir Device MCP.

## 6. Mi agente deja de esperar
Compilar tu app o esperar tu aprobación puede llevar unos minutos. En Codex, define `tool_timeout_sec = 900` como se muestra en la página [MCP](../ai-agents/mcp.md#codex).

## 7. Build & Run falla
* Abre el proyecto en Xcode y asegúrate de que compile para dispositivo, con firma automática.
* Lee el registro en la pestaña **Build & Run** para ver por qué.
* Si usas Wi-Fi, conecta el cable e inténtalo de nuevo.

## 8. ¿Todavía necesitas ayuda?
Elige **Help → Export Diagnostics…** en Device MCP. Guarda un archivo en tu Mac y no envía nada. Luego [escríbenos](/contact) con el archivo adjunto y te responderemos.