Skip to main content
Glama
Roistat MCP Server

Roistat MCP Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors