# 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](mcp.md), 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](../command-line.md) von Device MCP):

```bash
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:

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

Beende es mit `device-mcp-cli app quit`.

{% hint style="info" %}
Device MCP läuft immer nur einmal. Ist es mit seinem Fenster geöffnet, beende es zuerst.
{% endhint %}

## 2. Deinen Agenten verbinden
Richte deinen Agenten wie auf der Seite [MCP](mcp.md) 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:

```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. 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](approvals.md) und [Human Handoff](human-handoff.md) 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:

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

{% hint style="warning" %}
Mit `--allow` installiert dein Agent Apps, startet Build & Run, öffnet Links und nutzt die Zwischenablage ohne Rückfrage, bis Device MCP beendet wird. Vor dem Entkoppeln eines Geräts und dem Entfernen der Lizenz fragt Device MCP immer nach.
{% endhint %}

## 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. |
