Was passiert, wenn das Lager keinen Treffer liefert?
Ein Assistent fragt den Bestand für eine bestimmte Produktvariante ab. Mit Treffern funktioniert alles. Wenn der Bestand leer ist, gibt das Plugin ein leeres Array zurück, obwohl es als Antwort ein Objekt angekündigt hat. Für einen Menschen sieht beides erst einmal nach nichts aus. Für den Assistenten kann es den Unterschied machen, ob er eine leere Antwort versteht oder eine Fehlermeldung erhält.
Shopware hat am 18. November Version 6.7.16.1 veröffentlicht. Der MCP Server verwendet jetzt mcp/sdk 0.9 und symfony/mcp-bundle 0.15. Eigene Werkzeuge mit einem deklarierten Ausgabeschema werden daran gemessen. Für mich ist das ein guter Anlass, beim Update ausgerechnet die Abfrage zu prüfen, die im Alltag am wenigsten spektakulär aussieht. Was kommt zurück, wenn ein Artikel fehlt?
Was ändert sich für MCP Plugins und Browser Clients?
Ein Werkzeug, das ein outputSchema deklariert, muss seine strukturierten Daten in diesem Format zurückgeben. Weicht structuredContent davon ab, meldet der Server laut Shopware Versionshinweisen einen Werkzeugfehler. Falls das Schema ein leeres Objekt erlaubt, nennen die Versionshinweise dafür new stdClass() in PHP. Ein leeres PHP Array wird als JSON Array übertragen. Schon bei der Registrierung werden Eingabeschemas mit unpassend definierten properties oder required Feldern abgelehnt.
Die zweite Änderung betrifft die Herkunft einer Browseranfrage. Shopware gleicht das Origin Feld einschließlich Schema und Port ab. Die Herkunft von APP_URL und von konfigurierten Verkaufskanal Domains wird akzeptiert. Läuft die eigene Agentenoberfläche unter einer anderen Adresse, lässt sich genau diese Herkunft über shopware.mcp.allowed_origins eintragen. Clients, die laut Release Notes kein Origin Feld senden, sind von dieser konkreten Änderung nicht betroffen. Wenn ein Desktop Client funktioniert, würde ich die verwendete Browseroberfläche deshalb trotzdem eigens prüfen.
Eine passende Antwort und die richtigen Rechte
Seit Shopware 6.7.16.0 bekommen Integrationen und Benutzer ohne Adminrechte MCP Fähigkeiten erst mit einer ausdrücklich eingerichteten Freigabeliste. Das ist eine eigene Prüfung. Ein Browser kann von einer erlaubten Herkunft kommen und die richtige Art Eingabe schicken. Die Integration muss trotzdem für das konkrete Werkzeug zugelassen sein.
In Kapitel 13 meines Buchs geht es darum, wie gut lesbare Daten und die Rechte für eine Handlung zusammenwirken. Maße, Preise und Liefertermine lassen sich als Felder gezielt prüfen. Über eine Änderung im Shop entscheidet das ausführende System anhand der Rechte für den konkreten Auftrag. Beim Bestandsbeispiel kann der Assistent also feststellen, dass die gewünschte Variante fehlt. Ob er als Nächstes einen Ersatz in den Warenkorb legen darf, ergibt sich aus dem Auftrag und seiner Berechtigung.
Was ich nach dem Update testen würde
Ich würde dieselbe Bestandsabfrage über die tatsächlich verwendete Oberfläche mit drei Artikeln ausprobieren. Einer ist lieferbar, einer ist ausverkauft und einer ist dem Shop unbekannt. Der Unterschied muss in der Antwort klar bleiben und beim Assistenten richtig ankommen. Dann würde ich mit derselben Integration prüfen, ob ihre ausdrücklich freigegebenen Werkzeuge verfügbar sind. Das trennt Probleme mit der Browseradresse von Fehlern im Antwortformat oder den Rechten.
Für den Einstieg in weitere Funktionen zeigt mein Shopware Leitfaden zum Produktfeed und Testkauf, wie sich Produktsuche, Kauf und interne Aufgaben auseinanderhalten lassen. Die MCP Änderung betrifft die Werkzeuge, die ein Assistent dafür aufruft. Wenn die Abfrage auch ohne Treffer eine brauchbare Antwort liefert, kann der Assistent dort sinnvoll weiterarbeiten, wo er vorher mitten im Gespräch stehen geblieben wäre.
