Saltar al contenido
Device MCP

Ayuda

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

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.

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.
  • Comprueba que Device MCP esté en tu carpeta Aplicaciones. La configuración de la página MCP 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.

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 con el archivo adjunto y te responderemos.