roistat-mcp

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

1. Перезапусти 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