MCP-Integration

Planverfügbarkeit

Die MCP-Integration ist in den Plänen Starter und Professional verfügbar. Nutzer des Free-Plans erhalten einen Upgrade-Hinweis beim Versuch, MCP-Tools zu verwenden.

Was ist MCP?

Das Model Context Protocol (MCP) ermöglicht es KI-Assistenten wie Claude, Cursor und anderen MCP-kompatiblen Clients, Ihre SubscribeFlow-Daten direkt über natürliche Sprache zu verwalten. Anstatt API-Aufrufe manuell zu schreiben, können Sie Ihren KI-Assistenten bitten, Subscriber zu erstellen, Kampagnen zu versenden, Tags zu verwalten und vieles mehr.

So funktioniert es

Der MCP-Server läuft lokal auf Ihrem Rechner als Unterprozess Ihres KI-Assistenten. Er kommuniziert mit Ihrem Assistenten über stdin/stdout und führt API-Aufrufe an das SubscribeFlow-Backend in Ihrem Namen aus.

sequenceDiagram
    participant User as Sie
    participant AI as Claude Desktop/Code
    participant MCP as MCP Server (lokal)
    participant API as api.subscribeflow.net

    User->>AI: "Erstelle einen Subscriber für user@example.com"
    AI->>MCP: call_tool("create_subscriber", {email: "user@example.com"})
    MCP->>API: POST /api/v1/subscribers (X-API-Key: sf_live_...)
    API-->>MCP: 201 Created {id, email, ...}
    MCP-->>AI: "Subscriber erstellt: user@example.com"
    AI-->>User: "Erledigt! Ich habe den Subscriber user@example.com erstellt."

Wichtige Punkte:

• Der MCP-Server ist ein Python-Paket, das Sie lokal installieren (pip install subscribeflow[mcp])
• Kein Server-Hosting auf Ihrer Seite nötig — er läuft als lokaler Prozess
• Alle Datenoperationen gehen über unsere REST API mit Ihrem API-Key
• Ihr API-Key verlässt nie Ihren Rechner — er wird nur via HTTPS an api.subscribeflow.net gesendet
• Die Tier-Prüfung erfolgt beim ersten Tool-Call, um sicherzustellen, dass Ihr Plan MCP-Zugriff beinhaltet

Installation

Installieren Sie das SubscribeFlow Python SDK mit dem MCP-Extra:

pip install "subscribeflow[mcp]"

Oder mit uv:

uv pip install "subscribeflow[mcp]"

Einrichtung für Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

macOSWindows

Dateipfad: ~/Library/Application Support/Claude/claude_desktop_config.json

Dateipfad: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "subscribeflow": {
      "command": "uvx",
      "args": ["--from", "subscribeflow[mcp]", "subscribeflow-mcp"],
      "env": {
        "SUBSCRIBEFLOW_API_KEY": "sf_live_...",
        "SUBSCRIBEFLOW_BASE_URL": "https://api.subscribeflow.net"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern der Konfiguration neu.

Einrichtung für Claude Code

Fügen Sie SubscribeFlow als MCP-Server in Ihrem Projekt hinzu:

claude mcp add subscribeflow \
  -e SUBSCRIBEFLOW_API_KEY=sf_live_... \
  -e SUBSCRIBEFLOW_BASE_URL=https://api.subscribeflow.net \
  -- uvx --from "subscribeflow[mcp]" subscribeflow-mcp

Verfügbare Tools

Subscribers

Tool	Beschreibung
list_subscribers	Subscribers mit optionalen Status-/Tag-Filtern auflisten
get_subscriber	Subscriber nach ID abrufen
get_subscriber_by_email	Subscriber nach E-Mail-Adresse suchen
create_subscriber	Neuen Subscriber erstellen
get_or_create_subscriber	Bestehenden Subscriber abrufen oder neuen erstellen
update_subscriber	Subscriber-Metadaten oder Status aktualisieren
delete_subscriber	Subscriber löschen
add_subscriber_tags	Tags zu einem Subscriber hinzufügen
remove_subscriber_tag	Tag von einem Subscriber entfernen
generate_preference_token	Preference-Center-Token generieren

Tags

Tool	Beschreibung
list_tags	Alle Tags auflisten
get_tag	Tag nach ID abrufen
get_tag_by_name	Tag nach Name suchen
create_tag	Neuen Tag erstellen
get_or_create_tag	Bestehenden Tag abrufen oder neuen erstellen
update_tag	Tag-Eigenschaften aktualisieren
delete_tag	Tag löschen

Notizen

Tool	Beschreibung
create_note	Notiz zu einem Subscriber hinzufügen
list_notes	Notizen eines Subscribers auflisten
get_note	Bestimmte Notiz abrufen
update_note	Notiz aktualisieren
delete_note	Notiz löschen

Templates

Tool	Beschreibung
list_templates	E-Mail-Templates auflisten
get_template	Template nach Slug abrufen
create_template	MJML-E-Mail-Template erstellen
update_template	Template aktualisieren
delete_template	Template löschen
preview_template	Gerendertes Template anzeigen

E-Mails

Tool	Beschreibung
send_email	Transaktionale E-Mail mit Template versenden

Kampagnen

Tool	Beschreibung
list_campaigns	Kampagnen auflisten
get_campaign	Kampagnendetails abrufen
create_campaign	Neue Kampagne erstellen
update_campaign	Entwurfskampagne aktualisieren
send_campaign	Kampagne an Empfänger senden
cancel_campaign	Laufende Kampagne abbrechen
retry_campaign	Fehlgeschlagene Kampagnensendungen wiederholen
duplicate_campaign	Bestehende Kampagne duplizieren
count_campaign_recipients	Passende Empfänger für Tag-Filter zählen

Trigger

Tool	Beschreibung
list_triggers	Automatisierte E-Mail-Trigger auflisten
get_trigger	Trigger-Details abrufen
create_trigger	Ereignisbasierten Trigger erstellen
update_trigger	Trigger aktualisieren
delete_trigger	Trigger löschen

Webhooks

Tool	Beschreibung
list_webhooks	Webhook-Endpunkte auflisten
get_webhook	Webhook-Details abrufen
create_webhook	Webhook-Endpunkt erstellen
update_webhook	Webhook aktualisieren
delete_webhook	Webhook löschen
test_webhook	Testereignis an Webhook senden
regenerate_webhook_secret	Webhook-Signing-Secret neu generieren
list_webhook_deliveries	Zustellungen eines Endpunkts auflisten
get_webhook_delivery	Zustellungsdetails abrufen
retry_webhook_delivery	Fehlgeschlagene Zustellung wiederholen
get_webhook_stats	Zustellungsstatistiken eines Endpunkts abrufen
list_all_webhook_deliveries	Zustellungen aller Endpunkte auflisten
get_global_webhook_stats	Globale Zustellungsstatistiken abrufen
list_webhook_event_types	Verfügbare Ereignistypen auflisten

Preference Center

Tool	Beschreibung
get_preferences	Subscriber-Präferenzen abrufen (Token erforderlich)
subscribe_to_tag	Tag abonnieren
unsubscribe_from_tag	Tag-Abonnement kündigen
export_subscriber_data	Subscriber-Daten exportieren (DSGVO)
delete_subscriber_account	Subscriber-Konto löschen (DSGVO)

Abrechnung

Tool	Beschreibung
get_subscription	Aktuellen Plan und Abonnementdetails abrufen
get_usage	Aktuelle Nutzungszähler und Limits abrufen

Beispielverwendung

Nach der Konfiguration können Sie mit SubscribeFlow in natürlicher Sprache interagieren:

• "Liste alle aktiven Subscriber mit dem Tag 'newsletter'"
• "Erstelle einen neuen Subscriber mit der E-Mail user@example.com und tagge ihn mit 'product-updates'"
• "Zeige mir die Kampagnenstatistiken für die Frühlingskampagne"
• "Sende ein Testereignis an Webhook wh-uuid-1"
• "Wie viele E-Mails habe ich diesen Monat versendet?"

Fehlerbehebung

API-Key nicht gesetzt

Error: SUBSCRIBEFLOW_API_KEY environment variable is required.

Stellen Sie sicher, dass Ihr SUBSCRIBEFLOW_API_KEY in der MCP-Server-Konfiguration gesetzt ist. Der Schlüssel muss mit sf_live_ oder sf_test_ beginnen.

Free-Tier-Fehler

MCP integration is available on Starter and Professional plans.

MCP-Tools erfordern einen kostenpflichtigen Plan. Fuehren Sie ein Upgrade in Ihrem Abrechnungs-Dashboard durch.

Verbindungsprobleme

Falls der MCP-Server keine Verbindung herstellen kann, pruefen Sie:

1. Ihr API-Key ist gueltig und nicht abgelaufen
2. Die SUBSCRIBEFLOW_BASE_URL ist korrekt (Standard: https://api.subscribeflow.net)
3. Ihr Netzwerk erlaubt ausgehende HTTPS-Verbindungen zur API