English Version

Zurück zur Übersicht

Shopware Admin: Konfiguration

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

Umgebungsvariablen

Die Werte kommen aus der Prozessumgebung oder aus der .env-Datei (Suchreihenfolge siehe Installation). Eine Vorlage liegt als .env.example im Repository. Zeilen mit # sind Kommentare, Werte dürfen in einfachen oder doppelten Anführungszeichen stehen.

Pflichtangaben

Optionale Angaben

WIKIJS_BASE_URL und die drei CACHE_TTL_*-Variablen werden eingelesen und beim Start geprüft (gültige URL beziehungsweise Wert größer 0), danach aber von keinem Dienst verwendet. Die Cache-Laufzeiten sind fest im Code hinterlegt, siehe Technische Details. Die Wiki-Anbindung liefert in den Content-Ergebnissen immer wikiUrl: null.

Beim Start wird die HTTPS-Prüfung der SHOPWARE_URL nur als Warnung auf stderr ausgegeben. Der Server läuft auch mit http://, sendet die Zugangsdaten dann aber unverschlüsselt. Für localhost und 127.0.0.1 erscheint keine Warnung.

Shopware-Integration einrichten

1. Im Shopware-Admin unter Einstellungen > System > Integrationen eine neue Integration anlegen.
2. Client-ID und Client-Secret in die .env übernehmen.
3. Der Integration die Rechte für die Bereiche geben, die du nutzen willst.

Der Server meldet sich mit dem OAuth2-Client-Credentials-Verfahren an (POST /api/oauth/token). Welche Entitäten er je Werkzeugbereich anspricht:

Die Datei .env.example nennt nur einen Teil dieser Rechte. Das Repository enthält keine Rechteprüfung: Was die Integration darf, darf auch der Server. Vergib deshalb nur die Rechte der Bereiche, die du brauchst, und nutze getrennte Integrationen für Test und Produktion.

Content-Profile

Die Werkzeuge product_generate_content, product_generate_seo, variant_generate_content und category_generate_content formulieren Vorgaben für Claude. Ton, Anrede, Aufbau und Zielgruppe kommen aus Content-Profilen, die du in einer JSON-Datei festlegst.

Suchreihenfolge

1. CONTENT_PROFILES_PATH, wenn gesetzt.
2. ~/.claude/mcp-servers/shopwareadmin/content-profiles.json, wenn vorhanden.
3. ./content-profiles.json im Arbeitsverzeichnis.

Findet der Server an dem ermittelten Ort keine Datei, nutzt er die eingebauten Profile und schreibt einen Hinweis ins Log. Das gilt auch, wenn CONTENT_PROFILES_PATH auf eine nicht vorhandene Datei zeigt. Eine vorhandene, aber ungültige Datei verhindert den Start, mit einer Fehlermeldung je fehlerhaftem Feld.

Struktur

{
  "language": "de",
  "defaultProfile": "creative",
  "profiles": {
    "creative": {
      "tonality": "Persoenlich, warm, emotional",
      "addressing": "du",
      "structure": ["Emotionaler Einstieg (Frage/Anekdote)", "Was ist es?", "Technische Details (Format, Groesse)", "Anwendungstipps"],
      "targetAudience": "Hobbybastler, Kreative, DIY-Enthusiasten",
      "exampleIntro": "Was waere denn Ostern ohne den Osterhasen?",
      "includeSnippets": false
    }
  },
  "categoryMapping": {
    "Stickdateien": "creative"
  }
}

Eingebaute Profile

Ohne Datei gelten die Profile creative (Anrede du, Standard) und software (Anrede Sie, mit Textbausteinen). Die Kategorie-Zuordnung lautet Software zu software sowie Stickdateien, Genaehtes und 3D-Druck zu creative. Es sind die Werte des Shops des Autors.

Stil-Erkennung

• Der Server nimmt die erste Kategorie des Produkts und deren Breadcrumb (Pfad von der Wurzel).
• Jedes Pfadsegment wird exakt, mit Groß- und Kleinschreibung, gegen die Schlüssel in categoryMapping verglichen. Der erste Treffer vom Wurzelende her gewinnt.
• Ohne Treffer oder ohne Kategorie gilt defaultProfile.
• Der Parameter style überschreibt die Erkennung. Ein unbekannter Name führt zu INVALID_INPUT mit der Liste der verfügbaren Profile.
• variant_generate_content hat keinen style-Parameter und erkennt den Stil immer automatisch.

Textbausteine

Mit includeSnippets: true fragt der Server die Entität mmd-product-snippet ab. Sie stammt aus einem Shopware-Plugin für Produkt-Textbausteine, das im Shop installiert sein muss. Ohne dieses Plugin schlägt die Abfrage mit einem API-Fehler fehl, also auch der Aufruf von snippet_list.