# ヘッドレスモード

Device MCP をウインドウなしでターミナルから実行し、誰も見ていない Mac でも AI エージェントがデバイスを使えるようにします。

Device MCP はウインドウなしで実行できます。ウインドウも、Dock のアイコンも、メニューバーの項目もありません。Device MCP はターミナルで動作し、AI エージェントは [MCP](mcp.md) を通じて、ウインドウを開いているときと同じように iPhone、iPad、Apple Watch、Android デバイス、シミュレータ、エミュレータを使えます。エージェントは、見ている画面をスクリーンショットであなたに見せます。

CI マシンや SSH で接続する Mac mini など、誰も画面を見ていない Mac で使えます。ターミナルから離れずに作業したいときにも便利です。

## 1. Device MCP をヘッドレスで起動する
ターミナルで次のコマンドを実行します（`device-mcp-cli` は Device MCP の[コマンドライン](../command-line.md)です）。

```bash
device-mcp-cli headless
```

Device MCP はそのターミナルで起動し、接続したデバイス、エージェントが行った操作、あなたの対応が必要なことを出力します。終了するには **Control-C** を押します。

バックグラウンドで動かし続ける場合や、ターミナルを使わずに開く場合は、次のようにします。

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

`device-mcp-cli app quit` で終了します。

{% hint style="info" %}
一度に実行できる Device MCP は 1 つだけです。ウインドウ付きで開いている場合は、先に終了してください。
{% endhint %}

## 2. エージェントを接続する
[MCP](mcp.md) のページの手順どおりにエージェントを設定します。Device MCP をヘッドレスで実行している間は、MCP サーバーは常にオンです。

デバイスが必要になったときに、エージェントが自分で Device MCP をヘッドレスで起動できるようにするには、設定コマンドの末尾に `--headless` を追加します。

```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. エージェントが見ている画面を確認する
見るウインドウがないので、エージェントがあなたの目になります。エージェントは Device MCP がヘッドレスで動いていることを知っていて、重要なステップのスクリーンショットを見せます。もっと見たいときは、いつでも「画面を見せて」と頼んでください。スクリーンショットや画面収録を Mac に保存することもできます。

ウインドウでできることは、エージェントがすべて行えます。Device MCP の設定の変更、シミュレータやエミュレータの起動と管理、プロジェクトのビルド、ライセンスの管理、診断情報の書き出しなどです。Device MCP のアップデートと Factory Reset は、ウインドウでのみ行えます。

## 4. 承認と Human Handoff
ヘッドレスでも、[承認](approvals.md)と [Human Handoff](human-handoff.md) はこれまでどおりあなたに確認します。確認はボタン付きの macOS の通知で届くほか、Device MCP を実行しているターミナルにも表示され、そこで次のように入力できます。

| 入力 | 内容 |
| --- | --- |
| `y` | **Allow Once** |
| `a` | **Always Allow** |
| `n` | **Deny** |
| `done` | デバイスでの操作（Face ID、パスコードなど）が終わったことを伝えます。 |
| `status` | Device MCP の MCP サーバー、ライセンス、デバイスを表示します。 |
| `quit` | Device MCP を終了します。 |

誰も見ていない Mac では、エージェントに必要な操作を、その実行の間だけ許可しておきます。

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

{% hint style="warning" %}
`--allow` を付けると、Device MCP が終了するまで、エージェントは確認なしでアプリのインストール、Build & Run、リンクを開く操作、クリップボードの使用ができます。デバイスのペアリング解除とライセンスの削除は、常に確認します。
{% endhint %}

## 5. オプション
| オプション | 内容 |
| --- | --- |
| `--allow <actions>` | 指定した操作を、今回の実行に限り確認なしで行います。`all` か、カンマ区切りの操作名を指定します。 |
| `--port <port>` | 今回の実行で使う MCP サーバーのポートです。 |
| `--json` | スクリプト向けに、1 行に 1 つの JSON オブジェクトを出力します。 |
| `--verbose` | Device MCP のログも出力します。 |
