Produkte per MCP verwalten

Mit dem MCP-Server können Sie Produkte direkt aus Claude Code heraus suchen, analysieren und bearbeiten — ohne den Admin-Bereich zu öffnen. Alle Änderungen sind optional mit einer Vorschau (dry_run) absicherbar, bevor sie gespeichert werden.

Voraussetzung

Ein verbundener MCP-Server mit einem API-Schlüssel. Für Änderungen ist eine read_write-Berechtigung erforderlich, für reine Abfragen reicht read. Richten Sie den Server ein unter MCP-Server & API-Schlüssel.

---

Produkte auflisten: list_products

Listet bis zu 200 Produkte auf, optional gefiltert nach Name, SKU, Kategorie oder Lagerstatus.

Beispiel in Claude Code:

„Zeige mir alle Produkte der Kategorie 3, die nicht auf Lager sind."

Filteroptionen

Parameter	Beschreibung	Standard
search	Suche nach Name oder SKU (Teilstring)	alle Produkte
categoryId	Nur Produkte einer bestimmten Kategorie	alle Kategorien
stockStatus	instock, outofstock oder onbackorder	alle Status
limit	Anzahl der Ergebnisse (max. 200)	50
offset	Überspringt N Ergebnisse (Seitenblätterfunktion)	0

Jedes Ergebnis enthält: Name, SKU, Preis, Lagerstatus, Kategorie und eine Thumbnail-URL.

---

Produktdetails abrufen: get_product

Liefert alle Felder eines einzelnen Produkts: Beschreibung, Bilder mit Alt-Texten, Attribute, Varianten, B2B-Gruppenpreise, Lieferzeit, Versandklasse und sämtliche SEO-Felder.

Beispiel:

„Zeige mir alle Daten von Produkt 42."

• Gibt null zurück, wenn die ID nicht existiert.
• Erfordert eine read-Berechtigung.

---

Einzelnes Produkt aktualisieren: update_product

Ändert ein oder mehrere Felder eines Produkts. Nur die angegebenen Felder werden überschrieben — alle anderen bleiben unverändert.

Beispiel:

„Setze den Preis von Produkt 42 auf 499 € und aktualisiere die Meta-Beschreibung."

Wichtige Hinweise

• Übergeben Sie dry_run: true, um eine Vorschau der Änderungen zu erhalten, ohne zu speichern.
• HTML in description und shortDescription wird vor dem Speichern automatisch bereinigt.
• Erfordert eine write-Berechtigung.

---

Viele Produkte auf einmal aktualisieren: bulk_update_products

Setzt ein einzelnes Feld bei einer Liste von Produkten gleichzeitig. Ideal für Massenaktualisierungen wie Preisänderungen, Lieferzeiten oder SEO-Metadaten.

Beispiel:

„Setze die Lieferzeit aller Produkte mit den IDs 10, 11, 12 auf ‚3–5 Werktage'."

Parameter

Parameter	Beschreibung
ids	Array von Produkt-IDs (max. 200)
field	Name des zu ändernden Felds
value	Neuer Wert
dry_run	true = Vorschau ohne Speichern

Erlaubte Felder

name, displayName, sku, slug, price, regularPrice, shortDescription, description, stockStatus, deliveryTime, shippingClass, material, metaTitle, metaDescription, metaKeywords, metaCanonical

Wenn Sie ein nicht erlaubtes Feld angeben, listet die Fehlermeldung alle akzeptierten Felder auf.

Das Ergebnis enthält eine Zusammenfassung: Anzahl der aktualisierten Produkte und eine Liste fehlgeschlagener IDs mit Gründen.

---

Beschreibung aus Template generieren: generate_product_description

Rendert ein Textbaustein-Template mit produktspezifischen Platzhalterwerten und speichert das Ergebnis optional als Produktbeschreibung.

Beispiel:

„Generiere die Beschreibung für Produkt 42 anhand des gespeicherten Templates."

Ablauf

1. Rufen Sie generate_product_description mit einer productId auf.
2. Optional: Übergeben Sie ein eigenes template mit Platzhalterwerten (z. B. {{name}}, {{holzart}}). Ohne Template wird das am Produkt gespeicherte Template verwendet.
3. Setzen Sie updateProduct: true, um das Ergebnis als Produktbeschreibung zu speichern.
4. Setzen Sie dry_run: true, um das Ergebnis anzuzeigen, ohne zu speichern.

Das gerenderte Ergebnis wird immer zurückgegeben — unabhängig davon, ob es gespeichert wurde.

Hinweis: Wenn weder ein Template übergeben noch eines am Produkt gespeichert wurde, gibt der Aufruf einen Fehler zurück.

Platzhalter anzeigen: get_available_placeholders

Zeigt alle verfügbaren Platzhalternamen: Produktfelder, Textbaustein-Slugs und Attributnamen. Verwenden Sie diese Werte mit der Syntax {{platzhalter}} in Ihren Templates.

Textbausteine anzeigen: list_textblocks

Gibt alle gespeicherten Textbausteine als { slug, content }-Paare zurück. Der Slug ist der Platzhalterschlüssel im Template.

---

Nächste Schritte

• KI-Optimierung — SEO-Lücken und Beschreibungsqualität mit einem Klick analysieren
• Kategorien — Kategoriestruktur verstehen
• Import & Export — Produkte per CSV importieren