# 故障排除

Device MCP 常见问题的解决方法，从设备不显示到 Agent 无法连接。

## 1. 设备没有显示
* 确保设备运行 iOS 27 / iPadOS 27 或更高版本。
* 解锁设备，如果出现询问，请轻点**信任**。
* 如果 macOS 询问 **Allow accessory to connect?**（要允许配件连接吗？），请点击**允许**。
* 换一根数据线或换一个端口试试。有些数据线只能充电。
* 如果通过 Wi-Fi 连接，请确保 Mac 和设备连接在同一网络中，并检查 Device MCP 中的 **Settings → General → Connection**。

## 2. 镜像停止或卡住
在 **More (…)** 菜单中点击 **Reconnect**，或按下 <kbd>⇧⌘R</kbd>。

如果 Device MCP 提示有其他 App 正在镜像该设备（例如 Xcode 的 Device Hub），请先在那个 App 中关闭镜像，然后点击 **Reconnect**。一台设备同一时间只能由一个 App 镜像。

## 3. 轻点或输入无效
* 点击一次镜像画面，让按键发送到设备。
* 输入其他语言的文字和表情符号时，如果 iOS 询问是否**允许粘贴**，请轻点**允许粘贴**。
* 在设备上打开**设置 → 开发者**，确保 **Enable UI Automation**（启用 UI 自动化）已打开。请参阅 [iPhone 和 iPad](../devices/iphone-and-ipad.md#1-prepare-your-device)。

## 4. 设备无法保持旋转
只有设备平放时，iOS 才会保持旋转方向。请将设备平放在桌面上，然后再次旋转。

## 5. Agent 找不到 Device MCP
* 打开 Device MCP，然后打开 **Settings → MCP → Enable MCP Server**。
* 确保你拥有 [Device MCP Pro](../license.md)。
* 检查 Device MCP 是否位于**应用程序**文件夹中。[MCP](../ai-agents/mcp.md) 页面中的配置指向的就是这个位置。
* 添加 Device MCP 后，重启 Agent。

## 6. Agent 等待超时
构建 App 或等待你审批可能需要几分钟。在 Codex 中，请按照 [MCP](../ai-agents/mcp.md#codex) 页面所示设置 `tool_timeout_sec = 900`。

## 7. Build & Run 失败
* 在 Xcode 中打开项目，确保它能使用自动签名为设备构建。
* 查看 **Build & Run** 标签页中的日志，了解失败原因。
* 如果通过 Wi-Fi 连接，请接上数据线后重试。

## 8. 仍需帮助？
在 Device MCP 中选择 **Help → Export Diagnostics…**。它会在你的 Mac 上保存一个文件，不会发送任何内容。然后[联系我们](/contact)并附上该文件，我们会给你回复。