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, 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 do Device MCP):
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:
device-mcp-cli headless > device-mcp.log &
device-mcp-cli app open --headless
Encerre-o com device-mcp-cli app quit.
2. Conecte seu agente
Configure seu agente como na página MCP. 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:
claude mcp add --scope user device-mcp -- "/Applications/Device MCP.app/Contents/MacOS/device-mcp" --headless
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 e o Human Handoff 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:
device-mcp-cli headless --allow all
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. |