Bestellstatus per MCP — Dry-Run-Vorschau

Die MCP-Tools zur Verwaltung von Bestellstatus unterstützen alle einen dry_run-Modus: Mit dry_run: true wird eine akkurate Vorschau der geplanten Änderung zurückgegeben — ohne dass etwas in der Datenbank gespeichert wird.

Einen vollständigen Überblick über die Bestellstatus-Verwaltung finden Sie unter KI-Agent → Bestellstatus per KI verwalten.

Warum dry_run verwenden?

Der dry_run-Modus läuft durch dieselbe Validierungslogik wie die echte Operation. Das bedeutet: Was in der Vorschau angezeigt wird, entspricht exakt dem, was beim echten Aufruf passieren würde — einschließlich aller Prüfungen auf Konflikte, Systemstatus-Beschränkungen und Bestellungsanzahl.

Empfohlener Ablauf:

Aufruf mit dry_run: true — Vorschau prüfen.
Vorschau sieht korrekt aus → gleichen Aufruf ohne dry_run wiederholen.
Änderung wird gespeichert.

Unterstützte Tools

create_order_status — Neuen Status vorab prüfen

Bevor ein neuer Bestellstatus angelegt wird, lässt sich prüfen, ob Name und Einstellungen gültig sind:

„Zeige mir eine Vorschau für einen neuen Bestellstatus ‚awaiting_payment' mit Label ‚Zahlung ausstehend', Farbe Gelb, Phase ‚payment' — ohne ihn anzulegen."

Die Vorschau zeigt den Status so, wie er nach dem Anlegen aussehen würde.

update_order_status_config — Aktuelle Einstellungen vergleichen

Beim Aktualisieren eines Status gibt die Vorschau den aktuellen Stand des Eintrags zurück — also den Zustand vor der geplanten Änderung:

„Zeige mir die aktuellen Einstellungen des Status ‚shipped' — ohne etwas zu ändern."

Nutzen Sie die Vorschau, um den aktuellen Zustand mit Ihren geplanten Werten zu vergleichen, bevor Sie die Änderung bestätigen.

replace_order_status — Migrationszahl vorab sehen

Das Ersetzen eines Status migriert alle Bestellungen, die den alten Status tragen, auf einen neuen. Die Vorschau zeigt außerdem, wie viele Bestellungen betroffen wären:

„Zeige mir eine Vorschau: Wie viele Bestellungen würden von ‚pending_old' auf ‚awaiting_payment' umgestellt — ohne die Migration durchzuführen?"

Angabe in der Vorschau	Beschreibung
Alter Status	Der Status, der ersetzt werden soll
Neuer Status	Der Ziel-Status
Anzahl betroffener Bestellungen	Wie viele Bestellungen den alten Status tragen

Wichtig: System-Status können weder im Dry-Run noch im echten Aufruf als Quelle für eine Ersetzung verwendet werden.

reorder_order_statuses — Neue Reihenfolge vorab prüfen

Die Vorschau zeigt die Reihenfolge der Status so, wie sie nach dem Umsortieren aussehen würde:

„Zeige mir eine Vorschau der Bestellstatus-Reihenfolge: new, awaiting_payment, processing, shipped, delivered, cancelled — ohne zu speichern."

Die Vorschau enthält jeden Status mit seiner neuen Positionsnummer, damit Sie die Reihenfolge vor dem Bestätigen überprüfen können.

Hinweise

dry_run: true kann bei allen vier Tools mit denselben Parametern übergeben werden, die auch beim echten Aufruf erforderlich sind.
Die Vorschau durchläuft vollständige Validierung — Fehler (z. B. ungültiger Statusname, nicht existierende ID) erscheinen in der Vorschau genauso wie beim echten Aufruf.
System-Status sind in beiden Modi (Dry-Run und live) vor Ersetzung und Löschung geschützt.