Mode headless
Exécutez Device MCP sans sa fenêtre, dans un terminal, pour que votre agent IA utilise vos appareils sur un Mac que personne ne surveille.
Device MCP peut fonctionner en mode headless (sans interface) : ni fenêtre, ni icône dans le Dock, ni élément dans la barre des menus. Il s'exécute dans un terminal, et votre agent IA utilise vos iPhone, iPad, Apple Watch, appareils Android, simulateurs et émulateurs via MCP, comme lorsque la fenêtre est ouverte. Votre agent vous montre ce qu'il voit avec des captures d'écran.
Utilisez-le sur un Mac que personne ne regarde, comme une machine de CI ou un Mac mini auquel vous accédez en SSH, ou quand vous préférez rester dans le terminal.
1. Lancer Device MCP en mode headless
Exécutez ceci dans un terminal (device-mcp-cli est la ligne de commande de Device MCP) :
device-mcp-cli headless
Device MCP démarre aussitôt dans le terminal et affiche ce qui se passe : les appareils à mesure qu'ils se connectent, chaque action de votre agent, et tout ce qui nécessite votre intervention. Appuyez sur Control-C pour quitter.
Pour le laisser tourner en arrière-plan, ou pour l'ouvrir sans terminal :
device-mcp-cli headless > device-mcp.log &
device-mcp-cli app open --headless
Arrêtez-le avec device-mcp-cli app quit.
2. Connecter votre agent
Configurez votre agent comme indiqué sur la page MCP. Quand Device MCP s'exécute en mode headless, son serveur MCP est toujours activé.
Pour que votre agent lance lui-même Device MCP en mode headless quand il a besoin d'un appareil, ajoutez --headless à la fin de la commande de configuration :
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. Voir ce que voit votre agent
Il n'y a pas de fenêtre à regarder : votre agent voit à votre place. Il sait quand Device MCP s'exécute en mode headless et vous montre des captures d'écran des étapes importantes. Demandez-en d'autres à tout moment : « montre-moi l'écran ». Il peut aussi enregistrer des captures d'écran et des vidéos de l'écran sur votre Mac.
Votre agent peut faire tout ce que vous feriez dans la fenêtre : modifier les réglages de Device MCP, démarrer et gérer les simulateurs et les émulateurs, compiler vos projets, gérer la licence et exporter des diagnostics. Seules les mises à jour logicielles et Factory Reset nécessitent la fenêtre.
4. Approbations et Human Handoff
Les approbations et Human Handoff vous demandent toujours votre accord. Les demandes arrivent sous forme de notifications macOS, avec leurs boutons, et dans le terminal où s'exécute Device MCP. Vous pouvez y saisir :
| Saisie | Effet |
|---|---|
y | Allow Once |
a | Always Allow |
n | Deny |
done | Vous avez terminé sur l'appareil (Face ID, un code d'accès…). |
status | L'état du serveur MCP, de la licence et des appareils de Device MCP. |
quit | Quitte Device MCP. |
Sur un Mac que personne ne surveille, autorisez à l'avance les actions dont votre agent a besoin pour cette exécution :
device-mcp-cli headless --allow all
5. Options
| Option | Effet |
|---|---|
--allow <actions> | Autorise ces actions sans demander, pour cette exécution : all, ou des noms d'actions séparés par des virgules. |
--port <port> | Le port du serveur MCP pour cette exécution. |
--json | Affiche un objet JSON par ligne, pour les scripts. |
--verbose | Affiche aussi le journal de Device MCP. |