无窗口模式
在终端中以无窗口模式运行 Device MCP,让 AI Agent 在无人看管的 Mac 上使用你的设备。
Device MCP 可以无窗口(headless)运行:没有窗口,没有程序坞图标,也没有菜单栏图标。它在终端中运行,你的 AI Agent 通过 MCP 使用你的 iPhone、iPad、Apple Watch、Android 设备和模拟器,与打开窗口时完全一样。Agent 会用截图把它看到的内容展示给你。
它适合用在无人看管的 Mac 上,例如 CI 机器或通过 SSH 访问的 Mac mini,也适合更想留在终端里的时候。
1. 以无窗口模式启动 Device MCP
在终端中运行以下命令(device-mcp-cli 是 Device MCP 的命令行工具):
device-mcp-cli headless
Device MCP 会直接在终端中启动,并输出发生的一切:设备的连接、Agent 执行的每个操作,以及需要你处理的事项。按 Control-C 退出。
要让它在后台一直运行,或不依赖终端打开它:
device-mcp-cli headless > device-mcp.log &
device-mcp-cli app open --headless
用 device-mcp-cli app quit 停止它。
2. 连接 Agent
按照 MCP 页面的说明设置 Agent。Device MCP 以无窗口模式运行时,它的 MCP 服务器始终开启。
如果想让 Agent 在需要设备时自行以无窗口模式启动 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. 查看 Agent 看到的内容
没有窗口可看,Agent 就是你的眼睛。它知道 Device MCP 正以无窗口模式运行,会把关键步骤的截图展示给你。你随时可以让它多给你看一些:“给我看看屏幕”。它还可以把截图和录屏保存到你的 Mac 上。
你在窗口中能做的事,Agent 都能做:更改 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 上,可以为本次运行预先允许 Agent 需要的操作:
device-mcp-cli headless --allow all
5. 选项
| 选项 | 作用 |
|---|---|
--allow <actions> | 本次运行中无需询问即可执行这些操作:all,或用逗号分隔的操作名称。 |
--port <port> | 本次运行中 MCP 服务器使用的端口。 |
--json | 每行输出一个 JSON 对象,供脚本使用。 |
--verbose | 同时输出 Device MCP 的日志。 |