MCP-Integration

Das Model Context Protocol (MCP) ermöglicht es KI-Assistenten, Ihre Zenovay-Analysen direkt abzufragen. Stellen Sie Fragen wie „Wie viele Besucher hatte ich diese Woche?" oder „Was sind meine Top-Seiten?" und erhalten Sie Live-Daten aus Ihrem Dashboard – ohne Ihre IDE oder Ihren Chat zu verlassen.

Schnellstart

Die Verbindung dauert weniger als eine Minute. Fügen Sie einfach die Server-URL zu Ihrem MCP-Client hinzu – OAuth erledigt den Rest.

1. MCP-Server hinzufügen

Fügen Sie die Zenovay-Server-URL zu Ihrem KI-Client hinzu. Kein API-Schlüssel und keine manuelle Konfiguration erforderlich.

{
"mcpServers": {
  "zenovay-analytics": {
    "url": "https://api.zenovay.com/mcp"
  }
}
}

{
"mcpServers": {
  "zenovay-analytics": {
    "url": "https://api.zenovay.com/mcp"
  }
}
}

{
"servers": {
  "zenovay-analytics": {
    "type": "http",
    "url": "https://api.zenovay.com/mcp"
  }
}
}

{
"mcpServers": {
  "zenovay-analytics": {
    "serverUrl": "https://api.zenovay.com/mcp"
  }
}
}

Sie können den Server auch über die Claude Code CLI hinzufügen:

claude mcp add --transport http zenovay-analytics https://api.zenovay.com/mcp

2. Zugriff autorisieren

Wenn Sie sich zum ersten Mal verbinden, öffnet Ihr MCP-Client ein Browserfenster mit der Zenovay-Autorisierungsseite. Hier können Sie:

• Ihr Team auswählen (falls Sie mehreren Teams angehören)
• Berechtigungen festlegen für jede Tool-Kategorie (Keine / Lesen / Schreiben)
• Auf Autorisieren klicken, um den Zugriff zu gewähren

Dies ist eine einmalige Einrichtung. Ihr MCP-Client speichert das OAuth-Token und aktualisiert es automatisch.

3. Mit dem Abfragen beginnen

Nach der Autorisierung können Sie Ihrem KI-Assistenten Fragen stellen wie:

• „Liste meine Websites auf"
• „Wie viele Besucher hatte zenovay.com diese Woche?"
• „Was sind die Top-10-Seiten nach Traffic?"
• „Vergleiche die Absprungrate dieser Woche mit der letzten Woche"
• „Zeige mir Anomalien in meinem Traffic"
• „Exportiere die letzten 30 Tage der Analyse als CSV"
• „Erstelle ein neues Ziel für meine Anmeldeseite"
• „Zeige mir alle meine Ziele und ihre Konversionsraten"
• „Füge einen IP-Ausschluss für unser Büronetzwerk hinzu"

Funktionsweise der OAuth-Autorisierung

Wenn sich Ihr MCP-Client mit https://api.zenovay.com/mcp verbindet, geschieht Folgendes automatisch:

1. Discovery – Der Client ruft OAuth-Metadaten von /.well-known/oauth-authorization-server ab
2. Registrierung – Der Client registriert sich (einmalig) über Dynamic Client Registration
3. Autorisierung – Ein Browserfenster öffnet sich mit der Zenovay-Einwilligungsseite
4. Token-Austausch – Nach Ihrer Autorisierung tauscht der Client den Code gegen ein Access-Token
5. Verbunden – Alle MCP-Anfragen verwenden das OAuth-Token. Es wird bei Ablauf automatisch erneuert.

Sie können verbundene Anwendungen in Einstellungen > Nutzung in Ihrem Zenovay-Dashboard anzeigen und widerrufen.

Verbindungsdetails

Berechtigungen

Während der Autorisierung wählen Sie die Zugriffsebene für jede Tool-Kategorie:

Tool-Kategorien

Rate-Limits

Tägliche Abfragelimits gelten pro Team (gemeinsam genutzt über alle verbundenen Anwendungen):

Die meisten Tools kosten 1 Abfrage. Das query_analytics-Tool für natürliche Sprache kostet 3 Abfragen aufgrund seiner KI-Verarbeitung.

Die Nutzung wird täglich um 00:00 UTC zurückgesetzt. Prüfen Sie Ihr verbleibendes Kontingent jederzeit mit dem Tool get_api_usage oder in Einstellungen > Nutzung in Ihrem Dashboard.

Plan-Durchsetzung

Einige MCP-Tools sind hinter kostenpflichtigen Plänen freigeschaltet. Tools wie get_session_replays, get_heatmap_data, get_revenue und get_retention_data erfordern ein Abonnement Pro oder höher, während export_data Scale oder höher voraussetzt. Analyseabfragen werden automatisch auf das Datenaufbewahrungsfenster Ihres Plans begrenzt (z. B. 1 Jahr für Free, 2 Jahre für Pro).

{
"jsonrpc": "2.0",
"id": 1,
"error": {
  "code": -32002,
  "message": "This feature requires a paid plan. Upgrade at https://app.zenovay.com/plans"
}
}

Verbundene Anwendungen verwalten

Sie können OAuth-Tokens für verbundene MCP-Clients anzeigen und widerrufen:

1. Gehen Sie zu Einstellungen > Nutzung in Ihrem Zenovay-Dashboard
2. Scrollen Sie zum Abschnitt MCP Requests
3. Sehen Sie tägliche Nutzung, Rate-Limits und die Anzahl verbundener Anwendungen
4. Um den Zugriff zu widerrufen, gehen Sie zu API Keys und verwalten Sie die Tokens dort

Das Widerrufen eines Tokens trennt den MCP-Client sofort. Der Client muss sich erneut autorisieren, um sich wieder zu verbinden.

Fehlerbehandlung

Wenn etwas schiefgeht, gibt der Server einen JSON-RPC-Fehler zurück:

Fehlerbehebung

„Needs authentication" in Claude Code

Das bedeutet, dass der OAuth-Flow noch nicht abgeschlossen wurde. Führen Sie claude mcp list aus, um den Status zu prüfen, und starten Sie dann eine neue Sitzung – Sie werden aufgefordert, die Autorisierung im Browser durchzuführen.

Browser öffnet sich nicht für die Autorisierung

Stellen Sie sicher, dass Ihr MCP-Client OAuth 2.1 unterstützt. Wenn Sie einen älteren Client verwenden, prüfen Sie auf Updates. Allein die Server-URL (https://api.zenovay.com/mcp) sollte die automatische OAuth-Discovery auslösen.

„Invalid or expired OAuth token"

Ihr Token ist abgelaufen und die automatische Erneuerung ist fehlgeschlagen. Entfernen Sie den Server und fügen Sie ihn erneut hinzu:

claude mcp remove zenovay-analytics
claude mcp add --transport http zenovay-analytics https://api.zenovay.com/mcp

Rate-Limit-Fehler

Prüfen Sie Ihre aktuelle Nutzung mit get_api_usage oder unter Einstellungen > Nutzung. Das Tool query_analytics kostet 3 Abfragen – verwenden Sie nach Möglichkeit spezifische Tools wie get_visitors (1 Abfrage).

Prompt für KI-Assistenten

Wenn Ihr KI-Assistent den MCP-Server nicht automatisch erkennt, können Sie diesen Prompt einfügen, um die Verbindung herzustellen:

Connect to the Zenovay Analytics MCP server at https://api.zenovay.com/mcp

Authentication: OAuth 2.1 (automatic). When you first connect, a browser window will open for me to authorize access. No API key is needed.

Setup:
- Server URL: https://api.zenovay.com/mcp
- Transport: HTTP (Streamable HTTP, JSON-RPC 2.0)
- OAuth discovery: https://api.zenovay.com/.well-known/oauth-authorization-server

After connecting, call list_websites first to get my website IDs — every analytics tool requires a website_id parameter.

Available tool categories:
- Analytics (8 tools): visitors, pages, traffic sources, geographic data, real-time
- Advanced (13 tools): funnels, goals, sessions, heatmaps, errors, revenue, uptime
- AI Insights (4 tools): AI-generated insights, anomalies, weekly digest, recommendations
- Management (29 tools): website settings, goals, funnels, tracking, reports
- Settings (16 tools): IP exclusions, notifications, team members, domains
- Webhooks (6 tools): webhook CRUD, deliveries, automation rules

Rate limits: Free 25/day, Pro 100/day, Scale 500/day, Enterprise 10,000/day. The query_analytics tool costs 3 queries; all others cost 1.

Nächste Schritte

• Tools-Referenz – Vollständige Dokumentation aller Tools mit Parametern und Beispielen
• Berechtigungen & Limits – Zugriffsmodi, Rate-Limits und Fehlercodes