clevertap-mcp

Сервер Model Context Protocol (MCP) для CleverTap REST API. Предоставляет профили пользователей, события, кампании и отчеты CleverTap в виде инструментов, которые может напрямую вызывать любой ИИ-ассистент с поддержкой MCP (Claude, Cursor и т. д.).

Функции

Мультипроектность — управление несколькими аккаунтами CleverTap из одного экземпляра сервера
Пошаговая настройка — если проект не настроен, clevertap_configure поможет вам пройти этот процесс
Полное покрытие API — события, профили, кампании и отчеты
Асинхронный опрос — длительные операции (подсчет событий/профилей) опрашиваются автоматически

Инструменты

Мета

Инструмент	Описание
`clevertap_configure`	Пошаговая настройка для добавления проекта или генерации конфигурации `CLEVERTAP_PROJECTS`
`clevertap_list_projects`	Список всех настроенных проектов и их регионов

События

Инструмент	Описание
`clevertap_upload_events`	Загрузка одного или нескольких событий для пользователя
`clevertap_get_events`	Запрос данных о событиях с фильтрами
`clevertap_get_events_cursor`	Получение следующей страницы результатов событий через курсор
`clevertap_get_event_count`	Получение общего количества событий (с асинхронным опросом)

Профили

Инструмент	Описание
`clevertap_upload_profiles`	Создание или обновление профилей пользователей
`clevertap_get_profile`	Поиск одного пользователя по идентификатору, email или objectId
`clevertap_get_profiles_by_event`	Получение профилей пользователей, совершивших событие
`clevertap_get_profiles_cursor`	Получение следующей страницы результатов профилей через курсор
`clevertap_delete_profile`	Удаление профиля пользователя
`clevertap_upload_device_token`	Регистрация push-токена для пользователя
`clevertap_get_profile_count`	Подсчет профилей, соответствующих сегменту
`clevertap_demerge_profiles`	Разделение объединенных профилей
`clevertap_subscribe`	Подписка/отписка пользователя от каналов
`clevertap_disassociate_phone`	Удаление номера телефона из профиля

Кампании

Инструмент	Описание
`clevertap_get_campaigns`	Список кампаний в заданном диапазоне дат
`clevertap_get_campaign_report`	Получение статистики доставки и вовлеченности для кампании
`clevertap_stop_campaign`	Остановка запущенной кампании
`clevertap_create_campaign`	Создание и запуск кампании

Отчеты

Инструмент	Описание
`clevertap_get_message_report`	Отчет о доставке на уровне сообщений
`clevertap_get_top_property_count`	Подсчет значений топ-свойств для события
`clevertap_get_event_trend`	Дневной/недельный/месячный тренд для события
`clevertap_get_dau`	Тренд ежедневных активных пользователей (DAU)
`clevertap_get_uninstall_report`	Отчет о тренде удалений приложения
`clevertap_get_real_time_counts`	Количество активных пользователей в реальном времени

Общие

Инструмент	Описание
`clevertap_request`	Выполнение любого произвольного запроса к REST API
`clevertap_poll`	Опрос ожидающего асинхронного запроса по `req_id`

Веб / Браузер

Инструмент	Описание
`clevertap_web_login`	Открытие окна Chromium и захват cookie сессии панели управления + CSRF-токена после ручного входа (поддерживает SSO и 2FA)
`clevertap_web_session_status`	Проверка, была ли захвачена веб-сессия для проекта и когда она была получена
`clevertap_web_request`	Выполнение аутентифицированного запроса к любому эндпоинту панели управления CleverTap с использованием захваченной сессии
`clevertap_get_campaigns_ui`	Список кампаний из API веб-интерфейса панели управления — более полные данные, чем в REST API (статус, отправлено, показы, клики, URL редактирования)
`clevertap_send_test_push`	Отправка тестового push-уведомления на конкретный токен устройства. Принимает push-токен из `clevertap_get_profile` (`platformInfo[].push_token`), целевую платформу (`ios`/`android`), имя push-канала и опциональный URL глубокой ссылки (deep link).

Предварительное требование для веб-инструментов: установите бинарный файл Playwright Chromium один раз после npm install:
npx playwright install chromium

Установка

git clone https://github.com/your-org/clevertap-mcp.git
cd clevertap-mcp
npm install
npx playwright install chromium   # required for web/browser tools
npm run build

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

Сервер считывает учетные данные проекта из переменной окружения CLEVERTAP_PROJECTS — JSON-массива объектов проектов:

[
  {
    "name": "My App - Production",
    "account_id": "XXX-XXX-XXXX",
    "passcode": "YYY-YYY-YYYY",
    "region": "us1"
  },
  {
    "name": "My App - Staging",
    "account_id": "AAA-AAA-AAAA",
    "passcode": "BBB-BBB-BBBB",
    "region": "us1"
  }
]

Поддерживаемые регионы: in1, us1, eu1, sg1, aps3, mec1

Резервный вариант для одного проекта

Вы также можете использовать отдельные переменные окружения для одного проекта:

CLEVERTAP_ACCOUNT_ID=XXX-XXX-XXXX
CLEVERTAP_PASSCODE=YYY-YYY-YYYY
CLEVERTAP_REGION=us1

Добавление в Claude Desktop

В вашем файле claude_desktop_config.json (или ~/.claude.json):

{
  "mcpServers": {
    "clevertap": {
      "command": "node",
      "args": ["/absolute/path/to/clevertap-mcp/dist/index.js"],
      "env": {
        "CLEVERTAP_PROJECTS": "[{\"name\":\"My App\",\"account_id\":\"XXX-XXX-XXXX\",\"passcode\":\"YYY-YYY-YYYY\",\"region\":\"us1\"}]"
      }
    }
  }
}

Важно: CLEVERTAP_PROJECTS должен быть сериализованной JSON-строкой (не нативным JSON-объектом) внутри блока env.

Разработка

npm run build      # compile TypeScript → dist/
npm run dev        # watch mode
npm start          # run compiled server

Структура проекта

src/
  index.ts          # MCP server entry point, project config, tool registration
  client.ts         # CleverTap REST API HTTP client
  tools/
    events.ts       # Event upload and query tools
    profiles.ts     # Profile management tools
    campaigns.ts    # Campaign tools
    reports.ts      # Analytics and report tools
    generic.ts      # Raw request / poll tools
    web.ts          # Browser session tools via Playwright (login, campaigns UI, test push)

Лицензия

MIT

clevertap-mcp

clevertap-mcp

Функции

Инструменты

Мета

События

Профили

Кампании

Отчеты

Общие

Веб / Браузер

Установка

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

Резервный вариант для одного проекта

Добавление в Claude Desktop

Разработка

Структура проекта

Лицензия

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API