# Roistat MCP Server

MCP сервер, который подключает [Roistat](https://roistat.com/) к Claude Desktop.

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

---

## Установка

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

1. Скачай файл [`install-windows.bat`](./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. Клонировать репозиторий

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

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

```bash
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`

Добавить:

```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