> 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/dutch-documentation/cloud-phones/control-cloud-phones-from-scripts.md).

# Bedien cloud phones vanuit scripts en AI-clients

Lijst, start, stop en verbind met cloudtelefoons vanuit je eigen scripts met de lokale REST API of de Incogniton CLI, of vanuit een AI-client via MCP.

Schakel de lokale REST API in bij **Instellingen > Automatisering** (schakel **Automatiserings-API inschakelen** in en klik op **Opslaan**). Je scripts en de Incogniton CLI kunnen dan je cloudtelefoons opsommen, starten en stoppen, en een ADB-adres voor hen verkrijgen. AI-clients die verbonden zijn met een **MCP-token** kunnen cloudtelefoons opsommen, starten, stoppen en creëren.

Deze pagina gaat over het bedienen van telefoons van buiten de app. Voor de kant-en-klare taken die je op telefoons binnen Incogniton uitvoert, zie **Telefoonautomatisering** in [Cloudtelefoons beheren](https://docs.incogniton.com/documentation/dutch-documentation/cloud-phones/manage-cloud-phones.md#automation).

### Wat je nodig hebt

* De lokale REST API ingeschakeld bij **Instellingen > Automatisering**. Zie [Gebruik de lokale REST API](https://docs.incogniton.com/documentation/dutch-documentation/automatisering-api-en-sdks/local-rest-api.md). De automatiserings-API is een betaalde functie.
* Incogniton geopend en ingelogd op dezelfde computer als je script. De API luistert standaard op `127.0.0.1`, poort 35000.
* In een team, de juiste cloudtelefoon-permissie: **Cloudtelefoons gebruiken (aan/uit, herstarten, verbinden)** om telefoons op te sommen, te starten en te stoppen, en **Cloudtelefoons beheren (bewerken, proxy, resetten, Android-versie, ADB, root, apps, automatisering, verplaatsen)** om ADB in te schakelen.

### Wat je kunt doen met de lokale REST API

| Actie                                                                                            | Endpoint                         | CLI-commando               |
| ------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------------- |
| Lijst de cloudtelefoons van je team met hun ID, naam, groep, status, Android-versie en ADB-adres | `GET /cloudphone/list`           | `cloudphone-list`          |
| Start telefoons zonder hun scherm te openen (voor ADB, apps en automatisering)                   | `POST /cloudphone/start`         | `cloudphone-start`         |
| Start telefoons en open het scherm van elke telefoon in een venster in Incogniton                | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Zet telefoons uit                                                                                | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Schakel ADB in op een draaiende telefoon en verkrijg het lokale adres                            | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Starten en stoppen nemen een lijst van 1 tot 100 telefoon-ID's uit de telefoonlijst. Elke telefoon wordt afzonderlijk gecontroleerd (resterende minuten, abonnement actief, proxy ingesteld, niet aan het resetten), zodat sommige telefoons kunnen starten terwijl andere worden geweigerd; het antwoord geeft de reden per telefoon.

Een telefoon die op deze manier wordt gestart, blijft draaien en minuten gebruiken totdat je hem stopt. Het stoppen van een telefoon sluit ook het venster en de lokale ADB-verbinding in Incogniton.

De ADB-actie retourneert een lokaal adres zoals `127.0.0.1:6555`. Verbind ermee met `adb connect`, precies zoals het adres van **ADB-commando kopiëren** in de app. De telefoon moet draaien. Zie [Verbind met een cloudtelefoon met ADB](https://docs.incogniton.com/documentation/dutch-documentation/cloud-phones/connect-to-a-cloud-phone-with-adb.md).

Je kunt een cloudtelefoon niet bewerken, herstarten of resetten via de lokale REST API. Doe dat in de app: zie [Bewerk, herstart of reset een cloudtelefoon](https://docs.incogniton.com/documentation/dutch-documentation/cloud-phones/edit-restart-and-reset-cloud-phones.md).

### Gebruik de Incogniton CLI

Elke actie hierboven heeft een bijbehorend CLI-commando. Klik op **CLI downloaden** op het tabblad **Automatisering** om het te installeren; terwijl het is geïnstalleerd, werkt het zichzelf bij wanneer de app start. Voer `incogniton-cli cloudphone-list` uit om je telefoons en hun ID's te zien. Zie de [CLI-documentatie](https://api-docs.incogniton.com/cli) voor hoe commando's, vlaggen en output werken.

### Cloudtelefoons bedienen vanuit een AI-client (MCP)

Wanneer je een AI-client zoals Claude of Cursor verbindt met een MCP-token (**Instellingen > Automatisering > MCP-token genereren**, zie [Verbind AI-clients met MCP](https://docs.incogniton.com/documentation/dutch-documentation/automatisering-api-en-sdks/connect-ai-clients-mcp.md)), kan de AI-client:

* **Lijst** je cloudtelefoons met hun status en of ADB is ingeschakeld.
* **Start** telefoons zonder scherm, voor ADB, geïnstalleerde apps en automatisering.
* **Stop** telefoons.
* **Creëer** een nieuwe cloudtelefoon met een proxy uit je Proxybibliotheek.

De MCP-tools draaien op de servers van Incogniton, dus ze werken ook wanneer de Incogniton-app gesloten is. Ze kunnen het scherm van een telefoon niet openen: om een telefoon te zien, open je hem in de app (**Cloudtelefoons**, dan **Aanzetten** of **Verbinden**). Een telefoon die via MCP is gestart, blijft draaien totdat hij wordt gestopt, of totdat je Incogniton-app sluit terwijl **Stop mijn cloudtelefoons wanneer Incogniton sluit** is ingeschakeld (telefoons die een automatiseringstaak uitvoeren, blijven draaien).

{% hint style="info" %}
De ontwikkelaarsdocumentatie op [api-docs.incogniton.com](https://api-docs.incogniton.com/apis) behandelt de profiel-, cookie- en automatiseringsendpoints. Als je vragen hebt over het automatiseren van cloudtelefoons, neem dan contact op met onze [ondersteuningsafdeling](https://incogniton.com/contact/).
{% endhint %}
