本文へスキップ
ブラックフライデー:30% オフ今週限定BF2026今すぐ購入 →バンドルの詳細を見る
Device MCP

AI エージェント

ヘッドレスモード

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 を実行しているターミナルにも表示され、そこで次のように入力できます。

入力内容
yAllow Once
aAlways Allow
nDeny
doneデバイスでの操作(Face ID、パスコードなど)が終わったことを伝えます。
statusDevice MCP の MCP サーバー、ライセンス、デバイスを表示します。
quitDevice MCP を終了します。

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

device-mcp-cli headless --allow all

5. オプション

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