Настройка Adapty CLI в Claude Cowork

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

Что потребуется:

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

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

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

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

  1. В Claude откройте Settings → Plugins.
  2. Нажмите Add → Add marketplace.
  3. Выберите Add from a repository.
  4. В поле URL вставьте https://github.com/adaptyteam/apple-ads-cli.
  5. Нажмите Sync.
Диалог добавления маркетплейса в Claude с URL репозитория Adapty и кнопкой Sync

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

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

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

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

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

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

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

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

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

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

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

Установите и авторизуйте CLI

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

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

  1. Начните новую задачу в Cowork.

  2. Попросите Claude установить Adapty CLI — например: «Install the Adapty CLI». Cowork может запросить разрешение на открытие ссылок установки — разрешите.

    Чат Cowork, в котором Claude подтверждает установку Adapty CLI
  3. После установки Cowork предложит войти в Adapty — согласитесь, и он опубликует ссылку авторизации с кодом устройства. Код действителен около 15 минут.

    Чат Cowork, в котором Claude публикует ссылку авторизации Adapty и код устройства
  4. Откройте ссылку. В браузере откроется страница авторизации Adapty CLI.

  5. Убедитесь, что код на странице совпадает с кодом из Cowork, и нажмите Authorize. Если коды не совпадают, нажмите Deny и попросите Cowork сгенерировать новую ссылку.

    Страница авторизации Adapty CLI в браузере с кодом устройства и кнопкой Authorize
  6. Вернитесь в чат и сообщите Cowork, что авторизация выполнена — например: «done». Cowork проверит вход и выведет данные вашего аккаунта.

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

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

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