MCP-Server für WooCommerce: KI-Assistent für Ihren Shop

Bulk Edit, Analyse und Export - in einer einzigen Unterhaltung

WooCommerce-Produkte per Bulk Edit bearbeiten

Verstehen, was in Ihrem Shop passiert

WooCommerce-Produkte als CSV exportieren

WooCommerce-Produkte erstellen

Produktfotos, direkt von Ihrem Computer

Variationen von Produkten, die Sie bereits haben

Kategorien, Tags, Marken und Attribute

Bestellungen, Rückerstattungen und manuelle Bestellungen

Gutscheine

Einen Test-Shop mit Produkten füllen

Was ein WordPress-MCP-Server kurz gesagt ist

Sagen Sie ihm einmal, wie Sie es mögen

Welche KI-Assistenten sich mit WooCommerce verbinden können

• Claude - im Browser, in der Desktop-App und in Claude Code
• ChatGPT - dessen benutzerdefinierte Connectors erwarten derzeit einen Anmeldevorgang (OAuth) statt eines Schlüssels in einem Header, sodass eine direkte Verbindung möglicherweise noch nicht verfügbar ist. Manche Versionen bieten ein API-Schlüssel-Feld; wenn Ihre das tut, kommt der Schlüssel dorthin.
• Cursor, Windsurf, Zed und andere Coding-Assistenten
• Ihr eigener Agent - alles, was MCP spricht, auch etwas, das Sie selbst geschrieben haben

Wie Sie einen KI-Assistenten mit Ihrem WooCommerce-Shop verbinden

Den MCP-Server einschalten

Ihren MCP-Schlüssel in BEAR finden

Den Connector in Claude hinzufügen

• Header-Name: Authorization
• Wert: Bearer, ein Leerzeichen, dann Ihr Schlüssel

claude mcp add --transport http bear https://yourshop.com/wp-json/woobe/v1/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Ein 403-Fehler beim Hinzufügen des Connectors ist zu erwarten

Claude fragt vor der ersten Nutzung jedes Tools nach

Warum der Schlüssel nie in die Adresse gehört

MCP-Zwei-Faktor-Verbindung

1. Sie beginnen eine Unterhaltung. Der Assistent fragt den Shop nach einem Token und zeigt ihn Ihnen.
2. Sie fügen ihn in Confirm assistant connection in den BEAR-Einstellungen ein und drücken Confirm connection. Für den shopweiten Schlüssel kann das nur ein angemeldeter Administrator tun; ein Shop Manager mit persönlichem Schlüssel bestätigt seinen eigenen Token in seinen eigenen Einstellungen.
3. Sie sagen dem Assistenten, dass es erledigt ist, und er arbeitet wie gewohnt weiter, indem er den Token bei jeder Anfrage mitsendet.

MCP-Zugang für Shop-Manager

Einem Benutzer Zugang geben

Was der Benutzer sieht

Für persönliche Schlüssel ist die Zwei-Faktor-Verbindung immer eingeschaltet

1. Der Manager beginnt eine Unterhaltung. Der Assistent fragt den Shop nach einem Token und zeigt ihn ihm.
2. Er fügt ihn in Confirm assistant connection in seinem eigenen Block Ihr MCP-Zugriff ein und drückt Confirm connection. Er tut dies selbst, angemeldet mit seinem eigenen Konto: Der Administrator muss Tokens nie weiterleiten.
3. Er sagt dem Assistenten, dass es erledigt ist, und die Arbeit beginnt.

Der Assistent arbeitet als diese Person, nie mehr

Zugang entziehen

• Den Benutzer aus der Liste entfernen und speichern. Sein Schlüssel und seine Sitzung werden gelöscht, und die allernächste Anfrage wird abgelehnt, selbst wenn sein Assistent mitten in einer Aufgabe steckt. Ein langer Bulk Edit läuft in Portionen, eine Anfrage pro Portion: Die gerade geschriebene Portion wird fertiggestellt, die nächste wird abgelehnt, und alles bisher Geschriebene steht im Verlauf und kann zurückgerollt werden.
• Seine Rolle ändern, sodass er WooCommerce nicht mehr verwalten kann, oder das Konto löschen. Der Schlüssel funktioniert sofort nicht mehr, nichts muss neu erzeugt werden.
• Der Schlüssel könnte durchgesickert sein? Der Benutzer drückt Regenerate key. Der alte Schlüssel und die damit laufende Sitzung funktionieren sofort nicht mehr; er trägt den neuen Schlüssel in seinen Assistenten ein.

Teile des Shops für einen bestimmten Benutzer schließen

• products - Produkte finden, lesen, bearbeiten, per Bulk Edit ändern, erstellen, generieren, löschen und wiederherstellen
• variations - Variationen hinzufügen und entfernen, ihre Attributachsen ändern
• taxonomy - Kategorien, Tags, Marken, Attribute und deren Werte
• media - die Mediathek, Produktbilder, Bildimport und Upload-Links
• coupons - Gutscheine auflisten, erstellen, bearbeiten, löschen und wiederherstellen
• orders - die Bestellliste, eine einzelne Bestellung, manuelle Bestellungen, Statusänderungen, Notizen
• refunds - Bestellungen rückerstatten und die Rückerstattungsberichte
• reports - Verkäufe, Top-Kunden, Marge, Lagerbestand gegenüber Verkaufsrate, Zahlungs- und Versandaufschlüsselungen, Gutscheinnutzung
• export - CSV-Export und dessen Download-Link
• history - Bearbeitungshistorie lesen und Bulk Edits zurückrollen
• maintenance - Caches leeren, Begriffe neu zählen, Nachschlagetabellen neu aufbauen, Aufräumarbeiten
• memory - die dauerhaften Notizen darüber, wie Sie es gern erledigt haben

Jeder Sektor ausgeschrieben

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map['products']    = 'full';
        $map['variations']  = 'full';
        $map['taxonomy']    = 'full';
        $map['media']       = 'full';
        $map['coupons']     = 'full';
        $map['orders']      = 'full';
        $map['refunds']     = 'full';
        $map['reports']     = 'full';
        $map['export']      = 'full';
        $map['history']     = 'full';
        $map['maintenance'] = 'full';
        $map['memory']      = 'full';
    }
    return $map;
}, 10, 2 );

Ein, zwei Dinge schließen, den Rest belassen

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map['orders'] = 'read';
        $map['export'] = 'none';
    }
    return $map;
}, 10, 2 );

Alles offen, Geld geschlossen

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map['*']       = 'full';
        $map['orders']  = 'none';
        $map['refunds'] = 'none';
        $map['coupons'] = 'none';
        $map['reports'] = 'none';
    }
    return $map;
}, 10, 2 );

Alles ansehen, nichts ändern

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map = array( '*' => 'read' );
    }
    return $map;
}, 10, 2 );

Standardmäßig geschlossen, nur was Sie öffnen

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map = array(
            '*'          => 'none',
            'products'   => 'full',
            'variations' => 'full',
            'media'      => 'full',
            'taxonomy'   => 'read',
        );
    }
    return $map;
}, 10, 2 );

Mehrere Benutzer, unterschiedliche Regeln

add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    switch ( (int) $user_id ) {
        case 57: // catalogue manager
            $map['*']       = 'full';
            $map['orders']  = 'none';
            $map['refunds'] = 'none';
            break;
        case 64: // order desk
            $map = array(
                '*'        => 'none',
                'orders'   => 'full',
                'refunds'  => 'full',
                'products' => 'read',
            );
            break;
        case 71: // accountant
            $map = array( '*' => 'read' );
            break;
    }
    return $map;
}, 10, 2 );

Wer was geändert hat

Beispiele: einen WooCommerce-Shop per Chat verwalten

Bulk Edit von Preisen: eine saisonale Preiserhöhung

Einen Sale mit Start- und Enddatum planen

Die Produktvariation mit den meisten Rücksendungen finden

Wissen, wann nachbestellt werden muss: Lagerbestand gegenüber Verkaufsrate

Eine WooCommerce-Preisliste als CSV exportieren

WooCommerce-Verkäufe nach Monat

Ein variables Produkt mit jeder Variation erstellen

Einen Artikel rückerstatten und ins Regal zurücklegen

Einen Stapel Bestellungen abschließen

Diagramme im Chat: nach einem Bild fragen, nicht nur nach einer Zahl

• Verkäufe nach Monat als Säulen zeigen, und mich zu einer Linie wechseln lassen.
• Rückerstattungen über das Jahr als Welle, und eine zweite Ansicht mit dem Prozentsatz des Umsatzes.
• Die Top zehn Produkte nach Stückzahl und nach Umsatz, nebeneinander - ich will sehen, wo sich die Reihenfolge ändert.
• Die Versandmethoden als Anteile aufteilen, mit den Prozentsätzen in der Legende.
• Die Lagerliste als Tabelle mit Suche und Seitennavigation, sortiert nach Tagen der Deckung.
• Dasselbe Diagramm, aber nur das letzte Quartal.

Zwölf vorgefertigte Fragen zu Ihrem Shop

• How the shop is doing (Wie es dem Shop geht) - Umsatz nach Monat mit den ihn tragenden Produkten
• Show me the numbers (Zeig mir die Zahlen) - ein Zeitraum aus drei Blickwinkeln, bereit zum Wechseln zwischen Diagrammtypen
• What is left in stock (Was noch auf Lager ist) - Lagerbestand gegenüber Verkaufsrate, sortiert nach Tagen der Deckung
• When to buy more (Wann nachbestellt werden sollte) - die Nachbestellliste, das Dringendste zuerst
• What sells fastest (Was sich am schnellsten verkauft) - Stück pro Tag, damit sich billiges Volumen nicht hinter einem großen Verkauf versteckt
• What is not moving (Was sich nicht verkauft) - Produkte, die sich gar nicht verkauft haben, mit dem, was noch im Regal liegt
• What sold and what came back (Was verkauft wurde und was zurückkam) - Bestseller neben Rückerstattungen nach Quote
• What comes back (Was zurückkommt) - Rückerstattungen pro Variation
• Where the money is (Wo das Geld steckt) - Bruttomarge pro Produkt, das schlechteste zuerst
• What the discounts cost (Was die Rabatte kosten) - jeder Gutschein, wie oft genutzt, wie viel verschenkt
• How people pay and get it (Wie Kunden zahlen und beliefert werden) - Anteil der Bestellungen je Versandmethode und Zahlungsgateway
• Plan a sale with an end date (Ein Angebot mit Enddatum planen) - berechnet die Preise und übergibt die Änderung zu Ihrer Freigabe

Wie BEAR Sie davor bewahrt, Ihren Shop kaputtzumachen

Nichts wird ohne Vorschau geschrieben

Warnungen, die Sie aus den Zahlen allein nicht ablesen könnten

• Produkte, deren Angebotspreis WooCommerce stillschweigend löschen wird, weil der neue reguläre Preis darunter gefallen ist
• Variable Elternprodukte, bei denen das Schreiben eines Preises nichts ändert, was ein Kunde sieht
• Leere Felder, bei denen eine prozentuale Änderung null ergibt
• Ohne Angebotspreis gesetzte Angebotszeiträume, die sauber speichern und nichts bewirken
• Produkte, die bereits tiefer reduziert sind als der Sale, den Sie planen
• Das Ersetzen der Werte eines Attributs bei einem variablen Produkt, wobei die auf den alten Werten aufgebauten Variationen im Shop bleiben würden, aber nicht mehr auswählbar wären
• Bestellungen und Rückerstattungen für Waren, die keinen Lagerbestand verfolgen, bei denen sich nichts im Regal ändern wird

Dinge, die abgelehnt statt nur mit einer Warnung versehen werden

• Ein Attribut direkt auf eine Variation zu schreiben, per Bulk oder einzeln. Das würde die anderen Attribute der Variation löschen, deshalb wird der Assistent stattdessen an die Variationen-Werkzeuge verwiesen.
• Einen Lagerbestand für ein Produkt festzulegen, das keinen Lagerbestand verfolgt. WooCommerce würde ihn nicht speichern, und ein Schreibvorgang, der stillschweigend nichts bewirkt, ist schlimmer als ein klares "Erst die Lagerbestandsverfolgung einschalten".
• Felder, die in jeder Version nur lesbar sind, wie die Produkt-ID und der Autor. Der Assistent sagt, dass diese in wp-admin geändert werden, statt es zu versuchen.

Eine Anzahl, die Sie bestätigen müssen

Jede Änderung landet in Ihrem Verlauf

• Der Administrator sieht jeden Eintrag jedes Benutzers und kann jeden davon zurückrollen oder löschen.
• Ein Shop Manager sieht nur seine eigenen Einträge, von Hand oder über seinen Assistenten gemacht, und kann nur diese zurückrollen. Dieselbe Regel gilt für seinen Assistenten: Er kann die Änderungen anderer weder sehen noch rückgängig machen.

WooCommerce-Produkte per Bulk löschen

Gelöschte Produkte aus dem Papierkorb wiederherstellen

WooCommerce-Produkte und Preislisten exportieren

• Welche Produkte - jeder Filter, den Sie beschreiben können, oder der gesamte Katalog
• Welche Spalten und in welcher Reihenfolge - eine Preisliste beginnt mit der SKU, eine Inventarliste braucht keine Beschreibungen
• Welches Trennzeichen - ein Semikolon für europäische Tabellenkalkulationen
• Mit oder ohne Variationen - standardmäßig an, denn dort stecken Preis und Lagerbestand

Multi-Currency-Shops: Berichte in Ihrer Basiswährung

Kostenlos und kostenpflichtig: was die kostenlose Version erlaubt

Welche Felder per Bulk Edit bearbeitet werden können

Wie viele Produkte pro halber Stunde

Wie ein langer Bulk Edit aussieht

Wo die Grenze tatsächlich verläuft

Wie viel Verlauf aufbewahrt wird

Einen langen Job an Ihren eigenen Agenten übergeben

Voraussetzungen

• WooCommerce 6.0 oder neuer
• HTTPS auf Ihrem Shop
• Der MCP-Server in den BEAR-Einstellungen eingeschaltet
• Für persönlichen Zugang: ein Benutzer, der WooCommerce verwalten kann (die Rolle Shop manager oder eine gleichwertige) und auf der Liste MCP-Zugriff für Benutzer steht
• Ein KI-Client, der MCP unterstützt
• Für Verkaufs-, Rückerstattungs- und Margenberichte: WooCommerce Analytics aktiviert, mit abgeschlossenem historischem Import

Häufige Probleme und wie man sie behebt

Beim Hinzufügen des Connectors erscheint ein 403-Fehler

Der Assistent bietet einen Anmeldevorgang statt eines Header-Felds an

Die Verbindung wird abgelehnt

Der Assistent bittet mich, einen Token zu bestätigen

Der Assistent sagt, ein Tool sei für mich nicht verfügbar

Ein Manager sieht keine Änderungen im Verlauf

Claude fragt ständig nach Erlaubnis für Tools

Neue Tools erscheinen nach einem Update nicht

Der Shop zeigt etwas, das nicht da ist

Ein Bericht ist leer, obwohl es Bestellungen gibt

Warum ist meine Marge leer?