Roistat MCP
MCP-сервер для Roistat: отчеты сквозной аналитики, сравнение периодов, заявки, звонки и визиты с маскировкой личных данных
Установка
git clone https://github.com/zai-one/roistat-mcp.git
cd roistat-mcp
uv sync --frozen
uv run --frozen python scripts/configure.py
uv run --frozen roistat-mcp --config mcp.local.json --check-configНужны Python 3.12-3.14 и uv. Мастер спросит ключ API и номера проектов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту данные Roistat по проектам, которые вы разрешили в конфигурации. Агент получает аналитические отчеты с моделями атрибуции, сравнивает периоды, смотрит заказы, статусы, лиды и воронку, а также коллтрекинг, визиты, клиентов и дубли заявок. Телефоны, почта и IP посетителей в поддерживаемых ответах маскируются. Для отчетов есть пакеты за один или два периода с итогами по источникам, точными параметрами запроса и выгрузкой в JSON или CSV. Изменение данных в Roistat по умолчанию закрыто и требует отдельной настройки.
Для кого. Для маркетологов и аналитиков, которые разбирают связь рекламных расходов и продаж в Roistat.
Подходит, если
- Нужно понять, почему упало число заявок или выручка за неделю
- Нужно сравнить два периода по расходам, лидам и продажам
- Нужен отчет с воспроизводимыми параметрами для команды или клиента
Не подходит, если
- Проект не подключен к Roistat
- Нужно массово менять данные в CRM: сервер рассчитан на чтение
Пример запроса к агенту
Сравни прошлую неделю с позапрошлой по моему проекту: расходы, лиды, продажи и выручка. Отдели подтвержденные данными изменения от гипотезОграничения
Нужны ключ API Roistat и номера проектов. Требуются Python 3.12-3.14 и uv, пакета в PyPI нет, ставится из клонированного репозитория или релизного архива. Лицензия собственная, не open source: разрешено пользоваться для своих аккаунтов. Отчеты строятся по фиксированному списку метрик, пустой ответ не означает нулевой активности.
Как отключить. Удалите блок roistat из конфигурации MCP-клиента и папку roistat-mcp вместе с локальными файлами ключей.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Проверка безопасности
- Читает данные CRM и звонков, часть полей с личными данными может остаться немаскированной
- Хранит ключ API Roistat локально
Коротко о README
README на английском и русском описывает задачи, которые закрывает сервер: отчеты, воронка, звонки и визиты, пакеты отчетов. Быстрый старт состоит из клонирования, uv sync и мастера configure.py с проверкой конфигурации. Дан пример блока mcpServers для Claude Desktop и Cursor и первый запрос для проверки. Есть HTTP-режим с авторизацией для серверной установки. Проект сделан агентством ZAI.ONE под собственной лицензией.
Частые вопросы
Может ли агент что-то изменить в Roistat?
По умолчанию нет. Изменения данных требуют отдельной настройки и подтверждения.
Где хранится ключ?
Мастер настройки сохраняет секреты в локальных приватных файлах и не перезаписывает существующую конфигурацию.
Похожие
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов
CLI и скилл для SEO-аудита сайта: техническое SEO, Core Web Vitals, микроразметка, безопасность и готовность к AI-поиску
Маркетплейс из 22 плагинов для Claude Code: Яндекс Директ, Метрика, Вебмастер, Wordstat, SEO-краулер, публикация и ресерч
Пять MCP-серверов для Вордстата, Поиска, Вебмастера, Метрики и Директа плюс плагин Claude Code со скиллами подбора ключей и анализа конкурентов