# 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 <kbd>⇧⌘R</kbd>.

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](../devices/iphone-and-ipad.md#1-prepare-your-device).

## 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](../license.md) hast.
* Prüfe, ob Device MCP in deinem Ordner **Programme** liegt. Die Konfiguration auf der Seite [MCP](../ai-agents/mcp.md) 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](../ai-agents/mcp.md#codex) 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](/contact) dann und hänge die Datei an – wir melden uns bei dir.