WebMCP Shopify

Einen Workflow wählen

Shopify-Teams beginnen mit einem Workflow, der für Menschen bereits funktioniert: Produktsuche, Support-Suche, Angebotsvorbereitung oder Terminverfügbarkeit. Ein WebMCP-Tool beschreibt eine enge Fähigkeit mit klarem Ergebnis und nicht jeden visuellen Button. Definieren Sie Ziel, Eingaben, Ergebnis und Fehlerzustände vor dem Registrierungscode.

Aktuelle Browser-Oberfläche nutzen

Die aktuelle dokumentierte imperative Oberfläche ist document.modelContext. Prüfen Sie die Fähigkeit im Browser und registrieren Sie Name, Beschreibung, inputSchema und execute. Die normale Shopify-Oberfläche bleibt ohne API nutzbar. navigator.modelContext ist nur ein Legacy-Signal; statischer Code ist keine Runtime-Unterstützung.

Eingaben als Vertrag gestalten

Verwenden Sie explizite JSON-Schema-Eigenschaften, Typen, Formate, Beschreibungen und Pflichtfelder. Agenten-Input bleibt nicht vertrauenswürdig. Leiten Sie ihn in dieselbe validierte Anwendungsaktion wie bei einem Menschen und verwenden Sie clientseitige Sichtbarkeit niemals als Autorisierung.

Vorbereitung und Commit trennen

Suche und Lookup sind oft read-only. Warenkorb- oder Angebotsvorbereitung kann reversibel sein. Buchung, Checkout, Bestellung, Kontenänderung und Identitäts-Workflows können Verpflichtungen erzeugen oder sensible Daten betreffen. Zeigen Sie die Konsequenz, verlangen Sie eine ausdrückliche Bestätigung und erzwingen Sie Autorisierung serverseitig.

Lifecycle und Fehler testen

Eine echte Shopify-Integration muss Navigation, Hydration, Re-Renders, doppelte Mounts, Netzwerkfehler, Validierungsfehler und Abbruch überstehen. Räumen Sie Registrierungen beim Routenwechsel auf und testen Sie Tastaturbedienung, Labels, Lade-, Fehler- und Erfolgszustände.

Von Anleitung zu Verifizierung

Nutzen Sie den Generator für ein Schema, den Validator für statische Checks und den Simulator für Aufgaben-Mapping. Vor „Verifiziert“ ist ein kontrollierter Browser-Test nötig. Bei Daten, Geld oder Identität hilft der Implementierungsservice.

Hinweise zur konkreten Plattform

Bei Shopify beginnen Sie mit Katalog-Discovery und klaren Varianten- oder Währungsangaben. Trennen Sie Warenkorbvorbereitung von Checkout und Zahlung. Theme-Code unterstützt Browser-Interaktion, Plattform-Autorisierung und Bestellregeln bleiben entscheidend. Testen Sie Gast- und Kunden-Sessions, Bestand, Rabatte und die Bestätigungsgrenze.

Praktischer Testfall

Definieren Sie einen reproduzierbaren Test: Ein Nutzer verlangt ein Read-only-Ergebnis, der Agent sendet gültige und ungültige Eingaben, die Seite zeigt Ladezustand, der Server autorisiert und Menschen können ohne WebMCP fortfahren. Wiederholen Sie den Test mit einer Folgen-Aktion und prüfen Sie, dass der Commit bis zur Bestätigung blockiert bleibt. Dokumentieren Sie Ergebnis, Fehlertext und Cleanup für shopify.

Umsetzung verbinden

Nutzen Sie Autopilot zur Priorisierung sowie Generator, Validator und Simulator. Der Implementierungsservice prüft die Produktionsgrenze.

Details für den Betrieb

Schreiben Sie für Commerce auf, ob eine Aktion nur Katalogdaten liest, einen Warenkorb vorbereitet oder eine externe Verpflichtung erzeugt. Preise, Bestand, Kundenidentität und Rabattberechtigung bleiben in Plattform und Backend verbindlich. Testen Sie mit Nicht-Produktivdaten, dokumentieren Sie die sichtbare Bestätigung und prüfen Sie, dass ein Browser-Agent Consent oder Checkout nicht umgehen kann. Beziehen Sie zusätzlich Steuern, Versand, Lagerbestand und regionale Regeln in den Test ein. Eine vorbereitete Warenkorbaktion darf keine Bestellung vortäuschen; eine Bestellung entsteht erst nach der gewohnten, sichtbaren und autorisierten Bestätigung. Halten Sie Testkonto und Testprodukt getrennt von Live-Bestellungen.