Dépannage
Solutions aux problèmes courants avec Device MCP, d'un appareil qui n'apparaît pas à un agent qui ne parvient pas à se connecter.
1. Mon appareil n'apparaît pas
- Vérifiez que l'appareil exécute iOS 27 ou iPadOS 27 ou version ultérieure.
- Déverrouillez l'appareil et touchez Se fier s'il vous le demande.
- Si macOS a affiché Autoriser l'accessoire à se connecter ?, cliquez sur Autoriser.
- Essayez un autre câble ou un autre port. Certains câbles servent uniquement à la recharge.
- En Wi-Fi, vérifiez que votre Mac et l'appareil sont sur le même réseau, et contrôlez le réglage Settings → General → Connection dans Device MCP.
2. La recopie s'est arrêtée ou figée
Cliquez sur Reconnect dans le menu More (…), ou appuyez sur ⇧⌘R.
Si Device MCP indique qu'une autre app recopie l'appareil, par exemple le Device Hub de Xcode, arrêtez la recopie dans cette app, puis cliquez sur Reconnect. Un appareil ne peut être recopié que par une seule app à la fois.
3. Le toucher ou la saisie ne fonctionnent pas
- Cliquez une fois sur l'écran recopié pour que vos frappes soient envoyées à l'appareil.
- Pour les autres langues et les emoji, touchez Autoriser quand iOS affiche la demande Allow Paste (autoriser le collage).
- Sur l'appareil, ouvrez Réglages → Développeur et vérifiez que Enable UI Automation est activé. Consultez iPhone et iPad.
4. L'appareil ne conserve pas son orientation
iOS ne conserve une orientation que lorsque l'appareil est posé à plat. Posez-le sur la table et faites-le pivoter de nouveau.
5. Mon agent ne trouve pas Device MCP
- Ouvrez Device MCP, et activez Settings → MCP → Enable MCP Server.
- Vérifiez que vous disposez de Device MCP Pro.
- Vérifiez que Device MCP se trouve dans votre dossier Applications. La configuration indiquée sur la page MCP pointe vers cet emplacement.
- Redémarrez votre agent après avoir ajouté Device MCP.
6. Mon agent arrête d'attendre
La compilation de votre app ou l'attente de votre approbation peuvent prendre quelques minutes. Dans Codex, définissez tool_timeout_sec = 900 comme indiqué sur la page MCP.
7. Build & Run échoue
- Ouvrez le projet dans Xcode et vérifiez qu'il se compile pour un appareil, avec la signature automatique.
- Lisez le journal dans l'onglet Build & Run pour en connaître la raison.
- En Wi-Fi, branchez le câble et réessayez.
8. Toujours besoin d'aide ?
Choisissez Help → Export Diagnostics… dans Device MCP. Un fichier est enregistré sur votre Mac, sans que rien ne soit envoyé. Ensuite, contactez-nous en joignant le fichier, et nous vous répondrons.