トラブルシューティング

1. デバイスが表示されない#

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

2. ミラーリングが停止した、または固まった#

More (…) メニューの Reconnect をクリックするか、⇧⌘R を押します。

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

3. タップや入力が効かない#

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

4. デバイスの回転が元に戻る#

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

5. エージェントが Device MCP を見つけられない#

• Device MCP を開き、Settings → MCP → Enable MCP Server をオンにします。
• Device MCP Pro のライセンスがあることを確認します。
• Device MCP がアプリケーションフォルダにあることを確認します。MCP ページの設定は、その場所を指しています。
• Device MCP を追加したあとは、エージェントを再起動します。

6. エージェントが待機をやめてしまう#

アプリのビルドや、あなたの承認待ちには数分かかることがあります。Codex では、MCP ページのとおり tool_timeout_sec = 900 を設定してください。

7. Build & Run が失敗する#

• Xcode でプロジェクトを開き、自動署名でデバイス向けにビルドできることを確認します。
• Build & Run タブのログで原因を確認します。
• Wi-Fi 経由の場合は、ケーブルを接続してもう一度試します。

8. それでも解決しない場合#

Device MCP で Help → Export Diagnostics… を選択します。Mac にファイルが保存されるだけで、何も送信されません。そのうえで、ファイルを添付してお問い合わせください。折り返しご連絡します。