开启 MCP Server
打开「设置 → MCP」，开启本机 MCP Server。它只监听 http://127.0.0.1:<port>/mcp。
MCP SERVER
把真实 iPhone / 安卓交给 Claude Code。
StupidMirror 通过一个带认证、只监听本机的 MCP Server 提供已连接的设备。它不内置模型，也不需要模型 API Key，只是把真机交给你正在用的 Agent。
接入 MCP 客户端
Codex 用户也可以直接点「连接 Codex」使用内置插件。Claude Code 和其他客户端使用自动生成的配置。
选择客户端
在「高级连接设置 · 其他 AI 客户端」的连接向导里，选择 Codex 或 Claude Code。
复制配置
把生成的配置或命令复制到对应客户端。其中包含地址、Bearer 认证，以及 240 秒的工具超时，留给首次控制连接的较长准备时间。
向 Agent 提问
保持 StupidMirror 打开，试试：「列出已连接的设备，开始镜像我的 iPhone，并标出可点击元素，先不要点击。」
观察、操作、验证
连接
list_devices、show_screen、connect_control 负责找到目标设备并准备所需的会话。
观察
observe_screen、find_any_element 读取实时画面并做本地 OCR，只在需要时才获取无障碍信息。
操作
tap_text、tap_element、replace_text、swipe 针对已观察到的内容或明确的手势执行操作。
验证
wait_for、assert_screen、observe_screen 在真机上检查操作结果。
只标注不点击
highlight_clickable_elements、highlight_elements 在 Mac 镜像上画出目标，不向手机发送任何操作。
应用与录屏
install_app 安装 .app、.ipa 或 .apk；open_url 打开深链；start_recording 把镜像录成最长 10 分钟的 .mp4。
本机服务，数据规则由 AI 客户端决定
采集、播放和 OCR 都在这台 Mac 上完成，StupidMirror 不会自行把镜像内容上传给模型服务商。通过 MCP 接入的 AI 客户端会收到它请求的截图和工具结果，之后如何处理取决于该客户端的数据设置。轮换 Bearer 令牌会让旧凭据失效。
Agent 开发者常见问题
需要模型 API Key 吗？
不需要。StupidMirror 不内置模型，模型由你的 MCP 客户端提供，StupidMirror 只提供设备工具。
支持哪些客户端？
Codex 通过内置插件接入，Claude Code 通过生成的命令接入，其他 MCP 客户端通过生成的配置（含 Bearer 认证）接入。
为什么第一次操作比较慢？
首次建立控制连接需要一些时间，所以生成的配置把工具超时设为 240 秒。
连了多台设备怎么指定？
传入 device_id。先调用 list_devices 查看设备标识。
Agent 怎么修改 iOS 输入框？
聚焦输入框后，直接用 replace_text 或 clear_text，追加内容用 type_text。获取无障碍快照可能打断已聚焦的输入框，替换操作会校验最终的值。
OCR 支持哪些语言？
Apple Vision OCR 默认识别中文和英文，提供快速与精确两种模式，按需运行，不占用采集链路。