> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/french-documentation/telephones-cloud/control-cloud-phones-from-scripts.md).

# Contrôler les téléphones cloud à partir de scripts et de clients AI

Listez, démarrez, arrêtez et connectez-vous aux téléphones cloud depuis vos propres scripts avec l'API REST locale ou l'Incogniton CLI, ou depuis un client IA via MCP.

Activez l'API REST locale dans **Paramètres > Automatisation** (activez **Activer l'API d'automatisation** et cliquez sur **Enregistrer**). Vos scripts et l'Incogniton CLI peuvent alors lister vos téléphones cloud, les démarrer et les arrêter, et obtenir une adresse ADB pour eux. Les clients IA connectés avec un **jeton MCP** peuvent lister, démarrer, arrêter et créer des téléphones cloud.

Cette page concerne le contrôle des téléphones depuis l'extérieur de l'application. Pour les tâches prêtes à l'emploi que vous exécutez sur les téléphones dans Incogniton, voir **Automatisation des téléphones** dans [Gérer les téléphones cloud](https://docs.incogniton.com/documentation/french-documentation/telephones-cloud/manage-cloud-phones.md#automation).

### Ce dont vous avez besoin

* L'API REST locale activée dans **Paramètres > Automatisation**. Voir [Utiliser l'API REST locale](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/local-rest-api.md). L'API d'automatisation est une fonctionnalité payante.
* Incogniton ouvert et connecté sur le même ordinateur que votre script. L'API écoute sur `127.0.0.1`, port 35000 par défaut.
* En équipe, la bonne permission pour les téléphones cloud : **Utiliser les téléphones cloud (alimentation, redémarrage, connexion)** pour lister, démarrer et arrêter les téléphones, et **Gérer les téléphones cloud (modifier, proxy, réinitialiser, version Android, ADB, root, applications, automatisation, déplacer)** pour activer ADB.

### Ce que vous pouvez faire avec l'API REST locale

| Action                                                                                                        | Endpoint                         | Commande CLI               |
| ------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------- |
| Lister les téléphones cloud de votre équipe avec leur ID, nom, groupe, statut, version Android et adresse ADB | `GET /cloudphone/list`           | `cloudphone-list`          |
| Démarrer les téléphones sans ouvrir leur écran (pour ADB, applications et automatisation)                     | `POST /cloudphone/start`         | `cloudphone-start`         |
| Démarrer les téléphones et ouvrir l'écran de chacun dans une fenêtre dans Incogniton                          | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Éteindre les téléphones                                                                                       | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Activer ADB sur un téléphone en cours d'exécution et obtenir son adresse locale                               | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Les actions de démarrage et d'arrêt prennent une liste de 1 à 100 IDs de téléphone à partir de la liste des téléphones. Chaque téléphone est vérifié individuellement (minutes restantes, abonnement actif, proxy défini, non réinitialisé), donc certains téléphones peuvent démarrer tandis que d'autres sont refusés ; la réponse donne la raison par téléphone.

Un téléphone démarré de cette manière continue de fonctionner, et utilise des minutes, jusqu'à ce que vous l'arrêtiez. Arrêter un téléphone ferme également sa fenêtre et sa connexion ADB locale dans Incogniton.

L'action ADB renvoie une adresse locale telle que `127.0.0.1:6555`. Connectez-vous à elle avec `adb connect`, exactement comme l'adresse de **Copier la commande ADB** dans l'application. Le téléphone doit être en cours d'exécution. Voir [Connecter à un téléphone cloud avec ADB](https://docs.incogniton.com/documentation/french-documentation/telephones-cloud/connect-to-a-cloud-phone-with-adb.md).

Vous ne pouvez pas modifier, redémarrer ou réinitialiser un téléphone cloud via l'API REST locale. Faites-le dans l'application : voir [Modifier, redémarrer ou réinitialiser un téléphone cloud](https://docs.incogniton.com/documentation/french-documentation/telephones-cloud/edit-restart-and-reset-cloud-phones.md).

### Utiliser l'Incogniton CLI

Chaque action ci-dessus a une commande CLI correspondante. Cliquez sur **Télécharger CLI** dans l'onglet **Automatisation** pour l'installer ; pendant qu'il est installé, il se met à jour lorsque l'application démarre. Exécutez `incogniton-cli cloudphone-list` pour voir vos téléphones et leurs IDs. Voir la [documentation CLI](https://api-docs.incogniton.com/cli) pour savoir comment fonctionnent les commandes, les options et les sorties.

### Contrôler les téléphones cloud depuis un client IA (MCP)

Lorsque vous connectez un client IA tel que Claude ou Cursor avec un jeton MCP (**Paramètres > Automatisation > Générer un jeton MCP**, voir [Connecter des clients IA avec MCP](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/connect-ai-clients-mcp.md)), le client IA peut :

* **Lister** vos téléphones cloud avec leur statut et si ADB est activé.
* **Démarrer** des téléphones sans écran, pour ADB, les applications installées et l'automatisation.
* **Arrêter** des téléphones.
* **Créer** un nouveau téléphone cloud avec un proxy de votre bibliothèque de proxys.

Les outils MCP fonctionnent sur les serveurs d'Incogniton, ils fonctionnent donc également lorsque l'application Incogniton est fermée. Ils ne peuvent pas ouvrir l'écran d'un téléphone : pour voir un téléphone, ouvrez-le dans l'application (**Téléphones Cloud**, puis **Allumer** ou **Connecter**). Un téléphone démarré via MCP continue de fonctionner jusqu'à ce qu'il soit arrêté, ou jusqu'à ce que votre application Incogniton se ferme alors que **Arrêter mes téléphones cloud lorsque Incogniton se ferme** est activé (les téléphones exécutant une tâche d'automatisation continuent de fonctionner).

{% hint style="info" %}
La documentation pour les développeurs sur [api-docs.incogniton.com](https://api-docs.incogniton.com/apis) couvre les endpoints de profil, cookie et automatisation. Si vous avez des questions sur l'automatisation des téléphones cloud, contactez notre [service support](https://incogniton.com/contact/).
{% endhint %}
