Markus Michalski FAQ

Shopware Admin: Verwendung

Typische Abläufe mit dem Shopware Admin MCP-Server: Produkt anlegen, Texte und SEO erzeugen, Alt-Text-Audit, Mail-Templates testen, Cross-Selling und SEO-URLs prüfen.

English Version

Zurück zur Übersicht

Shopware Admin: Verwendung

Diese Dokumentation bezieht sich immer auf den aktuellen Stand des main-Branches.

Du formulierst deine Aufgabe in normaler Sprache, Claude wählt die passenden Tools aus der Tool-Referenz. Die Beispiele zeigen, welche Tools bei welcher Aufgabe zusammenspielen.

Grundprinzip

  1. Was der Server nicht anlegen kann, pflegst du im Shopware-Admin: Varianten und Produktbilder. Hochladen kann der Server ein Bild nur von einer URL, mit media_upload_url.
  2. Claude übernimmt Texte, SEO und Verwaltungsaufgaben.
  3. Neue Produkte entstehen immer inaktiv. Aktiviert wird erst nach deiner Prüfung mit product_set_active.

Produkt anlegen und aktivieren

"Lege ein neues Produkt an: Name 'ITH Tasche Frühlingsblumen', Artikelnummer 'ITH-FB-001', Preis 5,99 EUR, Kategorie Stickdateien."

Claude braucht dafür die ID der Kategorie und holt sie über category_list oder category_get. Danach ruft es product_create auf. Das Produkt ist inaktiv und erscheint im Standard-Verkaufskanal, sobald du es aktivierst.

Beschreibung und SEO erzeugen

"Erzeuge eine Beschreibung für das Produkt ITH-FB-001 und speichere sie."

  1. product_get lädt das Produkt per Artikelnummer.
  2. product_generate_content liefert Produktdaten, Profil-Vorgaben und einen Prompt. Der Stil wird aus der Kategorie erkannt.
  3. Claude schreibt den Text, du prüfst ihn.
  4. content_update speichert Beschreibung, Meta-Titel, Meta-Beschreibung und Keywords.

Einen bestimmten Stil verlangst du ausdrücklich: "im Stil software". Der Name muss ein Profil aus der Konfiguration sein. Für SEO-Daten allein gibt es product_generate_seo mit den Grenzen für Titel und Beschreibung.

Kategorietexte

"Schreibe einen SEO-Text für die Kategorie Software und speichere ihn."

category_generate_content liefert Anweisungen, category_update speichert Beschreibung und SEO-Felder der Kategorie.

Alt-Texte prüfen (Barrierefreiheit)

"Welche aktiven Produktbilder haben keinen Alt-Text? Ergänze sinnvolle Texte."

media_audit_alt gruppiert Bilder ohne Alt-Text mit den betroffenen Produkten. Mit media_update setzt Claude den Alt-Text je Medium. Mit media_list und hasAlt: false filterst du Medien allgemein ohne Alt-Text.

Mail-Templates bearbeiten und testen

"Zeig mir das Template für die Bestellbestätigung und ändere den Betreff auf 'Danke für deine Bestellung {{ order.orderNumber }}'."

  1. mail_template_list oder mail_template_get mit dem technischen Namen (zum Beispiel order_confirmation_mail) findet das Template.
  2. mail_template_update ändert Betreff oder Inhalt, Twig-Ausdrücke bleiben unverändert.
  3. mail_template_send_test sendet eine Test-Mail an eine Adresse deiner Wahl, begrenzt auf 5 pro Template und 10 insgesamt pro Minute.

Flows ansehen

"Welche Flows verschicken E-Mails und sind aktiv?"

flow_list mit hasMailAction und active. flow_get zeigt die Sequenzen, flow_toggle schaltet einen Flow ein oder aus.

Cross-Selling einrichten

"Welche Produkte passen als Zubehör zu ITH-FB-001?"

cross_selling_suggest liefert Kandidaten aus denselben Kategorien und die bereits vorhandenen Gruppen. Claude schlägt vor, du bestätigst, dann legt cross_selling_create die Gruppe an.

Bestellungen auswerten

"Wie viele Bestellungen hatten wir im Januar 2026 und wie hoch war der Umsatz?"

order_stats mit dateFrom und dateTo liefert Anzahl, Umsatz und durchschnittlichen Bestellwert. Einzelne Bestellungen holst du mit order_list oder order_get. Der Zugriff ist rein lesend.

Die Datumsangaben gehen unverändert an Shopware. Ob bei einem reinen Datum der Endtag noch zum Zeitraum gehört, hängt von Shopwares Datumsauslegung ab. Gib im Zweifel dateTo mit Uhrzeit an (YYYY-MM-DDTHH:MM:SS) und prüfe das Ergebnis.

SEO-URLs prüfen

"Prüfe die SEO-URLs der Produkte auf fehlende kanonische URLs."

seo_url_audit mit routeName: frontend.detail.page meldet gelöschte URLs, doppelte kanonische Pfade und Entitäten ohne kanonische URL. Korrigieren kannst du einzelne Einträge mit seo_url_update.