Integrations
Used for managing environment variables, specifically storing the Klaviyo API key securely in a .env file for authentication.
Used for package management, installing dependencies, and running scripts for the MCP server including development and testing modes.
Klaviyo MCP Server verbessert
Ein umfassender Model Context Protocol (MCP)-Server für die Interaktion mit der Klaviyo-API. Diese erweiterte Version bietet erweiterte Analysefunktionen, Leistungsoptimierungen und robuste Fehlerbehandlung bei gleichzeitiger vollständiger Kompatibilität mit dem ursprünglichen MCP-Server.
🌟 Hauptfunktionen
- Erweiterte Analysen und Berichte : Zugriff auf Leistungskennzahlen der Kampagne, aggregierte Daten und detaillierte Einblicke
- Umfassende API-Abdeckung : Unterstützung für alle Klaviyo-API-Endpunkte mit der neuesten Revision (15.06.2024)
- Leistungsoptimierungen : Intelligentes Caching, Ratenbegrenzungshandling und effiziente Datenverarbeitung
- Robuste Fehlerbehandlung : Fallback-Mechanismen, detaillierte Protokollierung und sanfte Degradation
- Einfache Integration : Nahtlose Integration mit Claude und anderen LLMs über das Model Context Protocol
📊 Analyse- und Berichtsfunktionen
Diese erweiterte Version fügt leistungsstarke Analysefunktionen hinzu, die im Original nicht verfügbar waren:
- Kennzahlen zur Kampagnenleistung : Öffnungsraten, Klickraten, Absprungraten und mehr
- Benutzerdefinierte Metrikaggregation : Aggregieren Sie Metriken nach Zeiträumen, Dimensionen und Messungen
- Umsatzzuordnung : Verfolgen Sie den durch Kampagnen und Flows generierten Umsatz
- Abonnenten-Einblicke : Analysieren Sie Abonnentenwachstum, Engagement und Verhalten
🔧 Technische Verbesserungen
1. Zentralisierte Konfiguration ✅
- Ein zentrales Konfigurationssystem (
src/config.js
) für alle API-Parameter wurde erstellt - API-Revisionsdatum, gültige Statistiken und andere Parameter leicht konfigurierbar gemacht
- Verhinderung von Inkonsistenzen zwischen verschiedenen Dateien bei Änderungen der API-Parameter
2. Verbessertes Protokollierungssystem ✅
- Implementierung eines robusten Protokollierungssystems mit verschiedenen Protokollebenen (Debug, Info, Warn, Fehler)
- Spezielle Protokollierung für API-Anfragen und -Antworten hinzugefügt
- Maskierung sensibler Daten in Protokollen aus Sicherheitsgründen
- Konfigurierbare Protokollziele und Ausführlichkeit
3. Intelligente Ratenbegrenzung ✅
- Wiederholungslogik für Ratenbegrenzungsfehler hinzugefügt
- Exponentielles Backoff mit Jitter für Wiederholungsversuche implementiert
- Klare Rückmeldung beim Erreichen von Ratenbegrenzungen hinzugefügt
- Priorisierung kritischer Anfragen während der Ratenbegrenzung
4. Leistungs-Caching ✅
- Implementiertes In-Memory-Caching für häufig abgerufene Daten
- Cache-Invalidierung basierend auf TTL (Time-to-Live) hinzugefügt
- Optimierter Cache für verschiedene Datentypen (Metriken, Kampagnen usw.)
- Cache-Statistiken zur Überwachung und Optimierung
5. Fehlerbehandlung und Fallbacks ✅
- Umfassende Fehlerbehandlung für alle API-Interaktionen
- Fallback-Mechanismen für eingeschränkten Betrieb, wenn primäre Anforderungen fehlschlagen
- Detaillierte Fehlermeldungen und Informationen zur Fehlerbehebung
- Vermeidung und Behandlung von JSON-Analysefehlern
🔄 API-Version
Diese erweiterte Version verwendet die Klaviyo API Revision 2024-06-15
, die die neuesten Funktionen und Verbesserungen enthält. Der Server ist durch das zentrale Konfigurationssystem auf Vorwärtskompatibilität mit zukünftigen API-Revisionen ausgelegt.
📋 Namensnennung
Dieses Projekt ist eine erweiterte Version des ursprünglichen Klaviyo MCP-Servers von Matt Coatsworth . Die ursprüngliche Arbeit bildete die Grundlage für diese erweiterte Version.
🚀 Erste Schritte
Voraussetzungen
- Node.js v18 oder höher
- Ein Klaviyo-Konto mit API-Zugriff
- Ein privater API-Schlüssel mit entsprechenden Bereichen (Kampagnen: Lesen, Metriken: Lesen usw.)
Installation
- Klonen Sie dieses Repository:Copy
- Installieren Sie Abhängigkeiten:Copy
- Erstellen Sie eine
.env
Datei basierend auf.env.example
:Copy - Bearbeiten Sie die
.env
Datei, um Ihren Klaviyo-API-Schlüssel hinzuzufügen:Copy
Starten des Servers
Starten Sie den Server im Entwicklungsmodus mit automatischem Neuladen:
Für den Produktionseinsatz:
Testen mit MCP Inspector
Sie können den Server mit dem MCP Inspector testen:
Dadurch wird eine Weboberfläche geöffnet, in der Sie alle verfügbaren Tools und Ressourcen testen können.
📚 Dokumentation
Ausführliche Informationen zu den Analysefunktionen und API-Parametern finden Sie unter:
- ANALYTICS.md – Umfassende Dokumentation zu Analysefunktionen und -nutzung
- docs/KLAVIYO_API_REFERENCE.md – Referenz für Klaviyo-API-Parameter
🔍 Anwendungsbeispiele
Abrufen von Kennzahlen zur Kampagnenleistung
Abfragen aggregierter Metriken
Abrufen einer Zusammenfassung der Kampagnenleistung
🛠️ Verfügbare Tools
Analyse und Berichterstattung (Neu in der erweiterten Version)
get_campaign_metrics
: Erhalten Sie Leistungsmetriken für eine bestimmte Kampagne (Öffnungsraten, Klickraten usw.).query_metric_aggregates
: Abfrage aggregierter Metrikdaten für benutzerdefinierte Analyseberichteget_campaign_performance
: Erhalten Sie eine umfassende Leistungsübersicht für eine Kampagne
Kampagnen (Erweitert)
get_campaigns
: Holen Sie sich Kampagnen von Klaviyoget_campaign
: Holen Sie sich eine bestimmte Kampagne von Klaviyoget_campaign_message
: Erhalten Sie eine bestimmte Kampagnennachricht mit Vorlagendetailsget_campaign_messages
: Alle Nachrichten für eine bestimmte Kampagne abrufenget_campaign_recipient_estimation
: Ruft die geschätzte Empfängerzahl für eine Kampagne ab
Profile
get_profiles
: Profile von Klaviyo abrufenget_profile
: Holen Sie sich ein bestimmtes Profil von Klaviyocreate_profile
: Erstellen Sie ein neues Profil in Klaviyoupdate_profile
: Aktualisieren Sie ein vorhandenes Profil in Klaviyodelete_profile
: Löscht ein Profil aus Klaviyo
Listen und Segmente
get_lists
: Listen von Klaviyo abrufenget_list
: Holen Sie sich eine bestimmte Liste von Klaviyocreate_list
: Erstellen Sie eine neue Liste in Klaviyoadd_profiles_to_list
: Profile zu einer Liste in Klaviyo hinzufügenget_segments
: Segmente von Klaviyo abrufenget_segment
: Holen Sie sich ein bestimmtes Segment von Klaviyo
Ereignisse und Kennzahlen
get_events
: Ereignisse von Klaviyo abrufencreate_event
: Erstellen Sie ein neues Ereignis in Klaviyoget_metrics
: Metriken von Klaviyo abrufenget_metric
: Holen Sie sich eine bestimmte Metrik von Klaviyo
Flüsse
get_flows
: Flows von Klaviyo abrufenget_flow
: Holen Sie sich einen bestimmten Flow von Klaviyoupdate_flow_status
: Aktualisieren Sie den Status eines Flows in Klaviyo
Inhaltsverwaltung
get_templates
: Vorlagen von Klaviyo abrufenget_template
: Holen Sie sich eine bestimmte Vorlage von Klaviyocreate_template
: Erstellen Sie eine neue Vorlage in Klaviyoget_images
: Bilder von Klaviyo abrufenget_image
: Holen Sie sich ein bestimmtes Bild von Klaviyo
E-Commerce
get_catalogs
: Kataloge von Klaviyo abrufenget_catalog_items
: Artikel aus einem Katalog in Klaviyo abrufenget_catalog_item
: Holen Sie sich einen bestimmten Artikel aus einem Katalog in Klaviyoget_coupons
: Holen Sie sich Gutscheine von Klaviyocreate_coupon_code
: Erstellen Sie einen neuen Gutscheincode in Klaviyo
Weitere Tools
get_tags
: Holen Sie sich Tags von Klaviyocreate_tag
: Erstellen Sie ein neues Tag in Klaviyoadd_tag_to_resource
: Fügen Sie einer Ressource in Klaviyo ein Tag hinzuget_webhooks
: Holen Sie sich Webhooks von Klaviyocreate_webhook
: Erstellen Sie einen neuen Webhook in Klaviyodelete_webhook
: Einen Webhook aus Klaviyo löschenrequest_profile_deletion
: Fordern Sie die Löschung eines Profils zur Einhaltung des Datenschutzes anget_forms
: Formulare von Klaviyo abrufenget_form
: Holen Sie sich ein bestimmtes Formular von Klaviyoget_product_reviews
: Erhalten Sie Produktbewertungen von Klaviyoget_product_review
: Holen Sie sich eine spezifische Produktbewertung von Klaviyo
🔗 Verfügbare Ressourcen
klaviyo://profile/{id}
: Informationen zu einem bestimmten Profil abrufenklaviyo://list/{id}
: Informationen zu einer bestimmten Liste abrufenklaviyo://segment/{id}
: Informationen zu einem bestimmten Segment abrufenklaviyo://campaign/{id}
: Informationen zu einer bestimmten Kampagne erhaltenklaviyo://flow/{id}
: Informationen zu einem bestimmten Flow abrufenklaviyo://template/{id}
: Informationen zu einer bestimmten Vorlage abrufenklaviyo://metric/{id}
: Informationen zu einer bestimmten Metrik abrufenklaviyo://catalog/{id}
: Informationen zu einem bestimmten Katalog abrufen
⚠️ Bekannte Probleme und Einschränkungen
- Die Klaviyo-API kann Ratenbegrenzungen für Berichtsendpunkte festlegen
- Bei manchen Metriken kann es zu einer Verzögerung kommen, bevor sie in der API verfügbar sind
- Die Verfügbarkeit historischer Daten kann je nach Ihrem Klaviyo-Plan eingeschränkt sein
- Bei der Verwendung mit Claude Desktop können gelegentlich JSON-Parsing-Warnungen auftreten, die die Funktionalität nicht beeinträchtigen
📝 Lizenz
Dieses Projekt basiert auf dem ursprünglichen Klaviyo MCP Server. Für Lizenzinformationen wenden Sie sich bitte an den ursprünglichen Autor.
👥 Mitwirkende
- Originalwerk von Matt Coatsworth
- Verbesserte Version von Ivan Rivera
🔗 Externe Ressourcen
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Ein umfassender Model Context Protocol-Server, der die Interaktion mit der Klaviyo-API ermöglicht und Tools und Ressourcen für die Verwaltung von Kundenprofilen, Listen, Segmenten, Kampagnen, Flows und verschiedenen Marketing-Automatisierungsfunktionen bereitstellt.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.Last updated -JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.Last updated -TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides a comprehensive interface for interacting with the ConnectWise Manage API, simplifying API discovery, execution, and management for both developers and AI assistants.Last updated -462Python
- -securityAlicense-qualityA Model Context Protocol server that provides standardized interfaces for interacting with Ollama API, offering JSON responses, error handling, and intelligent guidance for LLM-based API calls.Last updated -PythonMIT License