Servidor MCP de Roistat

Servidor MCP (Model Context Protocol) para la integración con la plataforma de análisis de marketing Roistat. Permite a los agentes de IA (Claude, GPT, etc.) trabajar directamente con los datos de Roistat: analizar estadísticas, gestionar leads, realizar un seguimiento de llamadas y canales.

Funcionalidades

📊 Análisis

Herramienta	Descripción
`roistat_get_statistics`	Estadísticas de marketing: visitas, leads, ROI, CPL por canales/campañas
`roistat_get_report`	Informe flexible con agrupación por días/semanas/meses

🎯 Leads y solicitudes

Herramienta	Descripción
`roistat_list_leads`	Lista de leads con filtrado por fecha y estado
`roistat_get_lead`	Información detallada sobre un lead específico
`roistat_update_lead`	Actualización de estado, ingresos y campos del lead
`roistat_create_lead`	Creación de un nuevo lead (conversiones offline)

📞 Seguimiento de llamadas (Calltracking)

Herramienta	Descripción
`roistat_list_calls`	Historial de llamadas con filtrado
`roistat_get_call`	Detalles de la llamada: fuente, grabación, duración
`roistat_list_phones`	Lista de números de sustitución

📡 Canales publicitarios

Herramienta	Descripción
`roistat_list_channels`	Todos los canales de marketing del proyecto
`roistat_get_channel_costs`	Gastos por canal durante un período
`roistat_set_channel_costs`	Carga manual de gastos (canales offline)

⚙️ Proyecto

Herramienta	Descripción
`roistat_get_project_info`	Información del proyecto, configuración, integraciones
`roistat_list_events`	Eventos de conversión
`roistat_send_event`	Envío manual de un evento de conversión
`roistat_get_billing`	Tarifa, saldo, estadísticas de uso
`roistat_get_mediaplan`	Plan de medios: plan vs. real por canales

Instalación

Requisitos

Node.js 18+
npm o yarn
Cuenta de Roistat con acceso a API

Pasos

git clone <repo-url>
cd roistat-mcp-server
npm install
npm run build

Variables de entorno

# Обязательные
ROISTAT_API_KEY=ваш_api_ключ        # Профиль → API-ключ
ROISTAT_PROJECT_ID=12345            # Номер проекта (из URL или настроек)

# Опциональные
TRANSPORT=stdio                     # или "http" для удалённого сервера
PORT=3000                           # только при TRANSPORT=http

Dónde encontrar la clave API: Roistat → Configuración → Clave API → Copiar

Ejecución

stdio (local, para Claude Desktop / Claude Code)

ROISTAT_API_KEY=xxx ROISTAT_PROJECT_ID=12345 node dist/index.js

HTTP (despliegue remoto, VPS/Docker)

TRANSPORT=http PORT=3000 ROISTAT_API_KEY=xxx ROISTAT_PROJECT_ID=12345 node dist/index.js

Configuración de Claude Desktop

Añada a claude_desktop_config.json:

{
  "mcpServers": {
    "roistat": {
      "command": "node",
      "args": ["/path/to/roistat-mcp-server/dist/index.js"],
      "env": {
        "ROISTAT_API_KEY": "ваш_api_ключ",
        "ROISTAT_PROJECT_ID": "12345"
      }
    }
  }
}

Configuración para HTTP (OpenClaw / MCP remoto)

{
  "mcpServers": {
    "roistat": {
      "url": "http://your-vps-ip:3000/mcp",
      "type": "streamable-http"
    }
  }
}

Despliegue en Docker (para Hostinger VPS)

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist/ ./dist/
EXPOSE 3000
ENV TRANSPORT=http
CMD ["node", "dist/index.js"]

docker build -t roistat-mcp .
docker run -d -p 3000:3000 \
  -e ROISTAT_API_KEY=xxx \
  -e ROISTAT_PROJECT_ID=12345 \
  roistat-mcp

Ejemplos de consultas a Claude

Después de conectar el MCP, pregunte a Claude:

"Muéstrame el ROI por canales de los últimos 30 días"
"¿Cuántos leads llegaron desde Yandex.Direct en marzo?"
"Busca todas las llamadas no atendidas de ayer y crea tareas para ellas"
"Carga gastos de 500 rublos para el canal offline de hoy"
"Compara el CPL de abril con el de marzo por todos los canales"
"Actualiza el estado del lead #12345 a 'Pagado', ingresos 15000 rublos"

Estructura del proyecto

roistat-mcp-server/
├── src/
│   ├── index.ts              # Точка входа, инициализация сервера
│   ├── services/
│   │   └── roistat-client.ts # HTTP-клиент для Roistat API
│   └── tools/
│       ├── analytics.ts      # Статистика и отчёты
│       ├── leads.ts          # Лиды и заявки
│       ├── calltracking.ts   # Коллтрекинг
│       ├── channels.ts       # Каналы и расходы
│       └── project.ts        # Проект, события, биллинг
├── dist/                     # Скомпилированные файлы
├── package.json
└── tsconfig.json

Licencia

MIT

Roistat MCP Server