Настройка Adapty CLI в приложении Claude

Adapty Developer CLI работает в приложении Claude, так что вы можете управлять своим аккаунтом Adapty прямо из чата, а не через терминал. Claude выполняет команды в песочнице, которая имеет доступ только к разрешённым доменам, поэтому перед первым входом в аккаунт CLI нужно один раз настроить в Claude.

Note

Claude Cowork и чат теперь объединены в один Claude: всё, что вы делали в Cowork, теперь доступно в любом разговоре. Объединение постепенно распространяется по планам. Если в вашем плане по-прежнему есть отдельный Cowork, следуйте тем же шагам и начинайте каждую задачу в Cowork.

Что вам понадобится:

Приложение Claude
Аккаунт Adapty
Для корпоративных рабочих пространств Claude — помощь администратора рабочего пространства: см. Разрешите домены Adapty

Tip

Чтобы управлять аккаунтом Adapty из приложения Claude с минимальными настройками, подключите Adapty MCP server. Его нужно добавить один раз как пользовательский коннектор — он не требует разрешённых доменов и не нужно авторизоваться в каждом разговоре.

Добавление плагина Adapty

Плагин Adapty содержит скиллы, которым следует Claude при установке, аутентификации и управлении CLI, включая скилл Apple Ads для работы с Ads Manager.

Чтобы добавить плагин:

В Claude откройте Settings → Plugins.
Нажмите Add → Add marketplace.
Выберите Add from a repository.
В поле URL вставьте https://github.com/adaptyteam/apple-ads-cli.
Нажмите Sync.

Add marketplace dialog in Claude with the Adapty repository URL and the Sync button

Плагины Adapty появятся в разделе Personal в каталоге плагинов.

Разрешите домены Adapty

Пока вы не добавите Adapty в список разрешённых доменов песочницы, CLI не сможет войти в аккаунт или читать его данные.

Добавьте в список оба домена: adapty.io и *.adapty.io. В большинстве реализаций вайлдкард не распространяется на корневой домен. Сам CLI обращается к api.adapty.io, а агент, читающий документацию Adapty в процессе работы, обращается к корневому домену.

Claude применяет эти настройки в момент начала разговора. Если вы измените режим доступа или добавите домен в ходе разговора, текущий разговор сохранит те настройки, с которыми он начался — начните новый разговор.

Личные аккаунты

Список разрешённых доменов настраивается самостоятельно:

В Claude откройте Settings → Capabilities.
Включите Code execution and file creation. Блок Allow network egress появится только после этого.
Включите Allow network egress.
В Domain allowlist выберите Package managers only.
В разделе Additional allowed domains добавьте adapty.io, затем *.adapty.io.

Настройки Allow network egress в Claude с adapty.io и *.adapty.io в списке дополнительных разрешённых доменов

Другой режим доступа, All domains, позволяет песочнице обращаться к любому сайту. При его выборе домены Adapty добавлять не нужно.

Корпоративные рабочие пространства

Список разрешённых доменов контролирует администратор. Попросите его добавить оба домена для рабочего пространства.

Установка и авторизация CLI

Каждый новый разговор начинается на чистой машине: ни CLI, ни токен, ни конфигурация не сохраняются между сессиями, поэтому шаги установки и входа повторяются в начале каждого разговора.

Чтобы установить и авторизовать CLI:

Начните новый разговор в Claude.
Попросите Claude установить Adapty CLI — например, «Install the Adapty CLI». Claude может запросить разрешение на открытие ссылок установки — разрешите это.
После установки Claude предложит войти в Adapty — согласитесь, и он опубликует ссылку для авторизации с кодом устройства. Код действует около 15 минут.
Откройте ссылку. В браузере откроется страница авторизации Adapty CLI.
Убедитесь, что код на странице совпадает с кодом, который прислал Claude, затем нажмите Authorize. Если коды не совпадают, нажмите Deny и попросите Claude прислать новую ссылку.
Вернитесь в чат и сообщите Claude, что авторизация прошла — например, «готово». Claude проверит вход и выведет данные вашего аккаунта.

CLI готов к работе. Чтобы настроить приложение, продукты и пейволы прямо из чата, следуйте гайду по быстрому старту.

Устранение неполадок

Проблема	Как исправить
Скиллы не появляются после нажатия Sync	Проверьте, что URL репозитория — `https://github.com/adaptyteam/apple-ads-cli`, затем нажмите Sync ещё раз.
Сетевые ошибки при установке или авторизации	Добавьте `adapty.io` и `*.adapty.io` в список разрешённых доменов. Настройки применяются при начале нового разговора, поэтому запустите новый чат после их добавления.
Ссылка для авторизации не открывается или отклоняется	Код действителен около 15 минут. Попросите Claude сгенерировать новую ссылку.
Код в браузере не совпадает с кодом в чате	Не нажимайте Authorize. Попросите Claude предоставить новую ссылку и начните заново.