Churnkey MCP — удержание подписчиков
Churnkey MCP
MCP-сервер Churnkey: агент читает данные об отменах подписок, правит сценарии удержания и ведет A/B-тесты
- 24 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент меняет настройки биллинга и публикует сценарии, которые сразу видят клиенты, а ошибка бьет по выручке
- Инструмент dsr_access читает данные клиента по email, а персональные поля раскрываются отдельным правом
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/churnkey-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент меняет настройки биллинга и публикует сценарии, которые сразу видят клиенты, а ошибка бьет по выручке
- Инструмент dsr_access читает данные клиента по email, а персональные поля раскрываются отдельным правом
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Churnkey собирает сценарии, которые встречают клиента при отмене подписки: опрос о причине, скидку, паузу, смену тарифа. В репозитории churnkey/sdk лежат три пакета: компонент React для сценария отмены, серверный пакет для токенов и @churnkey/mcp. MCP-сервер читает данные аккаунта Churnkey: сессии отмены, результаты по типам предложений, возвраты платежей по неудачным списаниям, журнал аудита. Он же правит конфигурацию. Агент создает черновик сценария, меняет шаги и предложения, добавляет и переставляет варианты опроса, настраивает сегменты аудитории и запускает A/B-тест. Публикация черновика требует подтверждения и пишется в журнал аудита. Отдельные инструменты правят письма и SMS кампаний по возврату платежей, домены размещенных страниц и настройки биллинга: пропорции, срок отмены, поведение паузы. Просмотр данных клиента по email (запрос GDPR и CCPA) есть, а удаление данных намеренно оставлено вне MCP.
Для кого. Продуктовым командам SaaS с подписками, которые держат отмены и возвраты платежей в Churnkey и хотят разбирать их вместе с агентом.
Подходит, если
- За квартал выросли отмены, и надо понять, на каких тарифах и причинах теряются клиенты
- Скидку при отмене хочется заменить паузой и сравнить результат в A/B-тесте
- Письма по неудачным платежам устарели, и их нужно переписать по шагам кампании
- Для нового сегмента клиентов нужен отдельный сценарий отмены с собственными предложениями
- Перед релизом стоит проверить журнал аудита: кто и что менял в потоке
Не подходит, если
- Нужен только компонент отмены для React: он ставится пакетом @churnkey/react и в MCP не нуждается
- Нужно удалить данные клиента: удаление через MCP не предусмотрено, оно идет в панели или через Data API
- Менять боевой сценарий хочется без согласования: публикация и правка живых сегментов меняют то, что видят клиенты
- Нужны свежие цифры за последние минуты: сессии обновляются примерно раз в три часа
Пример запроса к агенту
Покажи сводку по удержанию за 90 дней и скажи, какой тип предложения спасает больше всего клиентов на годовом тарифе.MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
CHURNKEY_MODE- live или test: режим данных сессий, по умолчанию live
CHURNKEY_CONFIG_DIR- Каталог для токенов, по умолчанию ~/.churnkey
CHURNKEY_API_URL- Адрес API, по умолчанию https://api.churnkey.co/v1
Ограничения
Администратор рабочего пространства должен включить MCP-доступ для вашего пользователя в разделе Team. Без этого вход не пройдет.
Сессии в аналитике обновляются примерно раз в три часа, кампании по возврату платежей раз в 20 минут.
Поля с персональными данными клиентов приходят скрытыми, пока вы не дадите им отдельные права при входе.
Ключи Data API для MCP считаются устаревшими: они дают только чтение, а изменения конфигурации с ними отклоняются.
Как отключить. Удалите сервер командой claude mcp remove churnkey. Сессию отзовите командой npx @churnkey/mcp auth logout: она отзывает токен и стирает файл с токенами в каталоге ~/.churnkey.
Частые вопросы
Как подключить Churnkey MCP к Claude Code?
Сначала войдите командой npx @churnkey/mcp auth login: откроется браузер с экраном согласия. Затем выполните claude mcp add churnkey -- npx -y @churnkey/mcp и перезапустите сессию Claude Code. Ключи в конфиг вставлять не нужно.
Нужен ли ключ API?
Нет, вход идет через OAuth 2.1 от имени вашего пользователя Churnkey. Права берутся из вашей роли, а на экране согласия их можно сузить. Старые ключи Data API еще работают, но только на чтение.
Может ли агент опубликовать сценарий без меня?
Технически может, но инструмент publish_blueprint требует параметр подтверждения, а запись попадает в журнал аудита с вашим именем. Попросите агента показывать черновик перед публикацией.
Как отличить тестовые данные от боевых?
Переменная CHURNKEY_MODE=test включает тестовый режим для аналитики сессий. Конфигурация сценариев и кампаний общая для обоих режимов, поэтому правки видны и там, и там.
Нужно ли ставить компонент React, чтобы пользоваться MCP?
Нет. MCP-сервер работает с аккаунтом Churnkey и не требует @churnkey/react в вашем приложении. Компонент нужен, если сценарий отмены вы встраиваете в свой интерфейс.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыРазмещенный MCP-сервер для Amazon Ads и Seller Central: агент разбирает ACoS, поисковые фразы и остатки, правки по подтверждению
Открытая CRM для малых команд с MCP: контакты, сделки и задачи доступны Claude и другим агентам, черновики ответов за вами
MCP для руководителя отдела продаж в amoCRM
amoCRM ROP MCP Server
MCP-сервер с бизнес-инструментами поверх amoCRM для руководителя отдела продаж: сводка, зависшие сделки, сравнение менеджеров
Набор MCP-серверов для Wildberries, Ozon, Яндекс Маркета, Битрикс24, amoCRM, Авито, Директа, Метрики, Вебмастера и DaData, локально бесплатно
MCP-сервер SendPulse для WhatsApp и SMS
SendPulse MCP Server
MCP-сервер для WhatsApp-ботов и SMS в SendPulse: контакты, сообщения с кнопками, сценарии, триггеры и живой чат
RetailCRM MCP
retailcrm-mcp
MCP-сервер RetailCRM: заказы, клиенты, товары, остатки, оплаты, задачи и аналитика магазина через API v5
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Churnkey MCP — удержание подписчиков (эта карточка) | да | OAuth | 24 | |
| MCP-сервер Paddle Billing | да | API-ключ | 50 | работает с биллингом Paddle, а не со сценариями отмены и возвратом платежей |
| Stripe AI | да | OAuth | 2 059 | инструменты платежной платформы Stripe, без сценариев удержания |
Коротко о README
README репозитория описывает три пакета: @churnkey/react с готовым сценарием отмены, @churnkey/node для серверных токенов и @churnkey/mcp. Пакеты публикуются в npm с подтверждением происхождения, а MCP-сервер выходит и в реестре MCP.