Berechtigungen & Limits

Diese Seite behandelt die Funktionsweise von Zugriffskontrolle, Rate Limiting und Fehlerbehandlung für die Zenovay MCP-Integration.

OAuth-Bereiche

Wenn Sie einen MCP-Client autorisieren, wählen Sie Berechtigungsebenen für jede Toolkategorie. Diese werden als OAuth-Bereiche im Format {category}:{level} dargestellt.

Berechtigungsebenen

Verfügbare Bereiche

Kurz-Bereiche:

• read — Alle Kategorien auf Lesebene
• write — Alle Kategorien auf Schreibebene (einschließlich Lesen)

Schreibgeschützte Tools

Die folgenden Tools erfordern Schreib-Berechtigung für ihre Kategorie. Wenn Sie mit reinem Lesezugriff autorisiert wurden, geben diese Tools den Fehlercode -32007 zurück:

Management (Schreiben)

create_goal, update_goal, delete_goal, toggle_goal, manage_funnel, delete_funnel, update_website_settings, toggle_public_dashboard, toggle_cookieless_tracking, regenerate_tracking_code, update_website_name, update_website_timezone, update_website_domain, pause_tracking, resume_tracking, schedule_report, cancel_report, create_api_key, delete_api_key, update_api_key_settings

Einstellungen (Schreiben)

add_ip_exclusion, remove_ip_exclusion, add_path_exclusion, remove_path_exclusion, update_notification_settings, invite_team_member, remove_team_member, set_revenue_currency, add_allowed_domain, remove_allowed_domain, request_data_deletion

Erweitert (Schreiben)

create_uptime_check, delete_uptime_check

Webhooks (Schreiben)

create_webhook, delete_webhook, test_webhook

Alle anderen Tools funktionieren mit Lesezugriff.

Berechtigungen ändern

So ändern Sie die Berechtigungen für einen MCP-Client:

1. Den vorhandenen Token widerrufen — Gehen Sie zu Einstellungen → Sicherheit → MCP, suchen Sie die verbundene Anwendung und widerrufen Sie sie
2. Erneut autorisieren — Ihr MCP-Client fordert Sie erneut zur Autorisierung auf
3. Neue Berechtigungen auswählen — Wählen Sie unterschiedliche Lese-/Schreib-Ebenen auf der Zustimmungsseite

Plangebundene Funktionen

Bestimmte Tools sind an Funktionen gebunden, die spezifische Abonnement-Pläne erfordern:

Das Aufrufen eines Plan-gated Tools in einem nicht unterstützten Plan gibt den Fehlercode -32002 zurück.

Datenaufbewahrungsgrenzen

Analytics-Abfragen werden automatisch auf das Aufbewahrungsfenster Ihres Plans begrenzt:

Rate Limits

Tägliches Abfrage-Limit

Jedes Team hat ein tägliches MCP-Abfrage-Budget. Alle verbundenen Anwendungen teilen sich die gleiche Quote.

Die Nutzung wird täglich um 00:00 UTC zurückgesetzt.

Abfragekosten

Nutzung überprüfen

Verwenden Sie das Tool get_api_usage oder überprüfen Sie Einstellungen → Sicherheit → MCP im Dashboard:

{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_api_usage",
  "arguments": {}
}
}

Fehlercodes

Standard JSON-RPC Fehler

Zenovay MCP Fehler

Fehlerantwort-Format

{
"jsonrpc": "2.0",
"id": 1,
"error": {
  "code": -32007,
  "message": "Tool 'create_goal' requires write permission for the 'management' category. Re-authorize with management:write scope."
}
}

Sicherheit

OAuth 2.1 bietet mehrere Sicherheitsvorteile gegenüber API-Schlüsseln:

1. Keine Geheimnisse zu verwalten — Token werden automatisch ausgestellt, kein Schlüssel zum Kopieren/Einfügen
2. Granulare Bereiche — Gewähren Sie nur die Berechtigungen, die jeder Client benötigt
3. Token-Ablauf — Access-Token laufen nach 1 Stunde ab und aktualisieren sich automatisch
4. Sofortige Sperrung — Widerrufen Sie den Zugriff eines Clients sofort vom Dashboard
5. PKCE-Schutz — Autorisierungscodes können nicht abgefangen werden
6. Audit-Trail — Sehen Sie, welche Clients verbunden sind und wann sie zuletzt Anfragen gestellt haben