ヘッドレスモード
Device MCP をウインドウなしでターミナルから実行し、誰も見ていない Mac でも AI エージェントがデバイスを使えるようにします。
Device MCP はウインドウなしで実行できます。ウインドウも、Dock のアイコンも、メニューバーの項目もありません。Device MCP はターミナルで動作し、AI エージェントは MCP を通じて、ウインドウを開いているときと同じように iPhone、iPad、Apple Watch、Android デバイス、シミュレータ、エミュレータを使えます。エージェントは、見ている画面をスクリーンショットであなたに見せます。
CI マシンや SSH で接続する Mac mini など、誰も画面を見ていない Mac で使えます。ターミナルから離れずに作業したいときにも便利です。
1. Device MCP をヘッドレスで起動する
ターミナルで次のコマンドを実行します(device-mcp-cli は Device MCP のコマンドラインです)。
device-mcp-cli headless
Device MCP はそのターミナルで起動し、接続したデバイス、エージェントが行った操作、あなたの対応が必要なことを出力します。終了するには Control-C を押します。
バックグラウンドで動かし続ける場合や、ターミナルを使わずに開く場合は、次のようにします。
device-mcp-cli headless > device-mcp.log &
device-mcp-cli app open --headless
device-mcp-cli app quit で終了します。
2. エージェントを接続する
MCP のページの手順どおりにエージェントを設定します。Device MCP をヘッドレスで実行している間は、MCP サーバーは常にオンです。
デバイスが必要になったときに、エージェントが自分で Device MCP をヘッドレスで起動できるようにするには、設定コマンドの末尾に --headless を追加します。
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. エージェントが見ている画面を確認する
見るウインドウがないので、エージェントがあなたの目になります。エージェントは Device MCP がヘッドレスで動いていることを知っていて、重要なステップのスクリーンショットを見せます。もっと見たいときは、いつでも「画面を見せて」と頼んでください。スクリーンショットや画面収録を Mac に保存することもできます。
ウインドウでできることは、エージェントがすべて行えます。Device MCP の設定の変更、シミュレータやエミュレータの起動と管理、プロジェクトのビルド、ライセンスの管理、診断情報の書き出しなどです。Device MCP のアップデートと Factory Reset は、ウインドウでのみ行えます。
4. 承認と Human Handoff
ヘッドレスでも、承認と Human Handoff はこれまでどおりあなたに確認します。確認はボタン付きの macOS の通知で届くほか、Device MCP を実行しているターミナルにも表示され、そこで次のように入力できます。
| 入力 | 内容 |
|---|---|
y | Allow Once |
a | Always Allow |
n | Deny |
done | デバイスでの操作(Face ID、パスコードなど)が終わったことを伝えます。 |
status | Device MCP の MCP サーバー、ライセンス、デバイスを表示します。 |
quit | Device MCP を終了します。 |
誰も見ていない Mac では、エージェントに必要な操作を、その実行の間だけ許可しておきます。
device-mcp-cli headless --allow all
5. オプション
| オプション | 内容 |
|---|---|
--allow <actions> | 指定した操作を、今回の実行に限り確認なしで行います。all か、カンマ区切りの操作名を指定します。 |
--port <port> | 今回の実行で使う MCP サーバーのポートです。 |
--json | スクリプト向けに、1 行に 1 つの JSON オブジェクトを出力します。 |
--verbose | Device MCP のログも出力します。 |