# トラブルシューティング

デバイスが表示されない、エージェントが接続できないなど、Device MCP でよくある問題の解決方法です。

## 1. デバイスが表示されない
* デバイスが iOS 27 または iPadOS 27 以降であることを確認します。
* デバイスのロックを解除し、確認が表示されたら**信頼**をタップします。
* macOS で「**アクセサリの接続を許可しますか？**」と表示された場合は、**許可**をクリックします。
* 別のケーブルやポートを試してください。充電専用のケーブルもあります。
* Wi-Fi 経由の場合は、Mac とデバイスが同じネットワークにあることを確認し、Device MCP の **Settings → General → Connection** を確認します。

## 2. ミラーリングが停止した、または固まった
**More (…)** メニューの **Reconnect** をクリックするか、<kbd>⇧⌘R</kbd> を押します。

Xcode の Device Hub など、別のアプリがデバイスをミラーリングしていると Device MCP に表示された場合は、そのアプリでミラーリングを終了してから **Reconnect** をクリックします。デバイスを同時にミラーリングできるのは 1 つのアプリだけです。

## 3. タップや入力が効かない
* キー入力がデバイスに送られるよう、ミラー画面を一度クリックします。
* 他の言語や絵文字を入力するときに iOS がペーストの許可を求めたら、**ペーストを許可**をタップします。
* デバイスで**設定 → デベロッパ**を開き、**Enable UI Automation**（UI オートメーションを有効にする）がオンになっていることを確認します。[iPhone と iPad](../devices/iphone-and-ipad.md#1-prepare-your-device) を参照してください。

## 4. デバイスの回転が元に戻る
iOS が回転した向きを保つのは、デバイスが平らに置かれている間だけです。デバイスを机の上に置いて、もう一度回転してください。

## 5. エージェントが Device MCP を見つけられない
* Device MCP を開き、**Settings → MCP → Enable MCP Server** をオンにします。
* [Device MCP Pro](../license.md) のライセンスがあることを確認します。
* Device MCP が**アプリケーション**フォルダにあることを確認します。[MCP](../ai-agents/mcp.md) ページの設定は、その場所を指しています。
* Device MCP を追加したあとは、エージェントを再起動します。

## 6. エージェントが待機をやめてしまう
アプリのビルドや、あなたの承認待ちには数分かかることがあります。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)ください。折り返しご連絡します。