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

# Управление облачными телефонами из скриптов и AI-клиентов

Управляйте облачными телефонами из собственных скриптов с помощью локального REST API или Incogniton CLI, или из AI-клиента через MCP.

Включите локальный REST API в **Настройки > Автоматизация** (включите **Включить API автоматизации** и нажмите **Сохранить**). Ваши скрипты и Incogniton CLI могут затем перечислять ваши облачные телефоны, запускать и останавливать их, а также получать ADB-адрес для них. AI-клиенты, подключенные с **MCP токеном**, могут перечислять, запускать, останавливать и создавать облачные телефоны.

Эта страница посвящена управлению телефонами вне приложения. Для готовых задач, которые вы выполняете на телефонах внутри Incogniton, смотрите **Автоматизация телефонов** в [Управление облачными телефонами](https://docs.incogniton.com/documentation/russian-documentation/oblachnye-telefony/manage-cloud-phones.md#automation).

### Что вам нужно

* Локальный REST API включен в **Настройки > Автоматизация**. См. [Использование локального REST API](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/local-rest-api.md). API автоматизации — платная функция.
* Incogniton открыт и выполнен вход на том же компьютере, что и ваш скрипт. API слушает на `127.0.0.1`, порт 35000 по умолчанию.
* В команде, правильное разрешение на облачные телефоны: **Использовать облачные телефоны (включение, перезапуск, подключение)** для перечисления, запуска и остановки телефонов, и **Управление облачными телефонами (редактирование, прокси, сброс, версия Android, ADB, root, приложения, автоматизация, перемещение)** для включения ADB.

### Что вы можете сделать с локальным REST API

| Действие                                                                                                      | Endpoint                         | CLI команда                |
| ------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------- |
| Перечислить облачные телефоны вашей команды с их ID, именем, группой, статусом, версией Android и ADB-адресом | `GET /cloudphone/list`           | `cloudphone-list`          |
| Запустить телефоны без открытия их экрана (для ADB, приложений и автоматизации)                               | `POST /cloudphone/start`         | `cloudphone-start`         |
| Запустить телефоны и открыть экран каждого в окне Incogniton                                                  | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Выключить телефоны                                                                                            | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Включить ADB на работающем телефоне и получить его локальный адрес                                            | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Запуск и остановка принимают список от 1 до 100 ID телефонов из списка телефонов. Каждый телефон проверяется отдельно (оставшиеся минуты, активная подписка, установленный прокси, не сбрасывается), поэтому некоторые телефоны могут быть запущены, а другие отклонены; ответ дает причину для каждого телефона.

Телефон, запущенный таким образом, продолжает работать и использовать минуты, пока вы его не остановите. Остановка телефона также закрывает его окно и его локальное ADB-соединение в Incogniton.

Действие ADB возвращает локальный адрес, такой как `127.0.0.1:6555`. Подключитесь к нему с помощью `adb connect`, точно так же, как адрес из **Копировать команду ADB** в приложении. Телефон должен работать. См. [Подключение к облачному телефону с помощью ADB](https://docs.incogniton.com/documentation/russian-documentation/oblachnye-telefony/connect-to-a-cloud-phone-with-adb.md).

Вы не можете редактировать, перезапускать или сбрасывать облачный телефон через локальный REST API. Делайте это в приложении: см. [Редактировать, перезапускать или сбрасывать облачный телефон](https://docs.incogniton.com/documentation/russian-documentation/oblachnye-telefony/edit-restart-and-reset-cloud-phones.md).

### Использование Incogniton CLI

Каждое действие выше имеет соответствующую CLI команду. Нажмите **Скачать CLI** на вкладке **Автоматизация**, чтобы установить его; пока он установлен, он обновляется при запуске приложения. Запустите `incogniton-cli cloudphone-list`, чтобы увидеть ваши телефоны и их ID. См. [документацию CLI](https://api-docs.incogniton.com/cli) для информации о командах, флагах и выводе.

### Управление облачными телефонами из AI-клиента (MCP)

Когда вы подключаете AI-клиент, такой как Claude или Cursor, с MCP токеном (**Настройки > Автоматизация > Генерация MCP токена**, см. [Подключение AI-клиентов с MCP](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/connect-ai-clients-mcp.md)), AI-клиент может:

* **Перечислить** ваши облачные телефоны с их статусом и включенным ли ADB.
* **Запустить** телефоны без экрана, для ADB, установленных приложений и автоматизации.
* **Остановить** телефоны.
* **Создать** новый облачный телефон с прокси из вашей библиотеки прокси.

Инструменты MCP работают на серверах Incogniton, поэтому они также работают, когда приложение Incogniton закрыто. Они не могут открыть экран телефона: чтобы увидеть телефон, откройте его в приложении (**Облачные телефоны**, затем **Включить питание** или **Подключить**). Телефон, запущенный через MCP, продолжает работать, пока он не будет остановлен, или пока ваше приложение Incogniton не закроется, если включена опция **Остановить мои облачные телефоны при закрытии Incogniton** (телефоны, выполняющие задачу автоматизации, продолжают работать).

{% hint style="info" %}
Документация для разработчиков на [api-docs.incogniton.com](https://api-docs.incogniton.com/apis) охватывает профили, куки и endpoints автоматизации. Если у вас есть вопросы о автоматизации облачных телефонов, свяжитесь с нашим [отделом поддержки](https://incogniton.com/contact/).
{% endhint %}
