Roistat MCP Server

MCP сервер, который подключает Roistat к Claude Desktop.

Поддерживает 16 функций: аналитика, заказы, статистика, звонки, клиенты.

---

Установка

Windows — автоматически (рекомендуется)

1. Скачай файл install-windows.bat из этого репозитория
2. Запусти от имени администратора (правой кнопкой → «Запустить от имени администратора»)
3. Скрипт сам:
   • Проверит Python и установит зависимости
   • Клонирует репозиторий (или скачает ZIP, если git не установлен)
   • Спросит ROISTAT_API_KEY и ROISTAT_PROJECT
   • Пропишет конфиг в Claude Desktop
4. Перезапусти Claude Desktop — готово

Требования: Python 3.10+ с галочкой «Add Python to PATH» при установке, Claude Desktop

---

macOS / Linux — вручную

1. Клонировать репозиторий

git clone https://github.com/NatrixAi/roistat-mcp.git
cd roistat-mcp

2. Установить зависимости

pip install -r requirements.txt

3. Получить данные Roistat

• ROISTAT_API_KEY — Roistat → Настройки → API → Ключ API
• ROISTAT_PROJECT — Roistat → Настройки → Проект → ID проекта

4. Добавить в Claude Desktop

Открыть конфиг Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавить:

{
  "mcpServers": {
    "roistat": {
      "command": "python3",
      "args": ["/path/to/roistat-mcp/server.py"],
      "env": {
        "ROISTAT_API_KEY": "ваш_ключ_API",
        "ROISTAT_PROJECT": "ваш_ID_проекта"
      }
    }
  }
}

На Windows команда python вместо python3, путь через двойные слэши: C:\\Users\\user\\roistat-mcp\\server.py

5. Перезапустить Claude Desktop

---

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

Переменная	Описание	Где взять
ROISTAT_API_KEY	Ключ API	Roistat → Настройки → API
ROISTAT_PROJECT	ID проекта	Roistat → Настройки → Проект

---

Доступные функции

Группа	Функции
Analytics	аналитика, метрики, измерения, воронки
Statistics	ежедневная статистика (сессии, конверсии, ROI)
Orders	список, создание, обновление статусов
Call Tracking	аналитика звонков, скрипты
Clients	управление клиентами, импорт

Лимиты API: 10 запросов/сек, 5000 запросов/день

Примеры использования

Покажи статистику Roistat за сегодня
Какой ROI за последние 7 дней?
Покажи все заказы со статусом "новый"
Обнови статус заказа #12345 на "выполнен"
Покажи аналитику звонков за эту неделю
Сколько конверсий было вчера?

Требования

• Python 3.10+
• Claude Desktop
• Аккаунт Roistat с доступом к API

Лицензия

MIT