clevertap-mcp

Ein Model Context Protocol (MCP)-Server für die CleverTap REST-API. Er stellt CleverTaps Benutzerprofile, Ereignisse, Kampagnen und Berichte als Tools bereit, die von jedem MCP-kompatiblen KI-Assistenten (Claude, Cursor usw.) direkt aufgerufen werden können.

Funktionen

Multi-Projekt — Verwalten Sie mehrere CleverTap-Konten über eine einzige Serverinstanz
Geführte Einrichtung — Wenn kein Projekt konfiguriert ist, führt Sie clevertap_configure durch den Prozess
Vollständige API-Abdeckung — Ereignisse, Profile, Kampagnen und Berichte
Asynchrones Polling — Lang laufende Vorgänge (Ereignis-/Profilzählungen) werden automatisch abgefragt

Tools

Ereignisse

Tool	Beschreibung
`clevertap_upload_events`	Ein oder mehrere Ereignisse für einen Benutzer hochladen
`clevertap_get_events`	Ereignisdaten mit Filtern abfragen
`clevertap_get_events_cursor`	Die nächste Seite der Ereignisergebnisse über einen Cursor abrufen
`clevertap_get_event_count`	Die Gesamtzahl eines Ereignisses abrufen (mit asynchronem Polling)

Profile

Tool	Beschreibung
`clevertap_upload_profiles`	Benutzerprofile erstellen oder aktualisieren
`clevertap_get_profile`	Einen einzelnen Benutzer anhand von Identität, E-Mail oder objectId suchen
`clevertap_get_profiles_by_event`	Profile von Benutzern abrufen, die ein Ereignis durchgeführt haben
`clevertap_get_profiles_cursor`	Die nächste Seite der Profilergebnisse über einen Cursor abrufen
`clevertap_delete_profile`	Ein Benutzerprofil löschen
`clevertap_upload_device_token`	Ein Push-Token für einen Benutzer registrieren
`clevertap_get_profile_count`	Profile zählen, die einem Segment entsprechen
`clevertap_demerge_profiles`	Zusammengeführte Profile trennen
`clevertap_subscribe`	Einen Benutzer für Kanäle abonnieren/abmelden
`clevertap_disassociate_phone`	Eine Telefonnummer aus einem Profil entfernen

Kampagnen

Tool	Beschreibung
`clevertap_get_campaigns`	Kampagnen innerhalb eines Datumsbereichs auflisten
`clevertap_get_campaign_report`	Zustellungs- und Interaktionsstatistiken für eine Kampagne abrufen
`clevertap_stop_campaign`	Eine laufende Kampagne stoppen
`clevertap_create_campaign`	Eine Kampagne erstellen und starten

Berichte

Tool	Beschreibung
`clevertap_get_message_report`	Zustellungsbericht auf Nachrichtenebene
`clevertap_get_top_property_count`	Zählungen der häufigsten Eigenschaftswerte für ein Ereignis
`clevertap_get_event_trend`	Täglicher/wöchentlicher/monatlicher Trend für ein Ereignis
`clevertap_get_dau`	Trend der täglich aktiven Benutzer
`clevertap_get_uninstall_report`	Deinstallationstrend-Bericht
`clevertap_get_real_time_counts`	Echtzeit-Zählungen aktiver Benutzer

Allgemein

Tool	Beschreibung
`clevertap_request`	Eine beliebige rohe REST-API-Anfrage stellen
`clevertap_poll`	Eine ausstehende asynchrone Anfrage per `req_id` abfragen

Web / Browser

Tool	Beschreibung
`clevertap_web_login`	Ein Chromium-Fenster öffnen und das Dashboard-Sitzungs-Cookie + CSRF-Token nach manuellem Login erfassen (unterstützt SSO und 2FA)
`clevertap_web_session_status`	Überprüfen, ob eine Websitzung für ein Projekt erfasst wurde und wann sie erhalten wurde
`clevertap_web_request`	Eine authentifizierte Anfrage an einen beliebigen CleverTap-Dashboard-Endpunkt unter Verwendung der erfassten Sitzung stellen
`clevertap_get_campaigns_ui`	Kampagnen über die Dashboard-UI-API auflisten — reichhaltigere Daten als die REST-API (Status, gesendet, Impressionen, Klicks, Bearbeitungs-URL)
`clevertap_send_test_push`	Eine Test-Push-Benachrichtigung an ein bestimmtes Geräte-Token senden. Akzeptiert das Push-Token von `clevertap_get_profile` (`platformInfo[].push_token`), die Zielplattform (`ios`/`android`), den Namen des Push-Kanals und eine optionale Deep-Link-URL.

Voraussetzung für Web-Tools: Installieren Sie das Playwright Chromium-Binary einmal nach npm install:
npx playwright install chromium

Installation

git clone https://github.com/your-org/clevertap-mcp.git
cd clevertap-mcp
npm install
npx playwright install chromium   # required for web/browser tools
npm run build

Konfiguration

Der Server liest Projektanmeldeinformationen aus der Umgebungsvariablen CLEVERTAP_PROJECTS — ein JSON-Array von Projektobjekten:

[
  {
    "name": "My App - Production",
    "account_id": "XXX-XXX-XXXX",
    "passcode": "YYY-YYY-YYYY",
    "region": "us1"
  },
  {
    "name": "My App - Staging",
    "account_id": "AAA-AAA-AAAA",
    "passcode": "BBB-BBB-BBBB",
    "region": "us1"
  }
]

Unterstützte Regionen: in1, us1, eu1, sg1, aps3, mec1

Fallback für ein einzelnes Projekt

Sie können auch einzelne Umgebungsvariablen für ein einzelnes Projekt verwenden:

CLEVERTAP_ACCOUNT_ID=XXX-XXX-XXXX
CLEVERTAP_PASSCODE=YYY-YYY-YYYY
CLEVERTAP_REGION=us1

Zu Claude Desktop hinzufügen

In Ihrer claude_desktop_config.json (oder ~/.claude.json):

{
  "mcpServers": {
    "clevertap": {
      "command": "node",
      "args": ["/absolute/path/to/clevertap-mcp/dist/index.js"],
      "env": {
        "CLEVERTAP_PROJECTS": "[{\"name\":\"My App\",\"account_id\":\"XXX-XXX-XXXX\",\"passcode\":\"YYY-YYY-YYYY\",\"region\":\"us1\"}]"
      }
    }
  }
}

Wichtig: CLEVERTAP_PROJECTS muss ein serialisierter JSON-String (kein natives JSON-Objekt) innerhalb des env-Blocks sein.

Entwicklung

npm run build      # compile TypeScript → dist/
npm run dev        # watch mode
npm start          # run compiled server

Projektstruktur

src/
  index.ts          # MCP server entry point, project config, tool registration
  client.ts         # CleverTap REST API HTTP client
  tools/
    events.ts       # Event upload and query tools
    profiles.ts     # Profile management tools
    campaigns.ts    # Campaign tools
    reports.ts      # Analytics and report tools
    generic.ts      # Raw request / poll tools
    web.ts          # Browser session tools via Playwright (login, campaigns UI, test push)

Lizenz

MIT

clevertap-mcp

clevertap-mcp

Funktionen

Tools

Meta

Ereignisse

Profile

Kampagnen

Berichte

Allgemein

Web / Browser

Installation

Konfiguration

Fallback für ein einzelnes Projekt

Zu Claude Desktop hinzufügen

Entwicklung

Projektstruktur

Lizenz

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

Tool	Beschreibung
`clevertap_configure`	Geführte Einrichtung zum Hinzufügen eines Projekts oder zum Generieren der `CLEVERTAP_PROJECTS`-Konfiguration
`clevertap_list_projects`	Alle konfigurierten Projekte und deren Regionen auflisten