Headless-Modus
Führe Device MCP ohne Fenster im Terminal aus (headless), damit dein KI-Agent deine Geräte auch auf einem Mac nutzen kann, vor dem niemand sitzt.
Device MCP kann auch ohne sein Fenster laufen, also headless: kein Fenster, kein Dock-Symbol, kein Symbol in der Menüleiste. Es läuft in einem Terminal, und dein KI-Agent nutzt dein iPhone, iPad, deine Apple Watch, deine Android-Geräte, Simulatoren und Emulatoren über MCP, genau wie bei geöffnetem Fenster. Was er sieht, zeigt dir dein Agent mit Bildschirmfotos.
Das ist praktisch auf einem Mac, vor dem niemand sitzt, etwa einem CI-Rechner oder einem Mac mini, auf den du per SSH zugreifst, oder wenn du lieber im Terminal bleibst.
1. Device MCP headless starten
Führe das in einem Terminal aus (device-mcp-cli ist die Befehlszeile von Device MCP):
device-mcp-cli headless
Device MCP startet direkt im Terminal und gibt aus, was passiert: Geräte, sobald sie sich verbinden, jede Aktion deines Agenten und alles, was auf dich wartet. Drücke Control-C, um es zu beenden.
Um es im Hintergrund laufen zu lassen oder ohne Terminal zu öffnen:
device-mcp-cli headless > device-mcp.log &
device-mcp-cli app open --headless
Beende es mit device-mcp-cli app quit.
2. Deinen Agenten verbinden
Richte deinen Agenten wie auf der Seite MCP beschrieben ein. Solange Device MCP headless läuft, ist sein MCP-Server immer eingeschaltet.
Damit dein Agent Device MCP selbst headless startet, wenn er ein Gerät braucht, hänge --headless ans Ende des Einrichtungsbefehls:
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. Sehen, was dein Agent sieht
Es gibt kein Fenster, auf das du schauen kannst, also ist dein Agent deine Augen. Er weiß, wann Device MCP headless läuft, und zeigt dir Bildschirmfotos der wichtigen Schritte. Frag jederzeit nach mehr: „Zeig mir den Bildschirm.“ Er kann Bildschirmfotos und Aufnahmen auch auf deinem Mac speichern.
Dein Agent kann alles, was du im Fenster machen würdest: die Einstellungen von Device MCP ändern, Simulatoren und Emulatoren starten und verwalten, deine Projekte bauen, die Lizenz verwalten und Diagnosedaten exportieren. Software-Updates und Factory Reset gibt es nur im Fenster.
4. Freigaben und Human Handoff
Freigaben und Human Handoff fragen weiterhin bei dir nach. Die Abfragen erscheinen als macOS-Mitteilungen mit ihren Buttons und im Terminal, in dem Device MCP läuft. Dort kannst du eingeben:
| Eingabe | Funktion |
|---|---|
y | Allow Once |
a | Always Allow |
n | Deny |
done | Du bist auf dem Gerät fertig (Face ID, Gerätecode …). |
status | Zeigt MCP-Server, Lizenz und Geräte von Device MCP. |
quit | Beendet Device MCP. |
Auf einem Mac, vor dem niemand sitzt, erlaubst du vorab die Aktionen, die dein Agent für diesen Lauf braucht:
device-mcp-cli headless --allow all
5. Optionen
| Option | Funktion |
|---|---|
--allow <actions> | Führt diese Aktionen in diesem Lauf ohne Rückfrage aus: all oder durch Kommas getrennte Namen. |
--port <port> | Der Port des MCP-Servers für diesen Lauf. |
--json | Gibt ein JSON-Objekt pro Zeile aus, für Skripte. |
--verbose | Gibt zusätzlich das Log von Device MCP aus. |