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

# Controlla i telefoni cloud da script e client AI

Elenca, avvia, ferma e connetti i telefoni cloud dai tuoi script con l'API REST locale o l'Incogniton CLI, o da un client AI tramite MCP.

Attiva l'API REST locale in **Impostazioni > Automazione** (attiva **Abilita API automazione** e fai clic su **Salva**). I tuoi script e l'Incogniton CLI possono quindi elencare i tuoi telefoni cloud, avviarli e fermarli, e ottenere un indirizzo ADB per essi. I client AI connessi con un **token MCP** possono elencare, avviare, fermare e creare telefoni cloud.

Questa pagina riguarda il controllo dei telefoni dall'esterno dell'app. Per le attività pronte all'uso che esegui sui telefoni all'interno di Incogniton, vedi **Automazione telefono** in [Gestisci telefoni cloud](https://docs.incogniton.com/documentation/italian-documentation/telefoni-cloud/manage-cloud-phones.md#automation).

### Cosa ti serve

* L'API REST locale attivata in **Impostazioni > Automazione**. Vedi [Usa l'API REST locale](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/local-rest-api.md). L'API di automazione è una funzionalità a pagamento.
* Incogniton aperto e connesso sullo stesso computer del tuo script. L'API ascolta su `127.0.0.1`, porta 35000 per impostazione predefinita.
* In un team, il permesso giusto per i telefoni cloud: **Usa telefoni cloud (accensione, riavvio, connessione)** per elencare, avviare e fermare i telefoni, e **Gestisci telefoni cloud (modifica, proxy, reset, versione Android, ADB, root, app, automazione, sposta)** per attivare ADB.

### Cosa puoi fare con l'API REST locale

| Azione                                                                                                     | Endpoint                         | Comando CLI                |
| ---------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------- |
| Elenca i telefoni cloud del tuo team con il loro ID, nome, gruppo, stato, versione Android e indirizzo ADB | `GET /cloudphone/list`           | `cloudphone-list`          |
| Avvia telefoni senza aprire il loro schermo (per ADB, app e automazione)                                   | `POST /cloudphone/start`         | `cloudphone-start`         |
| Avvia telefoni e apri lo schermo di ciascuno in una finestra in Incogniton                                 | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Spegni i telefoni                                                                                          | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Abilita ADB su un telefono in esecuzione e ottieni il suo indirizzo locale                                 | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Avviare e fermare richiede un elenco di 1 a 100 ID di telefono dalla lista dei telefoni. Ogni telefono viene controllato singolarmente (minuti rimanenti, abbonamento attivo, proxy impostato, non in reset), quindi alcuni telefoni possono avviarsi mentre altri vengono rifiutati; la risposta fornisce il motivo per telefono.

Un telefono avviato in questo modo continua a funzionare, e a utilizzare minuti, fino a quando non lo fermi. Fermare un telefono chiude anche la sua finestra e la sua connessione ADB locale in Incogniton.

L'azione ADB restituisce un indirizzo locale come `127.0.0.1:6555`. Connettiti ad esso con `adb connect`, esattamente come l'indirizzo dal comando **Copia comando ADB** nell'app. Il telefono deve essere in esecuzione. Vedi [Connetti a un telefono cloud con ADB](https://docs.incogniton.com/documentation/italian-documentation/telefoni-cloud/connect-to-a-cloud-phone-with-adb.md).

Non puoi modificare, riavviare o resettare un telefono cloud tramite l'API REST locale. Fai ciò nell'app: vedi [Modifica, riavvia o resetta un telefono cloud](https://docs.incogniton.com/documentation/italian-documentation/telefoni-cloud/edit-restart-and-reset-cloud-phones.md).

### Usa l'Incogniton CLI

Ogni azione sopra ha un comando CLI corrispondente. Fai clic su **Scarica CLI** nella scheda **Automazione** per installarla; mentre è installata, si aggiorna automaticamente all'avvio dell'app. Esegui `incogniton-cli cloudphone-list` per vedere i tuoi telefoni e i loro ID. Vedi la [documentazione CLI](https://api-docs.incogniton.com/cli) per come funzionano i comandi, le opzioni e l'output.

### Controlla i telefoni cloud da un client AI (MCP)

Quando connetti un client AI come Claude o Cursor con un token MCP (**Impostazioni > Automazione > Genera Token MCP**, vedi [Connetti client AI con MCP](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/connect-ai-clients-mcp.md)), il client AI può:

* **Elencare** i tuoi telefoni cloud con il loro stato e se ADB è attivo.
* **Avviare** telefoni senza schermo, per ADB, app installate e automazione.
* **Fermare** telefoni.
* **Creare** un nuovo telefono cloud con un proxy dalla tua Libreria Proxy.

Gli strumenti MCP funzionano sui server di Incogniton, quindi funzionano anche quando l'app Incogniton è chiusa. Non possono aprire lo schermo di un telefono: per vedere un telefono, aprilo nell'app (**Telefoni Cloud**, poi **Accendi** o **Connetti**). Un telefono avviato tramite MCP continua a funzionare fino a quando non viene fermato, o fino a quando la tua app Incogniton si chiude mentre **Ferma i miei telefoni cloud quando Incogniton si chiude** è attivo (i telefoni che eseguono un'attività di automazione continuano a funzionare).

{% hint style="info" %}
La documentazione per sviluppatori su [api-docs.incogniton.com](https://api-docs.incogniton.com/apis) copre i profili, i cookie e gli endpoint di automazione. Se hai domande sull'automazione dei telefoni cloud, contatta il nostro [dipartimento di supporto](https://incogniton.com/contact/).
{% endhint %}
