Saltar al contenido
Device MCP

Agentes de IA

MCP

Conecta Claude Code, Codex, Cursor o cualquier cliente MCP a Device MCP para que tu agente de IA pueda ver, tocar, escribir y hacer pruebas en tu iPhone y iPad.

Device MCP conecta tu agente de programación con IA a tu iPhone y iPad reales. Tu agente puede ver la pantalla, tocar y escribir, abrir apps, compilar tu proyecto y probarlo en el dispositivo, todo desde una conversación normal.

1. ¿Qué es el servidor MCP de Device MCP?

MCP (Model Context Protocol) es el estándar abierto que usan los agentes de IA para comunicarse con herramientas. Device MCP incluye un servidor MCP, así que Claude Code, Codex, Cursor y otros agentes compatibles con MCP pueden manejar tu dispositivo igual que tú.

El servidor solo se ejecuta en tu Mac. Tu pantalla y tus apps nunca salen de tu Mac, salvo lo que le pidas a tu agente que mire. Consulta Privacidad y seguridad.

✅ Ejemplos de prompts

  • Haz una captura de pantalla de mi iPhone y dime qué hay en la pantalla.
  • Abre Ajustes y activa el modo oscuro.
  • Compila mi app, ejecútala en el iPad y comprueba que la pantalla de inicio de sesión funciona.
  • Inicia sesión con la cuenta de prueba, añade un artículo al carrito y comprueba el total.
  • Mi app se cerró inesperadamente en el dispositivo. Busca el informe de fallos y corrige el error.
  • Abre myapp://profile y haz una captura de pantalla.
  • Graba un video del flujo de onboarding.

2. Ventajas

VentajaDescripción
Pruebas en dispositivos realesTu agente hace pruebas en un iPhone o iPad real, con el rendimiento, los sensores y las alertas del sistema reales.
Desarrollo en ciclo cerradoEditar, compilar, ejecutar, tocar, hacer una captura, corregir: tu agente comprueba su propio trabajo sin ti.
Ve lo mismo que túTu agente lee los textos y los botones de la pantalla, así que puede tocar Iniciar sesión por su nombre.
Tú tienes el controlLas acciones de riesgo piden permiso antes, todas las acciones quedan registradas y puedes tomar el control cuando quieras.
Funciona con tu agenteClaude Code, Codex, Cursor y cualquier otro cliente MCP.

3. Cómo añadir Device MCP a tu agente

  1. Activa el servidor MCP
    • Abre Device MCP → Settings → MCP.
    • Activa Enable MCP Server.
  2. Copia la configuración para tu agente: en Settings → MCP → MCP Configuration, elige Claude Code, Codex o Manual y haz clic en Copy. La misma configuración está en la pestaña Agent del Inspector.
  3. Añádela a tu agente con los pasos siguientes.

Claude Code

Ejecuta esto en Terminal:

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

--scope user hace que Device MCP esté disponible en todos tus proyectos.

Codex

Añade esto a ~/.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 y otros clientes MCP

Añade esto a la configuración MCP de tu cliente:

{
  "mcpServers": {
    "device-mcp": {
      "command": "/Applications/Device MCP.app/Contents/MacOS/device-mcp",
      "args": []
    }
  }
}
  1. Empieza a usar Device MCP
    • Mantén Device MCP abierto con tu dispositivo conectado.
    • Pídele algo a tu agente, por ejemplo: "Muestra la lista de mis dispositivos y haz una captura de pantalla."

4. Qué puede hacer tu agente

ÁreaQué puede hacer tu agente
DispositivosVer la lista de tus dispositivos conectados, elegir uno y leer sus detalles.
Ver la pantallaHacer capturas de pantalla y leer los textos y los botones de la pantalla.
TocarTocar, tocar un texto, tocar dos veces, mantener presionado, deslizar, desplazarse y pellizcar.
EscribirEscribir texto, presionar teclas y ocultar el teclado.
SistemaUsar los botones de inicio, bloqueo y volumen, activar Siri, abrir el Centro de control o el selector de apps, y girar la pantalla.
AppsVer la lista de apps, abrirlas, cerrarlas, instalarlas y desinstalarlas, y abrir enlaces.
Build & RunCompilar tu proyecto de Xcode y ejecutarlo en el dispositivo. Consulta Build & Run.
DepuraciónLeer informes de fallos y descargar los datos de una app.
GrabaciónIniciar y detener una grabación de pantalla.
Pedirte ayudaPedirte que intervengas, por ejemplo, para Face ID o un código. Consulta Human Handoff.

Tu cliente MCP muestra la lista completa de herramientas de tu versión de Device MCP.

5. Mantén el control

  • Aprobaciones: Device MCP te pregunta antes de que el agente instale o elimine apps, compile, abra enlaces o descargue datos de apps. Consulta Aprobaciones.
  • Actividad: todas las acciones de tu agente aparecen en la pestaña Agent. Consulta Actividad del agente.
  • Agent is driving: el estado en la parte inferior de la pantalla duplicada y un ✨ junto al dispositivo en la barra lateral indican cuándo un agente está usando el dispositivo.
  • Toma el control cuando quieras: tus clics y lo que tecleas siempre llegan al dispositivo, incluso mientras trabaja un agente.