Pular para o conteúdo
Black Friday: 30% de descontoSó esta semanaBF2026Ver oferta →Conheça o pacote
Device MCP

Agentes de IA

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:

DigiteO que faz
yAllow Once
aAlways Allow
nDeny
doneVocê terminou no dispositivo (Face ID, um código…).
statusO servidor MCP, a licença e os dispositivos do Device MCP.
quitEncerra 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çãoO 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.
--jsonImprime um objeto JSON por linha, para scripts.
--verboseTambém mostra o log do Device MCP.