С чего начать

API-ключи

Один ключ открывает REST API, Python SDK и MCP-сервер.

Базовый URL и заголовок

Каждый запрос

# base URL
https://api.clousd.com/v1

# header
Authorization: Bearer cl_live_••••••••

Создать ключ

Откройте Настройки → Подключения: в Доступ → API-ключи ключи создаются и отзываются. Окно Подключить ИИ в один клик создаёт ключ с управлением всеми вашими телефонами и показывает строки, которые нужно вставить в Claude Code, Codex, Cursor и другие клиенты. Ключ показывается один раз.

Права и устройства

У каждого ключа есть права и список устройств:

Права	Что можно
read	Получать список устройств, снимать скриншоты, смотреть на экран, читать задания. Любой вызов, который что-то меняет, отвечает `403`.
control	Всё, что выше, плюс запуск, остановка, установка приложений, действия на экране и запуск задач.

Ключ действует либо на все телефоны аккаунта, либо на выбранный вами список. Телефон вне списка отвечает 404, будто его нет.

Отозвать ключ

Отозванный ключ перестаёт работать сразу — для всех клиентов, которые его используют. Ключи принадлежат аккаунту, а не человеку, поэтому продолжают работать, когда сотрудник уходит из команды.

Команда

В аккаунте есть владельцы и операторы (Настройки → Команда). Владельцы отвечают за оплату, API-ключи, команду, создание и удаление устройств. Операторы работают с назначенными им устройствами — без оплаты, ключей и удаления.