> 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/spanish/telefonos-en-la-nube/control-cloud-phones-from-scripts.md).

# Controlar teléfonos en la nube desde scripts y clientes de IA

Enumere, inicie, detenga y conéctese a teléfonos en la nube desde sus propios scripts con la API REST local o el CLI de Incogniton, o desde un cliente AI a través de MCP.

Active la API REST local en **Configuración > Automatización** (active **Habilitar API de automatización** y haga clic en **Guardar**). Sus scripts y el CLI de Incogniton pueden entonces enumerar sus teléfonos en la nube, iniciarlos y detenerlos, y obtener una dirección ADB para ellos. Los clientes AI conectados con un **token MCP** pueden enumerar, iniciar, detener y crear teléfonos en la nube.

Esta página trata sobre el control de teléfonos desde fuera de la aplicación. Para las tareas predefinidas que ejecuta en teléfonos dentro de Incogniton, consulte **Automatización de teléfonos** en [Gestionar teléfonos en la nube](https://docs.incogniton.com/documentation/spanish/telefonos-en-la-nube/manage-cloud-phones.md#automation).

### Lo que necesitas

* La API REST local activada en **Configuración > Automatización**. Consulte [Usar la API REST local](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/local-rest-api.md). La API de automatización es una función de pago.
* Incogniton abierto y con sesión iniciada en la misma computadora que su script. La API escucha en `127.0.0.1`, puerto 35000 por defecto.
* En un equipo, el permiso adecuado para teléfonos en la nube: **Usar teléfonos en la nube (encender, reiniciar, conectar)** para enumerar, iniciar y detener teléfonos, y **Gestionar teléfonos en la nube (editar, proxy, restablecer, versión de Android, ADB, root, aplicaciones, automatización, mover)** para activar ADB.

### Lo que puedes hacer con la API REST local

| Acción                                                                                                             | Endpoint                         | Comando CLI                |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------------- |
| Enumere los teléfonos en la nube de su equipo con su ID, nombre, grupo, estado, versión de Android y dirección ADB | `GET /cloudphone/list`           | `cloudphone-list`          |
| Inicie teléfonos sin abrir su pantalla (para ADB, aplicaciones y automatización)                                   | `POST /cloudphone/start`         | `cloudphone-start`         |
| Inicie teléfonos y abra la pantalla de cada uno en una ventana en Incogniton                                       | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Apague los teléfonos                                                                                               | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Habilite ADB en un teléfono en funcionamiento y obtenga su dirección local                                         | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Iniciar y detener toman una lista de 1 a 100 IDs de teléfono de la lista de teléfonos. Cada teléfono se verifica por sí mismo (minutos restantes, suscripción activa, proxy configurado, no restableciendo), por lo que algunos teléfonos pueden iniciarse mientras otros son rechazados; la respuesta da la razón por teléfono.

Un teléfono iniciado de esta manera sigue funcionando, y usando minutos, hasta que lo detenga. Detener un teléfono también cierra su ventana y su conexión ADB local en Incogniton.

La acción ADB devuelve una dirección local como `127.0.0.1:6555`. Conéctese a ella con `adb connect`, exactamente como la dirección del **Comando de copia ADB** en la aplicación. El teléfono debe estar en funcionamiento. Consulte [Conectar a un teléfono en la nube con ADB](https://docs.incogniton.com/documentation/spanish/telefonos-en-la-nube/connect-to-a-cloud-phone-with-adb.md).

No puede editar, reiniciar o restablecer un teléfono en la nube a través de la API REST local. Hágalo en la aplicación: consulte [Editar, reiniciar o restablecer un teléfono en la nube](https://docs.incogniton.com/documentation/spanish/telefonos-en-la-nube/edit-restart-and-reset-cloud-phones.md).

### Usar el CLI de Incogniton

Cada acción anterior tiene un comando CLI correspondiente. Haga clic en **Descargar CLI** en la pestaña **Automatización** para instalarlo; mientras esté instalado, se actualiza automáticamente cuando la aplicación se inicia. Ejecute `incogniton-cli cloudphone-list` para ver sus teléfonos y sus IDs. Consulte la [documentación del CLI](https://api-docs.incogniton.com/cli) para saber cómo funcionan los comandos, las banderas y la salida.

### Controlar teléfonos en la nube desde un cliente AI (MCP)

Cuando conecta un cliente AI como Claude o Cursor con un token MCP (**Configuración > Automatización > Generar Token MCP**, consulte [Conectar clientes AI con MCP](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/connect-ai-clients-mcp.md)), el cliente AI puede:

* **Enumerar** sus teléfonos en la nube con su estado y si ADB está activado.
* **Iniciar** teléfonos sin pantalla, para ADB, aplicaciones instaladas y automatización.
* **Detener** teléfonos.
* **Crear** un nuevo teléfono en la nube con un proxy de su Biblioteca de Proxies.

Las herramientas MCP se ejecutan en los servidores de Incogniton, por lo que también funcionan cuando la aplicación Incogniton está cerrada. No pueden abrir la pantalla de un teléfono: para ver un teléfono, ábralo en la aplicación (**Teléfonos en la Nube**, luego **Encender** o **Conectar**). Un teléfono iniciado a través de MCP sigue funcionando hasta que se detiene, o hasta que su aplicación Incogniton se cierra mientras **Detener mis teléfonos en la nube cuando Incogniton se cierra** está activado (los teléfonos que ejecutan una tarea de automatización siguen funcionando).

{% hint style="info" %}
La documentación para desarrolladores en [api-docs.incogniton.com](https://api-docs.incogniton.com/apis) cubre los endpoints de perfil, cookies y automatización. Si tiene preguntas sobre la automatización de teléfonos en la nube, contacte a nuestro [departamento de soporte](https://incogniton.com/contact/).
{% endhint %}
