@retainq/mcp

RetainQ MCP Server — Подключите ИИ-ассистентов к вашей платформе для снижения оттока.

Что это?

Это сервер Model Context Protocol (MCP) для RetainQ. Он позволяет ИИ-ассистентам (таким как Claude, Cursor, Kiro и др.) взаимодействовать с вашим рабочим пространством RetainQ — запрашивать метрики удержания, управлять флоу, анализировать данные об оттоке и многое другое.

Related MCP server: Custify MCP Server

Установка

npx @retainq/mcp

Или установите глобально:

npm install -g @retainq/mcp

Конфигурация

Переменная окружения

Укажите ваш API-ключ RetainQ:

export RETAINQ_API_KEY=rq_live_your_key_here

Получите API-ключ в разделе Настройки → API-ключи в вашей панели управления RetainQ.

Конфигурация MCP-клиента

Добавьте в конфигурацию вашего MCP-клиента (например, Claude Desktop, Kiro, Cursor):

{
  "mcpServers": {
    "retainq": {
      "command": "npx",
      "args": ["@retainq/mcp"],
      "env": {
        "RETAINQ_API_KEY": "rq_live_your_key_here"
      }
    }
  }
}

Доступные инструменты (32)

Аналитика

• get_retention_stats — Обзор метрик рабочего пространства

• get_recent_sessions — Последние сессии флоу с результатами

• get_top_churn_reasons — Причины отмен, отсортированные по частоте

• get_high_risk_customers — Клиенты выше порога риска оттока

• get_offer_performance — Показатели принятия предложений и выручка

Флоу

• list_flows — Список всех флоу

• get_flow — Получить детали флоу

• create_flow — Создать новый флоу (простой или продвинутый)

• update_flow — Обновить метаданные флоу

• delete_flow — Архивировать флоу

• configure_simple_flow — Задать конфигурацию простого флоу (опрос, предложения, обратная связь, дизайн)

• set_advanced_flow_schema — Задать схему флоу на основе узлов

• publish_flow — Опубликовать и сделать активным

• get_flow_schema — Получить текущую опубликованную схему

Предложения

• list_offers — Список всех предложений по удержанию

• create_offer — Создать новое предложение

• update_offer — Обновить предложение

• delete_offer — Архивировать предложение

Клиенты

• list_customers — Список клиентов с оценками риска оттока

• get_customer — Получить клиента по email

• get_customer_sessions — Получить историю сессий клиента

Возможности

• list_opportunities — Список возможностей по удержанию

• confirm_opportunity — Подтвердить/выполнить возможность

• reject_opportunity — Отклонить возможность

ИИ-интеллект

• run_churn_analysis — Запустить анализ оттока на основе ИИ

• ask_ai — Задать вопрос ИИ RetainQ о ваших данных

Уведомления

• list_notifications — Получить последние уведомления

• get_notification_preferences — Получить настройки уведомлений

• update_notification_preferences — Обновить настройки уведомлений

Обратная связь

• list_feedback — Получить обратную связь/ответы по сессиям

• export_feedback_csv — Экспортировать обратную связь в CSV

Базовый URL API

По умолчанию подключается к https://app.retainq.com/api/v1/public. Переопределить можно с помощью:

export RETAINQ_API_URL=http://localhost:3000/api/v1/public

Лицензия

MIT