Zum Inhalt springen
Device MCP

Hilfe

Fehlerbehebung

Lösungen für häufige Probleme mit Device MCP – von einem Gerät, das nicht angezeigt wird, bis zu einem Agenten, der keine Verbindung bekommt.

1. Mein Gerät wird nicht angezeigt

  • Stelle sicher, dass auf dem Gerät iOS 27 oder iPadOS 27 oder neuer läuft.
  • Entsperre das Gerät und tippe auf Vertrauen, falls es danach fragt.
  • Hat macOS Allow accessory to connect? („Soll das Zubehör verbunden werden?“) gefragt, klicke auf Erlauben.
  • Probiere ein anderes Kabel oder einen anderen Anschluss. Manche Kabel können nur laden.
  • Über Wi-Fi: Stelle sicher, dass dein Mac und das Gerät im selben Netzwerk sind, und prüfe Settings → General → Connection in Device MCP.

2. Die Spiegelung ist stehen geblieben oder eingefroren

Klicke im Menü More (…) auf Reconnect oder drücke ⇧⌘R.

Meldet Device MCP, dass eine andere App das Gerät spiegelt, etwa der Device Hub von Xcode, beende die Spiegelung dort und klicke dann auf Reconnect. Ein Gerät kann immer nur von einer App gleichzeitig gespiegelt werden.

3. Tippen oder Texteingabe funktioniert nicht

  • Klicke einmal in die Spiegelung, damit deine Tastenanschläge an das Gerät gehen.
  • Bei anderen Sprachen und Emoji: Tippe auf Einsetzen erlauben, wenn iOS danach fragt.
  • Öffne auf dem Gerät Einstellungen → Entwickler und stelle sicher, dass Enable UI Automation (UI-Automatisierung aktivieren) eingeschaltet ist. Siehe iPhone & iPad.

4. Das Gerät bleibt nicht gedreht

iOS behält eine Drehung nur bei, solange das Gerät flach liegt. Lege es auf den Tisch und drehe es erneut.

5. Mein Agent findet Device MCP nicht

  • Öffne Device MCP und aktiviere Settings → MCP → Enable MCP Server.
  • Stelle sicher, dass du Device MCP Pro hast.
  • Prüfe, ob Device MCP in deinem Ordner Programme liegt. Die Konfiguration auf der Seite MCP verweist dorthin.
  • Starte deinen Agenten neu, nachdem du Device MCP hinzugefügt hast.

6. Mein Agent bricht das Warten ab

Das Bauen deiner App oder das Warten auf deine Freigabe kann ein paar Minuten dauern. Setze in Codex tool_timeout_sec = 900, wie auf der Seite MCP gezeigt.

7. Build & Run schlägt fehl

  • Öffne das Projekt in Xcode und stelle sicher, dass es sich mit automatischer Signierung für ein Gerät bauen lässt.
  • Im Log im Tab Build & Run siehst du, warum.
  • Über Wi-Fi: Schließe das Kabel an und versuche es erneut.

8. Weitere Hilfe nötig?

Wähle in Device MCP Help → Export Diagnostics…. Dadurch wird eine Datei auf deinem Mac gespeichert, gesendet wird nichts. Schreib uns dann und hänge die Datei an – wir melden uns bei dir.