Подключение AI-ассистентов к Adapty (MCP)

MCP-сервер Adapty подключает ИИ-ассистента к вашему аккаунту Adapty. Спрашивайте о доходах и конверсиях, настраивайте продукты и плейсменты, публикуйте флоу или запускайте A/B-тесты прямо из чата, на обычном языке. Ассистент входит в аккаунт Adapty через браузер и получает ваши права. API-ключ не нужен.


URL сервера	`https://mcp.adapty.io/mcp`
Протокол	MCP over Streamable HTTP, OAuth 2.1 вход через браузер
Работает с	Приложением Claude (веб и десктоп), Claude Code, Codex и другими MCP-клиентами с поддержкой OAuth

Important

MCP-сервер лучше всего работает совместно со скиллами Adapty. Сервер даёт ассистенту доступ к вашему аккаунту, а скиллы — проверенные сценарии работы. Создание флоу, пейволов и поиск точек роста в аналитике требуют скиллов.

Claude

В прошлом месяце упала конверсия из триала в оплату. Найди, где именно, и запусти тест, чтобы это исправить.

Использовано 6 инструментов Adapty

analytics_conversion — trial в платную, по странам, последние два месяца
analytics_conversion — trial в платную в Германии, по плейсментам
placements_get — settings_upgrade
paywalls_list
ab_tests_list — тесты пейволов на settings_upgrade
ab_tests_create — черновик теста, 50/50

Конверсия из trial в платную упала только в Германии — с 41% до 29%, и только на плейсменте settings_upgrade.

Остальные страны не изменились. 2 октября в settings_upgrade сменился пейвол — с «Annual first» на «Weekly focus», который открывается с недельного плана. С тех пор меньше немецких пользователей, начавших там пробный период, оплачивают подписку после его окончания.

Я создал черновик A/B-теста на settings_upgrade для пользователей из Германии: «Annual first» против «Weekly focus», 50/50. Для ваших пользователей пока ничего не изменилось.

Запустить A/B-тест

Если я запущу тест, половина немецких пользователей, которые откроют settings_upgrade, с сегодняшнего дня будут видеть Annual первым. Пользователи из других стран продолжат видеть Weekly focus. Вы можете остановить тест в любой момент, но отменить запуск нельзя. Запустить?

Да, запустить тест
Нет, оставить черновик

Пример разговора на основе тестового приложения. Ваши цифры, пейволы и тесты будут отличаться.

Добавьте скиллы Adapty

MCP-сервер даёт ассистенту доступ к вашему аккаунту Adapty. Скиллы Adapty — это готовые проверенные сценарии: они планируют изменение, проверяют его и запрашивают подтверждение перед каждым шагом, который затрагивает пользователей. Устанавливайте их вместе. Плагин adapty-skills включает и скиллы, и этот MCP-сервер.

Скиллы нужны для двух видов задач:

Флоу и пейволы: Скилл flow-generator включает правила конфигурации Flow Builder. Он строит экраны по описанию или скриншоту, а также проверяет и предварительно просматривает каждое изменение перед сохранением флоу. Без скилла ассистент может читать и записывать конфиг флоу, но не знает правил валидного конфига.
Аналитика и что тестировать дальше: Скилл growth-advisor знает, какие отчёты читать и как их интерпретировать, и превращает ваши цифры в гипотезы для A/B-тестов. Без скилла ассистент может получить ваши графики, но не умеет их объяснять.

Добавление плагина в приложении Claude

Плагин добавляется через настройки Claude, без командной строки.

В Claude откройте Settings → Plugins.
Нажмите Add → Add marketplace.
Выберите Add from a repository.
В поле URL введите adaptyteam/adapty-skills и выберите репозиторий. Чтобы получать новые скиллы и исправления по мере их выхода, оставьте Sync automatically включённым.
Нажмите Sync.

Add marketplace dialog in Claude with adaptyteam/adapty-skills in the URL field and Sync automatically turned on

Claude открывает вкладку Discover с плагинами из маркетплейса Adapty. Чтобы установить скиллы, в строке Adapty нажмите Add.

Discover tab in Claude listing the Adapty, Apple ads, and Apple ads benchmarks plugins, each with an Add button

Скиллы запускают свои скрипты в песочнице Claude. Чтобы разрешить это, в Settings → Capabilities включите Code execution and file creation.

Добавьте плагин в кодинг-агент

В Claude Code, Codex, Copilot CLI, Gemini CLI, Cursor и других кодинг-агентах выполните:

npx adapty skills install

Команда устанавливает плагин через собственный инсталлятор агента, если он есть. После этого перезапустите агента. В Claude Code и Codex плагин также добавляет MCP-сервер Adapty, поэтому достаточно только войти в систему, как описано в разделе Подключите ассистента.

Какие скиллы используют MCP-сервер, а какие — CLI

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

MCP-сервер: запуск A/B-тестов, интеграция SDK и тестирование покупок.
Adapty CLI: создание и аудит флоу, поиск точек для тестирования, перенос плейсментов во флоу и создание сегментов. Эти скиллы запускают собственные скрипты и файлы, а CLI передаёт их напрямую.

Создание и редактирование флоу

Установите скилл flow-generator, чтобы ваш AI-инструмент мог создавать, переводить и реструктурировать флоу Adapty через Adapty CLI.

Найдите, что тестировать дальше

Установите скилл growth-advisor, чтобы ваш AI-инструмент для написания кода читал аналитику Adapty, находил места потери выручки и предлагал, что тестировать следующим в A/B-тестах.

Запуск A/B-тестов

Установите скилл ab-tests, чтобы ваш AI-инструмент для кодирования создавал, запускал, останавливал и заменял A/B-тесты пейволов и флоу в Adapty, а также показывал, кто и что видит перед каждым шагом, который нельзя отменить.

Интеграция на основе скиллов

Используйте скилл adapty-integration для сквозной интеграции Adapty SDK в ваше iOS-приложение с помощью AI-инструмента для разработки.

Что умеет ассистент

Инструменты сервера соответствуют дашборду Adapty и Adapty Developer CLI. Ассистент сам выбирает нужные инструменты для вашего запроса — вам не нужно их называть.

Область	Что умеет ассистент	Попробуйте спросить
Приложения и уровни доступа	Просматривать, создавать и обновлять приложения и уровни доступа	«Создай уровень доступа `premium` в Fitness Pro.»
Продукты и офферы	Создавать продукты с их ID в сторе и привязывать к ним офферы стора	«У каких моих продуктов нет Google Play product ID?»
Пейволы	Создавать и обновлять пейволы, а также находить плейсменты, в которых они показываются	«В каких плейсментах показывается пейвол Annual sale?»
Флоу	Создавать флоу, читать и писать конфиги builder, валидировать, превьювировать, публиковать и читать метрики флоу	«Опубликуй флоу Onboarding v2 и скажи, в каких плейсментах он показывается.»
Плейсменты и аудитории	Создавать плейсменты и управлять тем, кому что показывается, а также читать метрики плейсментов флоу	«Кто и что видит на плейсменте `onboarding`?»
Сегменты	Читать сегменты и их фильтры	«Покажи мои сегменты и фильтры каждого из них.»
A/B-тесты	Создавать, запускать, останавливать, заменять и архивировать A/B-тесты пейволов и флоу	«Запусти черновик теста Weekly vs annual для пользователей из Германии.»
Аналитика	Читать данные по выручке, MRR, конверсиям, воронке, удержанию, LTV и когортам установок	«Сравни конверсию trial-to-paid по странам за прошлый месяц.»
Миграция из RevenueCat	Создавать и запускать миграцию каталога RevenueCat в новое приложение Adapty	«Перенеси мой проект RevenueCat в новое приложение Adapty.»

У Adapty Mail есть собственный MCP-сервер. Чтобы подключить ассистента к вашему проекту Adapty Mail, см. Управление Adapty Mail с помощью AI-ассистентов.

Выберите MCP-сервер или CLI

MCP-сервер и Adapty Developer CLI работают с одним и тем же аккаунтом Adapty. Выбирайте по тому, где запускается ваш ассистент:

	MCP-сервер Adapty	Adapty CLI
Запускается в	Любом MCP-клиенте, включая чат-приложения, например Claude	Агентах, выполняющих команды в терминале, и ваших собственных скриптах
Вход	Один раз на клиент, через браузер	`adapty auth login`, один раз на машину
Лучше подходит для	Вопросов и изменений из чата	Редактирования конфигов флоу, массовых изменений и скриптов
Установка	Ничего не нужно устанавливать	`npm install -g adapty`

Агент может использовать и то, и другое. В приложении Claude MCP-сервер требует меньше настройки, чем CLI: CLI нужно устанавливать и авторизовывать в каждом разговоре, как описано в Настройка Adapty CLI в приложении Claude.

Прежде чем начать

Аккаунт Adapty: Ассистент работает в компаниях и приложениях, к которым у вашего аккаунта Adapty есть доступ, с вашими правами.
MCP-клиент с OAuth: Ваш клиент поддерживает удалённые MCP-серверы, которые входят через OAuth.

Warning

Ассистент действует с вашими правами, и его изменения реальны. Запущенный A/B-тест или изменённый плейсмент сразу достигает ваших пользователей. Прежде чем запустить или остановить A/B-тест, или изменить, кто что видит в плейсменте, сервер просит ассистента описать точный эффект и дождаться вашего подтверждения. Внимательно прочитайте план перед тем, как его одобрить.

Подключите своего ассистента

Приложение Claude (claude.ai и Claude desktop) добавляет удалённые MCP-серверы как пользовательские коннекторы.

Чтобы добавить сервер, откройте Settings → Connectors и нажмите Add custom connector.
Введите название, например Adapty, и URL https://mcp.adapty.io/mcp.
Оставьте настройки аутентификации по умолчанию и нажмите Add.
Войдите в Adapty в открывшейся вкладке браузера. См. Войти.

Администраторы рабочего пространства могут добавить коннектор один раз для всей организации. Каждый участник затем входит со своим аккаунтом Adapty при первом использовании.

Если вы используете плагин adapty-skills, Claude Code уже отображает сервер как plugin:adapty-skills:adapty со статусом Needs authentication. Чтобы войти, выполните /mcp в Claude Code, выберите plugin:adapty-skills:adapty и нажмите Authenticate.

Без плагина сначала добавьте сервер:

claude mcp add --transport http --scope user adapty https://mcp.adapty.io/mcp

Затем выполните /mcp в Claude Code, выберите adapty и нажмите Authenticate. Если инструменты Adapty не появились в текущей сессии, начните новую.

Если вы используете плагин adapty-skills, он добавляет сервер автоматически, а Codex попросит войти в систему при подключении.

Без плагина добавьте сервер и войдите вручную:

codex mcp add adapty --url https://mcp.adapty.io/mcp
codex mcp login adapty

Команда login открывает браузер. Чтобы вместо этого настроить сервер вручную, добавьте его в ~/.codex/config.toml, затем выполните команду login:

[mcp_servers.adapty]
url = "https://mcp.adapty.io/mcp"

Начните новую сессию codex, чтобы загрузить инструменты Adapty.

Добавьте https://mcp.adapty.io/mcp как удалённый MCP-сервер в настройках вашего клиента или в файле конфигурации MCP. При первом подключении клиент откроет браузер для авторизации.

Сервер идентифицирует каждый клиент по его Client ID Metadata Document — методу регистрации клиента, описанному в текущей спецификации MCP. Клиент, не поддерживающий этот метод, не сможет завершить вход. В таком случае используйте Adapty Developer CLI через терминальный агент.

Каждый клиент завершает настройку на одном и том же шаге: открывается страница входа в Adapty в браузере.

Войдите в свой аккаунт Adapty, если ещё не вошли.
Разрешите клиенту доступ к вашему аккаунту Adapty.

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

Чтобы проверить подключение, спросите ассистента, в какой аккаунт Adapty он вошёл. В ответе должны быть указаны ваше имя и компании, доступные вашему аккаунту.

Начало работы

Спросите ассистента, какие приложения ему доступны, а затем укажите приложение, с которым хотите работать. Примеры запросов:

List my Adapty apps and their placements.
How did revenue and new subscriptions change last month compared with the month before?
Which products in Fitness Pro have no App Store product ID?
Show who sees what on the onboarding placement, including any A/B test.
Create a draft A/B test on main_paywall: the current paywall against Annual sale, 50/50.

Помощник запрашивает подтверждение перед шагами, которые меняют то, что видят пользователи. Запрос, который только читает данные, выполняется без дополнительных вопросов.

После многошагового задания помощник может отправить команде Adapty короткую заметку о том, как прошло выполнение задачи. Заметка не содержит персональных данных пользователей вашего приложения.

Отключение

Чтобы отключиться, удалите сервер в клиенте:

Claude app: В Settings → Connectors удалите коннектор Adapty.
Claude Code: Выполните claude mcp remove adapty. Если сервер был установлен с плагином adapty-skills, отключите его через /mcp.
Codex: Удалите сервер adapty из ~/.codex/config.toml.

Чтобы подключиться снова, добавьте сервер и войдите повторно.

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

Проблема	Решение
Claude Code показывает сервер как Needs authentication	Клиент добавил сервер, но не выполнил вход. Запустите `/mcp`, выберите сервер Adapty и нажмите Authenticate.
Клиент не отображает инструменты Adapty	Завершите вход, затем начните новую сессию. Некоторые клиенты загружают инструменты только в начале сессии.
Ассистент не может найти приложение	Приложение принадлежит компании, к которой у вашего аккаунта Adapty нет доступа. Обратитесь к владельцу компании за доступом.
Клиент не может завершить вход	Клиент не поддерживает метод входа, используемый сервером. Подключитесь через приложение Claude, Claude Code или Codex, либо воспользуйтесь Adapty Developer CLI.