Flows & Regeln per MCP verwalten
Alle 22 MCP-Tools für Flows, Regeln und Events — Berechtigungen, Beispielanfragen und Tipps für Claude Code.
Zuletzt aktualisiert: 2026-04-28
Flows & Regeln per MCP verwalten
Mit einem MCP-fähigen KI-Agenten (z. B. Claude Code mit konfigurierter MCP-Integration) können Sie Automatisierungsflows, Regeln und das Ereignisprotokoll direkt ansprechen — ohne den Browser zu öffnen.
Voraussetzungen
- MCP-Server muss konfiguriert sein (→ MCP-Server einrichten)
- Leseoperationen erfordern
read-Berechtigung - Schreiboperationen (erstellen, ändern, löschen) erfordern
write-Berechtigung - Ereignis-Tools sind ausschließlich lesend — Events können per MCP weder erstellt noch gelöscht werden
Flow-Tools (12)
list_flows
Listet alle Flows des Shops, optional gefiltert nach Trigger-Typ oder Aktivierungsstatus.
| Parameter | Typ | Beschreibung |
|---|---|---|
trigger | Text | Nur Flows mit diesem Trigger zurückgeben (z. B. "order.placed") |
enabled | Bool | Nur aktive (true) oder inaktive (false) Flows |
page | Zahl | Seite (Standard: 1) |
per_page | Zahl | Ergebnisse pro Seite (Standard: 20) |
Beispiel-Prompt: "Zeige mir alle aktiven Flows, die auf order.placed reagieren."
get_flow
Gibt den vollständigen Flow zurück — einschließlich Aktionen-Array, triggerConfig, verknüpfter Regel und Regelname.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
Beispiel-Prompt: "Zeige mir den vollständigen Aufbau des Flows mit der ID abc-123."
create_flow
Erstellt einen neuen Flow mit Trigger und Aktionen. Gibt die neue Flow-UUID zurück.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
name | Text | Ja | Flow-Name |
trigger | Text | Ja | Ereignistyp, z. B. "product.out_of_stock" |
description | Text | Nein | Optionale Beschreibung |
triggerConfig | Objekt | Nein | Trigger-Filter (z. B. { "toStatus": "shipped" } für order.status_changed) |
ruleId | UUID | Nein | Regel-UUID, die den Flow einschränkt |
enabled | Bool | Nein | Standard: true |
priority | Zahl | Nein | Standard: 0, höher = früher |
actions | Array | Nein | Aktions-Objekte mit type, config, position, onError |
Beispiel-Prompt: "Erstelle einen Flow namens 'Ausverkauft-Alarm', der bei product.out_of_stock eine Admin-Benachrichtigung erstellt."
update_flow
Aktualisiert einen bestehenden Flow. Nur angegebene Felder werden geändert. Wird actions übergeben, ersetzt es alle vorhandenen Aktionen.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
alle anderen create_flow-Felder | — | Nein |
Beispiel-Prompt: "Deaktiviere den Flow abc-123 und erhöhe seine Priorität auf 10."
delete_flow
Löscht einen Flow dauerhaft. Ausführungshistorie bleibt zu Prüfzwecken erhalten.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
toggle_flow
Wechselt einen Flow zwischen aktiviert und deaktiviert. Gibt den neuen enabled-Status zurück.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
duplicate_flow
Erstellt eine Kopie eines Flows ("(Copy)" wird an den Namen angehängt). Die Kopie startet deaktiviert.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
test_flow
Stellt eine Testausführung mit Beispiel-Triggerdaten in die Warteschlange. Gibt die neue Ausführungs-UUID zurück.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
Beispiel-Prompt: "Starte einen Testlauf für Flow abc-123."
list_flow_executions
Listet Ausführungsdatensätze, optional gefiltert nach Flow-ID und Status.
| Parameter | Typ | Beschreibung |
|---|---|---|
flow_id | UUID | Nur Ausführungen dieses Flows |
status | Text | queued, running, succeeded, failed, cancelled, delayed |
limit | Zahl | Max. Ergebnisse (Standard: 20) |
offset | Zahl | Paginierungs-Offset |
Beispiel-Prompt: "Zeige mir die letzten 10 fehlgeschlagenen Ausführungen."
get_flow_execution
Gibt eine einzelne Ausführung mit vollständigem Aktionsprotokoll zurück. Nützlich zur Fehlerdiagnose.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
cancel_flow_execution
Bricht eine wartende oder verzögerte Ausführung ab.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
list_flow_templates
Gibt die verfügbaren Starter-Vorlagen zurück (dieselbe Liste wie in der Admin-Vorlagen-Galerie).
Keine Parameter erforderlich.
Beispiel-Prompt: "Welche Flow-Vorlagen stehen zur Verfügung?"
Regel-Tools (6)
list_rules
Listet alle Regeln des Shops inkl. Anzahl der Verwendungen in Rabatten und Versandregeln.
| Parameter | Typ | Beschreibung |
|---|---|---|
page | Zahl | Seite (Standard: 1) |
per_page | Zahl | Ergebnisse pro Seite (Standard: 20) |
get_rule
Gibt die vollständige Regeldefinition zurück, einschließlich aller Bedingungsgruppen als JSON.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
create_rule
Erstellt eine neue Regel mit Bedingungsgruppen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
name | Text | Ja | Regelname |
conditionGroups | Array | Ja | Bedingungsgruppen mit operator ("AND"/"OR") und conditions |
enabled | Bool | Nein | Standard: true |
priority | Zahl | Nein | Höhere Zahl = früher ausgewertet |
description | Text | Nein | Optionale Beschreibung |
update_rule
Aktualisiert eine bestehende Regel. Geschützte Regeln lehnen Änderungen an conditionGroups ab.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
alle anderen create_rule-Felder | — | Nein |
delete_rule
Löscht eine Regel dauerhaft. Schlägt fehl, wenn die Regel noch von Rabatten oder Versandregeln verwendet wird.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
test_rule
Wertet eine Regel gegen ein bereitgestelltes Kontext-Objekt aus. Gibt das Gesamtergebnis und eine Aufschlüsselung pro Bedingung zurück.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | UUID | Ja | Regel-UUID |
context | Objekt | Ja | Kontext mit Feldern wie cartSubtotal, shippingCountry, customerLoggedIn usw. |
Beispiel-Prompt: "Teste Regel xyz-456 mit Bestellwert 750 EUR aus Deutschland."
Ereignis-Tools (2)
Ereignis-Tools sind read-only — Ereignisse können nicht per MCP erstellt oder gelöscht werden.
list_events
Listet Ereignisprotokoll-Einträge, absteigend nach Zeitpunkt. Optional gefiltert nach Ereignistyp.
| Parameter | Typ | Beschreibung |
|---|---|---|
type | Text | Ereignistyp-Filter, z. B. "order.placed" |
limit | Zahl | Max. Ergebnisse (Standard: 20) |
offset | Zahl | Paginierungs-Offset |
Beispiel-Prompt: "Zeige mir die letzten 10 payment.failed-Ereignisse."
get_event
Gibt einen einzelnen Ereigniseintrag mit vollständigem Payload zurück.
| Parameter | Typ | Pflicht |
|---|---|---|
id | UUID | Ja |
Beispiel-Prompt: "Zeige mir die vollständigen Daten des Ereignisses evt-789."
Häufige Aufgaben mit Claude Code
# Alle aktiven Flows auflisten
"Liste alle aktivierten Flows."
# Einen Flow per Beschreibung erstellen
"Erstelle einen Flow, der bei order.placed mit einem Bestellwert über 500 EUR
einen VIP-Tag setzt und das Admin-Team benachrichtigt."
# Letzten Fehler debuggen
"Zeige mir die letzte fehlgeschlagene Ausführung des Flows 'Versandstatus-Mitteilung'
und erkläre, was schiefgelaufen ist."
# Regel testen
"Teste die Regel 'Großhandel DE' mit cartSubtotal=1200, shippingCountry='DE',
customerGroup='wholesale' und sag mir, ob sie greift."