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

# Cloud Phones von Skripten und KI-Clients steuern

Listen, starten, stoppen und verbinden Sie sich mit Cloud-Telefonen von Ihren eigenen Skripten aus mit der lokalen REST-API oder der Incogniton CLI oder von einem KI-Client über MCP.

Aktivieren Sie die lokale REST-API unter **Einstellungen > Automatisierung** (schalten Sie **Automatisierungs-API aktivieren** ein und klicken Sie auf **Speichern**). Ihre Skripte und die Incogniton CLI können dann Ihre Cloud-Telefone auflisten, starten und stoppen sowie eine ADB-Adresse für sie erhalten. Mit einem **MCP-Token** verbundene KI-Clients können Cloud-Telefone auflisten, starten, stoppen und erstellen.

Diese Seite behandelt die Steuerung von Telefonen außerhalb der App. Für die vorgefertigten Aufgaben, die Sie auf Telefonen innerhalb von Incogniton ausführen, siehe **Telefonautomatisierung** in [Cloud-Telefone verwalten](https://docs.incogniton.com/documentation/german-documentation-1/cloud-phones/manage-cloud-phones.md#automation).

### Was Sie benötigen

* Die lokale REST-API ist unter **Einstellungen > Automatisierung** eingeschaltet. Siehe [Verwendung der lokalen REST-API](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/local-rest-api.md). Die Automatisierungs-API ist eine kostenpflichtige Funktion.
* Incogniton ist auf demselben Computer wie Ihr Skript geöffnet und angemeldet. Die API hört standardmäßig auf `127.0.0.1`, Port 35000.
* In einem Team die richtige Cloud-Telefon-Berechtigung: **Cloud-Telefone verwenden (Energie, Neustart, Verbindung)**, um Telefone aufzulisten, zu starten und zu stoppen, und **Cloud-Telefone verwalten (bearbeiten, Proxy, zurücksetzen, Android-Version, ADB, Root, Apps, Automatisierung, verschieben)**, um ADB einzuschalten.

### Was Sie mit der lokalen REST-API tun können

| Aktion                                                                                                                                           | Endpoint                         | CLI-Befehl                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------------- |
| Listen Sie die Cloud-Telefone Ihres Teams mit ihrer ID, ihrem Namen, ihrer Gruppe, ihrem Status, ihrer Android-Version und ihrer ADB-Adresse auf | `GET /cloudphone/list`           | `cloudphone-list`          |
| Starten Sie Telefone, ohne ihren Bildschirm zu öffnen (für ADB, Apps und Automatisierung)                                                        | `POST /cloudphone/start`         | `cloudphone-start`         |
| Starten Sie Telefone und öffnen Sie den Bildschirm jedes Telefons in einem Fenster in Incogniton                                                 | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Schalten Sie Telefone aus                                                                                                                        | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Aktivieren Sie ADB auf einem laufenden Telefon und erhalten Sie seine lokale Adresse                                                             | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Starten und Stoppen erfordert eine Liste von 1 bis 100 Telefon-IDs aus der Telefonliste. Jedes Telefon wird einzeln überprüft (verbleibende Minuten, aktives Abonnement, Proxy eingestellt, nicht zurückgesetzt), sodass einige Telefone starten können, während andere abgelehnt werden; die Antwort gibt den Grund pro Telefon an.

Ein auf diese Weise gestartetes Telefon läuft weiter und verbraucht Minuten, bis Sie es stoppen. Das Stoppen eines Telefons schließt auch sein Fenster und seine lokale ADB-Verbindung in Incogniton.

Die ADB-Aktion gibt eine lokale Adresse wie `127.0.0.1:6555` zurück. Verbinden Sie sich damit mit `adb connect`, genau wie mit der Adresse aus **ADB-Befehl kopieren** in der App. Das Telefon muss laufen. Siehe [Mit ADB zu einem Cloud-Telefon verbinden](https://docs.incogniton.com/documentation/german-documentation-1/cloud-phones/connect-to-a-cloud-phone-with-adb.md).

Sie können ein Cloud-Telefon nicht über die lokale REST-API bearbeiten, neu starten oder zurücksetzen. Tun Sie dies in der App: siehe [Ein Cloud-Telefon bearbeiten, neu starten oder zurücksetzen](https://docs.incogniton.com/documentation/german-documentation-1/cloud-phones/edit-restart-and-reset-cloud-phones.md).

### Verwenden Sie die Incogniton CLI

Jede der oben genannten Aktionen hat einen entsprechenden CLI-Befehl. Klicken Sie auf **CLI herunterladen** auf der Registerkarte **Automatisierung**, um sie zu installieren; während sie installiert ist, aktualisiert sie sich selbst, wenn die App startet. Führen Sie `incogniton-cli cloudphone-list` aus, um Ihre Telefone und deren IDs zu sehen. Siehe die [CLI-Dokumentation](https://api-docs.incogniton.com/cli) für Informationen darüber, wie Befehle, Flags und Ausgaben funktionieren.

### Cloud-Telefone von einem KI-Client aus steuern (MCP)

Wenn Sie einen KI-Client wie Claude oder Cursor mit einem MCP-Token verbinden (**Einstellungen > Automatisierung > MCP-Token generieren**, siehe [KI-Clients mit MCP verbinden](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/connect-ai-clients-mcp.md)), kann der KI-Client:

* **Ihre Cloud-Telefone mit ihrem Status und ob ADB eingeschaltet ist, auflisten.**
* **Telefone ohne Bildschirm starten, für ADB, installierte Apps und Automatisierung.**
* **Telefone stoppen.**
* **Ein neues Cloud-Telefon mit einem Proxy aus Ihrer Proxy-Bibliothek erstellen.**

Die MCP-Tools laufen auf den Servern von Incogniton, sodass sie auch funktionieren, wenn die Incogniton-App geschlossen ist. Sie können den Bildschirm eines Telefons nicht öffnen: Um ein Telefon zu sehen, öffnen Sie es in der App (**Cloud-Telefone**, dann **Einschalten** oder **Verbinden**). Ein über MCP gestartetes Telefon läuft weiter, bis es gestoppt wird oder bis Ihre Incogniton-App geschlossen wird, während **Meine Cloud-Telefone stoppen, wenn Incogniton geschlossen wird** aktiviert ist (Telefone, die eine Automatisierungsaufgabe ausführen, laufen weiter).

{% hint style="info" %}
Die Entwicklerdokumentation unter [api-docs.incogniton.com](https://api-docs.incogniton.com/apis) behandelt die Endpunkte für Profile, Cookies und Automatisierung. Wenn Sie Fragen zur Automatisierung von Cloud-Telefonen haben, kontaktieren Sie bitte unseren [Support](https://incogniton.com/contact/).
{% endhint %}
