# Modo headless

Execute o Device MCP no modo headless, sem janela, em um terminal, para seu agente de IA usar seus dispositivos em um Mac que ninguém acompanha.

O Device MCP pode rodar no modo headless: sem janela, sem ícone no Dock e sem item na barra de menus. Ele roda em um terminal, e seu agente de IA usa seu iPhone, iPad, Apple Watch, dispositivos Android, simuladores e emuladores pelo [MCP](mcp.md), do mesmo jeito que faz com a janela aberta. O agente mostra o que vê em capturas de tela.

Use em um Mac que ninguém olha, como uma máquina de CI ou um Mac mini que você acessa por SSH, ou quando você prefere ficar no terminal.

## 1. Inicie o Device MCP no modo headless
Execute isto em um terminal (o `device-mcp-cli` é a [linha de comando](../command-line.md) do Device MCP):

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

O Device MCP inicia ali mesmo e mostra o que acontece: os dispositivos conforme se conectam, cada ação do seu agente e tudo o que precisa de você. Pressione **Control-C** para encerrar.

Para deixá-lo rodando em segundo plano, ou para abri-lo sem um terminal:

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

Encerre-o com `device-mcp-cli app quit`.

{% hint style="info" %}
Só um Device MCP roda por vez. Se ele estiver aberto com a janela, encerre-o antes.
{% endhint %}

## 2. Conecte seu agente
Configure seu agente como na página [MCP](mcp.md). Enquanto o Device MCP roda no modo headless, o servidor MCP dele fica sempre ativado.

Para seu agente iniciar o Device MCP no modo headless por conta própria quando precisar de um dispositivo, adicione `--headless` ao final do comando de configuração:

```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. Veja o que seu agente vê
Não há janela para acompanhar, então seu agente enxerga por você. Ele sabe quando o Device MCP está no modo headless e mostra capturas de tela das etapas que importam. Peça mais quando quiser: "mostre a tela". Ele também pode salvar capturas e gravações de tela no seu Mac.

Seu agente pode fazer tudo o que você faria na janela: alterar as configurações do Device MCP, iniciar e gerenciar simuladores e emuladores, compilar seus projetos, gerenciar a licença e exportar diagnósticos. As atualizações de software e o Factory Reset continuam só na janela.

## 4. Aprovações e Human Handoff
As [aprovações](approvals.md) e o [Human Handoff](human-handoff.md) continuam consultando você. Os pedidos chegam como notificações do macOS, com botões para responder, e aparecem no terminal em que o Device MCP está rodando, onde você pode digitar:

| Digite | O que faz |
| --- | --- |
| `y` | **Allow Once** |
| `a` | **Always Allow** |
| `n` | **Deny** |
| `done` | Você terminou no dispositivo (Face ID, um código…). |
| `status` | O servidor MCP, a licença e os dispositivos do Device MCP. |
| `quit` | Encerra o Device MCP. |

Em um Mac que ninguém acompanha, permita as ações de que seu agente precisa nessa execução:

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

{% hint style="warning" %}
Com `--allow`, seu agente instala apps, compila e executa, abre links e usa a área de transferência sem perguntar, até o Device MCP ser encerrado. Desfazer o pareamento de um dispositivo e remover a licença sempre pedem confirmação.
{% endhint %}

## 5. Opções
| Opção | O que faz |
| --- | --- |
| `--allow <actions>` | Executa essas ações sem perguntar, só nesta execução: `all` ou nomes separados por vírgulas. |
| `--port <port>` | A porta do servidor MCP nesta execução. |
| `--json` | Imprime um objeto JSON por linha, para scripts. |
| `--verbose` | Também mostra o log do Device MCP. |
