# 无窗口模式

在终端中以无窗口模式运行 Device MCP，让 AI Agent 在无人看管的 Mac 上使用你的设备。

Device MCP 可以无窗口（headless）运行：没有窗口，没有程序坞图标，也没有菜单栏图标。它在终端中运行，你的 AI Agent 通过 [MCP](mcp.md) 使用你的 iPhone、iPad、Apple Watch、Android 设备和模拟器，与打开窗口时完全一样。Agent 会用截图把它看到的内容展示给你。

它适合用在无人看管的 Mac 上，例如 CI 机器或通过 SSH 访问的 Mac mini，也适合更想留在终端里的时候。

## 1. 以无窗口模式启动 Device MCP
在终端中运行以下命令（`device-mcp-cli` 是 Device MCP 的[命令行工具](../command-line.md)）：

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

Device MCP 会直接在终端中启动，并输出发生的一切：设备的连接、Agent 执行的每个操作，以及需要你处理的事项。按 **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。如果它已经带窗口打开，请先退出。
{% endhint %}

## 2. 连接 Agent
按照 [MCP](mcp.md) 页面的说明设置 Agent。Device MCP 以无窗口模式运行时，它的 MCP 服务器始终开启。

如果想让 Agent 在需要设备时自行以无窗口模式启动 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. 查看 Agent 看到的内容
没有窗口可看，Agent 就是你的眼睛。它知道 Device MCP 正以无窗口模式运行，会把关键步骤的截图展示给你。你随时可以让它多给你看一些：“给我看看屏幕”。它还可以把截图和录屏保存到你的 Mac 上。

你在窗口中能做的事，Agent 都能做：更改 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 上，可以为本次运行预先允许 Agent 需要的操作：

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

{% hint style="warning" %}
`--allow` 会让 Agent 无需询问即可安装 App、构建并运行、打开链接和使用剪贴板，直到 Device MCP 退出。解除设备配对和移除许可证始终会询问。
{% endhint %}

## 5. 选项
| 选项 | 作用 |
| --- | --- |
| `--allow <actions>` | 本次运行中无需询问即可执行这些操作：`all`，或用逗号分隔的操作名称。 |
| `--port <port>` | 本次运行中 MCP 服务器使用的端口。 |
| `--json` | 每行输出一个 JSON 对象，供脚本使用。 |
| `--verbose` | 同时输出 Device MCP 的日志。 |
