# Modo headless

Ejecuta Device MCP en modo headless, sin ventana y desde una terminal, para que tu agente de IA use tus dispositivos en un Mac que nadie vigila.

Device MCP puede ejecutarse en modo headless (sin ventana): sin ventana, sin icono en el Dock y sin elemento en la barra de menús. Se ejecuta en una terminal, y tu agente de IA usa tu iPhone, iPad, Apple Watch, dispositivos Android, simuladores y emuladores a través de [MCP](mcp.md), igual que con la ventana abierta. Tu agente te muestra lo que ve con capturas de pantalla.

Úsalo en un Mac que nadie mira, como una máquina de CI o un Mac mini al que accedes por SSH, o cuando prefieras no salir de la terminal.

## 1. Inicia Device MCP en modo headless
Ejecuta esto en una terminal (`device-mcp-cli` es la [línea de comandos](../command-line.md) de Device MCP):

```bash
device-mcp-cli headless
```

Device MCP se inicia ahí mismo y muestra lo que ocurre: los dispositivos a medida que se conectan, cada acción de tu agente y todo lo que requiere tu atención. Presiona **Control-C** para cerrarlo.

Para dejarlo ejecutándose en segundo plano, o para abrirlo sin una terminal:

```bash
device-mcp-cli headless > device-mcp.log &
device-mcp-cli app open --headless
```

Detenlo con `device-mcp-cli app quit`.

{% hint style="info" %}
Solo puede ejecutarse un Device MCP a la vez. Si está abierto con su ventana, ciérralo primero.
{% endhint %}

## 2. Conecta tu agente
Configura tu agente como se indica en la página [MCP](mcp.md). Mientras Device MCP se ejecuta en modo headless, su servidor MCP siempre está activado.

Para que tu agente inicie Device MCP en modo headless por sí solo cuando necesite un dispositivo, añade `--headless` al final del comando de configuración:

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

```bash
codex mcp add device-mcp -- "/Applications/Device MCP.app/Contents/MacOS/device-mcp" --headless
```

## 3. Mira lo que ve tu agente
No hay ninguna ventana que mirar, así que tu agente hace de tus ojos. Sabe cuándo Device MCP se ejecuta en modo headless y te muestra capturas de pantalla de los pasos importantes. Pídele más cuando quieras: "muéstrame la pantalla". También puede guardar capturas de pantalla y grabaciones en tu Mac.

Tu agente puede hacer todo lo que harías tú en la ventana: cambiar los ajustes de Device MCP, iniciar y gestionar simuladores y emuladores, compilar tus proyectos, gestionar la licencia y exportar diagnósticos. Las actualizaciones de software y **Factory Reset** solo están disponibles en la ventana.

## 4. Aprobaciones y Human Handoff
Las [aprobaciones](approvals.md) y [Human Handoff](human-handoff.md) te siguen pidiendo permiso. Llegan como notificaciones de macOS con sus botones, y también a la terminal donde se ejecuta Device MCP, donde puedes escribir:

| Escribe | Qué hace |
| --- | --- |
| `y` | **Allow Once** |
| `a` | **Always Allow** |
| `n` | **Deny** |
| `done` | Ya terminaste en el dispositivo (Face ID, un código…). |
| `status` | Muestra el estado del servidor MCP de Device MCP, de la licencia y de los dispositivos. |
| `quit` | Cierra Device MCP. |

En un Mac que nadie vigila, permite las acciones que tu agente necesita para esa ejecución:

```bash
device-mcp-cli headless --allow all
```

{% hint style="warning" %}
`--allow` deja que tu agente instale apps, compile y ejecute proyectos, abra enlaces y use el portapapeles sin preguntar, hasta que Device MCP se cierre. Desvincular un dispositivo y quitar la licencia siempre piden permiso.
{% endhint %}

## 5. Opciones
| Opción | Qué hace |
| --- | --- |
| `--allow <actions>` | Realiza estas acciones sin preguntar, solo durante esta ejecución: `all`, o sus nombres separados por comas. |
| `--port <port>` | El puerto del servidor MCP durante esta ejecución. |
| `--json` | Muestra un objeto JSON por línea, para scripts. |
| `--verbose` | Muestra también el registro de Device MCP. |
