# 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](../help/privacy-and-security.md).

### ✅ 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
| Ventaja | Descripción |
| --- | --- |
| **Pruebas en dispositivos reales** | Tu agente hace pruebas en un iPhone o iPad real, con el rendimiento, los sensores y las alertas del sistema reales. |
| **Desarrollo en ciclo cerrado** | Editar, 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 control** | Las acciones de riesgo piden permiso antes, todas las acciones quedan registradas y puedes tomar el control cuando quieras. |
| **Funciona con tu agente** | Claude 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:

```bash
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`:

```toml
[mcp_servers.device-mcp]
command = "/Applications/Device MCP.app/Contents/MacOS/device-mcp"
startup_timeout_sec = 30
tool_timeout_sec = 900
```

{% hint style="info" %}
Compilar tu app y esperar tu aprobación puede llevar unos minutos. `tool_timeout_sec` le da a Codex tiempo suficiente para esperar.
{% endhint %}

### Cursor y otros clientes MCP
Añade esto a la configuración MCP de tu cliente:

```json
{
  "mcpServers": {
    "device-mcp": {
      "command": "/Applications/Device MCP.app/Contents/MacOS/device-mcp",
      "args": []
    }
  }
}
```

4. **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."*

{% hint style="warning" %}
Si tu agente dice que el servidor MCP está desactivado, abre **Device MCP → Settings → MCP** y activa **Enable MCP Server**. Los agentes requieren [Device MCP Pro](../license.md).
{% endhint %}

## 4. Qué puede hacer tu agente
| Área | Qué puede hacer tu agente |
| --- | --- |
| **Dispositivos** | Ver la lista de tus dispositivos conectados, elegir uno y leer sus detalles. |
| **Ver la pantalla** | Hacer capturas de pantalla y leer los textos y los botones de la pantalla. |
| **Tocar** | Tocar, tocar un texto, tocar dos veces, mantener presionado, deslizar, desplazarse y pellizcar. |
| **Escribir** | Escribir texto, presionar teclas y ocultar el teclado. |
| **Sistema** | Usar los botones de inicio, bloqueo y volumen, activar Siri, abrir el Centro de control o el selector de apps, y girar la pantalla. |
| **Apps** | Ver la lista de apps, abrirlas, cerrarlas, instalarlas y desinstalarlas, y abrir enlaces. |
| **Build & Run** | Compilar tu proyecto de Xcode y ejecutarlo en el dispositivo. Consulta [Build & Run](build-and-run.md). |
| **Depuración** | Leer informes de fallos y descargar los datos de una app. |
| **Grabación** | Iniciar y detener una grabación de pantalla. |
| **Pedirte ayuda** | Pedirte que intervengas, por ejemplo, para Face ID o un código. Consulta [Human Handoff](human-handoff.md). |

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](approvals.md).
* **Actividad**: todas las acciones de tu agente aparecen en la pestaña **Agent**. Consulta [Actividad del agente](agent-activity.md).
* **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.