Skip to main content
Glama
deenesjakoruzh
LuCheremisina

Roistat MCP Server

by LuCheremisina
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Roistat MCP Server

Ein MCP (Model Context Protocol) Server für die Integration mit der Marketing-Analyseplattform Roistat. Er ermöglicht es KI-Agenten (Claude, GPT usw.), direkt mit Roistat-Daten zu arbeiten: Statistiken analysieren, Leads verwalten, Anrufe und Kanäle verfolgen.

Funktionen

📊 Analytik

Tool

Beschreibung

roistat_get_statistics

Marketing-Statistiken: Besuche, Leads, ROI, CPL nach Kanälen/Kampagnen

roistat_get_report

Flexibler Bericht mit Gruppierung nach Tagen/Wochen/Monaten

🎯 Leads und Anfragen

Tool

Beschreibung

roistat_list_leads

Liste der Leads mit Filterung nach Datum und Status

roistat_get_lead

Detaillierte Informationen zu einem bestimmten Lead

roistat_update_lead

Aktualisierung von Status, Umsatz und Lead-Feldern

roistat_create_lead

Erstellung eines neuen Leads (Offline-Conversions)

📞 Call-Tracking

Tool

Beschreibung

roistat_list_calls

Anrufliste mit Filterfunktion

roistat_get_call

Anrufdetails: Quelle, Aufzeichnung, Dauer

roistat_list_phones

Liste der Ersatzrufnummern

📡 Werbekanäle

Tool

Beschreibung

roistat_list_channels

Alle Marketingkanäle des Projekts

roistat_get_channel_costs

Kosten pro Kanal für einen bestimmten Zeitraum

roistat_set_channel_costs

Manuelles Hochladen von Kosten (Offline-Kanäle)

⚙️ Projekt

Tool

Beschreibung

roistat_get_project_info

Projektinformationen, Einstellungen, Integrationen

roistat_list_events

Conversion-Ereignisse

roistat_send_event

Manuelles Senden eines Conversion-Ereignisses

roistat_get_billing

Tarif, Guthaben, Nutzungsstatistik

roistat_get_mediaplan

Mediaplan: Plan vs. Ist nach Kanälen

Installation

Anforderungen

  • Node.js 18+

  • npm oder yarn

  • Roistat-Konto mit API-Zugriff

Schritte

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

Umgebungsvariablen

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

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

Wo finde ich den API-Schlüssel: Roistat → Einstellungen → API-Schlüssel → Kopieren

Start

stdio (lokal, für Claude Desktop / Claude Code)

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

HTTP (Remote-Bereitstellung, VPS/Docker)

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

Konfiguration von Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

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

Konfiguration für HTTP (OpenClaw / Remote MCP)

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

Docker-Deployment (für 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

Beispiele für Anfragen an Claude

Fragen Sie Claude nach der Verbindung des MCP:

  • "Zeige mir den ROI nach Kanälen für die letzten 30 Tage"

  • "Wie viele Leads kamen im März über Yandex.Direct?"

  • "Finde alle entgangenen Anrufe von gestern und erstelle Aufgaben dafür"

  • "Lade die Kosten für den Offline-Kanal 500 Rubel für heute hoch"

  • "Vergleiche den CPL von April mit März über alle Kanäle"

  • "Aktualisiere den Status von Lead #12345 auf 'Bezahlt', Umsatz 15000 Rubel"

Projektstruktur

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

Lizenz

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors