AI Content Generator für WooCommerce — Benutzerhandbuch

Version 1.1.1 | Benötigt WordPress 5.0+ | Benötigt WooCommerce 4.0+ | PHP 7.4+

Übersicht

AI Content Generator für WooCommerce ermöglicht es Ihnen, Produktbilder, Beschreibungen, Marken und Schlagwörter (Tags) mithilfe von KI zu generieren — und Ihren Shop über einen integrierten Chatbot oder jeden MCP-kompatiblen KI-Agenten (Claude Desktop, Cursor, Claude Code und andere) zu verwalten.

Das Plugin unterstützt mehrere KI-Anbieter:

OpenAI — stets die neuesten verfügbaren OpenAI-Modelle (Text- und Bildmodelle, sofern über Ihren Connector verfügbar)
Google Gemini — stets die neuesten verfügbaren Gemini-Modelle
Anthropic (Claude) — stets die neuesten verfügbaren Claude-Modelle (nur Text; keine Bildgenerierung)

Systemanforderungen

WordPress 5.0 oder höher (WordPress 6.9+ für MCP / KI-Agenten-Funktionen erforderlich)
WooCommerce 4.0 oder höher
PHP 7.4 oder höher
Mindestens ein konfigurierter KI-Anbieter (siehe API-Schlüssel-Einrichtung unten)

Installation

Laden Sie den Plugin-Ordner nach /wp-content/plugins/ hoch oder installieren Sie es direkt über das WordPress-Plugin-Verzeichnis.
Aktivieren Sie das Plugin über Plugins › Installierte Plugins.
Gehen Sie zu WooCommerce › AI Content Generator, um die Einrichtung abzuschließen.

API-Schlüssel-Einrichtung

Sie haben zwei Möglichkeiten, KI-Zugangsdaten bereitzustellen. Sie können eine oder beide verwenden.

Option A — WordPress AI Connectors (empfohlen)

WordPress 7.0+ enthält eine Einstellungsseite für AI Connectors unter Einstellungen › KI. Geben Sie dort Ihren OpenAI-, Google- oder Anthropic-Schlüssel ein. Das Plugin erkennt jeden konfigurierten Anbieter automatisch und zeigt nur die Modelle an, die über Ihre aktiven Connectors verfügbar sind. Es ist keine Plugin-spezifische Schlüsseleingabe erforderlich.

Option B — Benutzerdefinierter OpenAI API-Schlüssel

Besuchen Sie platform.openai.com/api-keys und erstellen Sie einen geheimen Schlüssel (Secret Key).
Aktivieren Sie in den Plugin-Einstellungen Benutzerdefinierten API-Schlüssel verwenden und fügen Sie Ihren Schlüssel ein.
Über diesen Weg sind nur OpenAI-Modelle verfügbar.

Hinweis: OpenAI rechnet pro Token ab. Siehe openai.com/api/pricing für aktuelle Tarife. Die Bildgenerierung wird pro Bild berechnet.

Modellauswahl

Sobald ein Anbieter konfiguriert ist, gehen Sie zu WooCommerce › AI Content Generator › KI-Modelle. Sie können für jede Funktion ein separates Modell auswählen: Beschreibung, Kurzbeschreibung, Marken, Schlagwörter, Bildgenerierung und Chatbot. Es werden nur Modelle Ihrer aktiven Anbieter angezeigt.

Funktionen

1. Produktinhalte generieren

Öffnen Sie ein beliebiges Produkt im WooCommerce-Editor. Sie finden Generierungs-Buttons neben den entsprechenden Feldern:

Beschreibung & Kurzbeschreibung — Klicken Sie auf Generieren neben dem Beschreibungseditor. Wählen Sie eine Tonart: Formell & Professionell, Locker & Freundlich, Überzeugend & Verkaufsorientiert, Technisch & Detailliert, Luxus & Premium oder Kreativ & Ansprechend. Sehen Sie sich das Ergebnis vor der Übernahme an. Generieren Sie den Text bei Bedarf beliebig oft neu.
Marken & Schlagwörter (Tags) — Werden basierend auf dem Produktnamen und vorhandenen Attributen generiert. Vorschläge erscheinen als anklickbare Chips; wählen Sie die gewünschten aus und wenden Sie sie gebündelt an.
Hauptbild (Beitragsbild) — Klicken Sie in der Meta-Box der Seitenleiste auf Hauptbild generieren. Es werden mehrere Optionen generiert; klicken Sie bei Ihrem Favoriten auf Als Hauptbild verwenden.
Galeriebilder — Klicken Sie auf Galeriebilder generieren. Wählen Sie Bilder über die Kontrollkästchen aus und fügen Sie sie mit einem Klick der Galerie hinzu.

Tipp: Füllen Sie den Produkttitel, die Kategorie und zumindest einige Attribute aus, bevor Sie generieren — die KI nutzt diese Informationen, um relevante Inhalte zu erstellen.

2. KI-Badge

Wenn Inhalte generiert und angewendet wurden, können Sie diese als KI-generiert markieren. Ein kleines Abzeichen (Badge) wird dann auf der Produktseite angezeigt, damit Kunden wissen, dass der Inhalt KI-unterstützt erstellt wurde. Passen Sie den Badge-Text (Label) unter WooCommerce › AI Content Generator › KI-Badge an.

3. Shop-Chatbot

Das Plugin enthält einen vollständig integrierten KI-Chatbot, der als schwebende Sprechblase in Ihrem Shop erscheint.

Kunden-Chatbot — Beantwortet Kundenfragen zu Produkten, Bestellungen, Versand und Shop-Richtlinien. Standardmäßig müssen Kunden angemeldet sein; Sie können den Gastzugang in den Einstellungen aktivieren.
Admin-Chatbot — Ein separater Chatbot, der Shop-Managern und Administratoren auf WooCommerce-Admin-Seiten zur Verfügung steht. Er kann Shop-Verwaltungsaufgaben direkt ausführen: Produkte erstellen, Inhalte generieren, Gutscheine verwalten, den Bestellstatus aktualisieren und mehr.

Konfigurieren Sie den Chatbot unter WooCommerce › AI Content Generator › Chatbot:

Aktivieren/Deaktivieren Sie den Kunden-Chatbot und den Admin-Chatbot unabhängig voneinander.
Legen Sie den Chatbot-Namen, die Avatar-Bild-URL und das Farbschema fest.
Schreiben Sie eine benutzerdefinierte Willkommensnachricht und einen Platzhaltertext für das Eingabefeld.
Wählen Sie das KI-Modell für die Chat-Antworten.
Konfigurieren Sie die Aufbewahrungsdauer des Chat-Verlaufs (in Tagen).

Der Admin-Chatbot enthält eine CSV-Import-Funktion, mit der Sie Produktdaten in großen Mengen importieren können. Dies erfordert das Plugin Product Import Export for WooCommerce. Stellen Sie eine CSV-Datei mit Produktinformationen bereit, und der Chatbot erstellt Produktentwürfe zur Überprüfung.

Wenn das Print Invoices, Packing Slips, Delivery Notes & Shipping Labels Plugin aktiv ist, kann der Admin-Chatbot außerdem Download-Links für Rechnungen, Lieferscheine, Liefernotizen und Versandetiketten für Bestellungen anfordern.

4. BOGO-Gutscheinverwaltung (benötigt WebToffee Smart Coupon)

Wenn das WebToffee Smart Coupon Plugin aktiv ist, werden folgende BOGO-Funktionen (Buy One Get One / 2-für-1) sowohl über den Admin-Chatbot als auch über den MCP-Server verfügbar:

BOGO-Angebote erstellen, duplizieren, in den Papierkorb verschieben, wiederherstellen und endgültig löschen.
BOGO-Status (aktiv/inaktiv) umschalten.
Alle BOGO-Angebote mit ihrem aktuellen Status auflisten.

MCP / KI-Agenten-Integration

Unter WordPress 6.9+ registriert das Plugin seine Fähigkeiten bei der WordPress Abilities API und verwendet den Standardserver-Endpunkt des MCP Adapters. Dies ermöglicht jedem MCP-kompatiblen KI-Agenten — Claude Desktop, Cursor, Claude Code und anderen — die Werkzeuge Ihres Shops direkt aufzurufen.

Voraussetzungen

WordPress 6.9 oder höher.
Das MCP Adapter Plugin (oder das Composer-Paket) muss installiert und aktiv sein. Wenn Sie im wp-admin einen Hinweis sehen, installieren Sie ihn entweder über das WordPress-Plugin-Verzeichnis oder führen Sie composer require wordpress/mcp-adapter im Plugin-Verzeichnis aus.

MCP-Server-Endpunkt

Sobald die Voraussetzungen erfüllt sind, ist Ihr MCP-Server erreichbar unter:

https://ihre-website.de/wp-json/mcp/mcp-adapter-default-server/

Der Server erfordert, dass der Benutzer angemeldet ist. Verwenden Sie ein Anwendungspasswort (Benutzer › Profil › Anwendungspasswörter) für den Agentenzugriff.

Verfügbare Werkzeuge

Werkzeug (Tool)	Beschreibung	Typ
`generate-product-description`	Erstellt und speichert eine vollständige Beschreibung für ein bestehendes Produkt.	Kernfunktion
`generate-product-short-description`	Erstellt und speichert eine Kurzbeschreibung für ein bestehendes Produkt.	Kernfunktion
`generate-product-image`	Generiert ein KI-Bild und legt es als Hauptbild des Produkts fest.	Kernfunktion
`generate-product-brands`	Generiert und wendet Markenvorschläge für ein Produkt an.	Kernfunktion
`generate-product-tags`	Generiert und wendet SEO-Schlagwörter für ein Produkt an.	Kernfunktion
`mark-product-ai-generated`	Markiert den Inhalt eines Produkts als KI-generiert (zeigt das KI-Badge) oder entfernt die Markierung.	Kernfunktion
`search-product-id`	Findet WooCommerce-Produkt-IDs anhand des Namens. Verwenden Sie dies vor anderen Werkzeugen, die eine Produkt-ID benötigen.	Kernfunktion
`create-product-draft`	Erstellt ein neues WooCommerce-Produkt als Entwurf zur Überprüfung vor der Veröffentlichung.	Kernfunktion
`create-product-published`	Erstellt und veröffentlicht ein neues WooCommerce-Produkt sofort.	Kernfunktion
`publish-product-draft`	Veröffentlicht ein bestehendes Entwurfsprodukt anhand der ID.	Kernfunktion
`update-product`	Aktualisiert beliebige Felder eines bestehenden Produkts (Titel, Preis, Lagerbestand, Beschreibung etc.).	Kernfunktion
`delete-product`	Verschiebt ein Produkt in den Papierkorb oder löscht es endgültig.	Kernfunktion
`create-shop-coupon`	Erstellt einen WooCommerce-Gutschein (Prozentualer oder fester Rabatt, gültig für Warenkorb oder einzelne Produkte).	Kernfunktion
`update-order-status`	Ändert den Status einer Bestellung und fügt optional eine Bestellnotiz hinzu.	Kernfunktion
`create-bogo`	Erstellt ein BOGO-Angebot (erfordert Smart Coupon Plugin).	Smart Coupon
`list-bogos`	Listet alle BOGO-Angebote mit ihrem aktuellen Status auf.	Smart Coupon
`toggle-bogo`	Aktiviert oder deaktiviert ein BOGO-Angebot anhand der ID.	Smart Coupon
`trash-bogo`	Verschiebt ein BOGO-Angebot in den Papierkorb.	Smart Coupon
`restore-bogo`	Stellt ein BOGO-Angebot aus dem Papierkorb wieder her.	Smart Coupon
`delete-bogo`	Löscht ein BOGO-Angebot endgültig.	Smart Coupon
`duplicate-bogo`	Erstellt eine Kopie eines bestehenden BOGO-Angebots.	Smart Coupon

Smart Coupon Werkzeuge: Die 7 BOGO-Tools werden bedingungslos auf dem MCP-Server registriert, funktionieren aber nur, wenn das WebToffee Smart Coupon Plugin aktiv ist. Der Aufruf ohne installiertes Smart Coupon führt zu einem Fehler.

Verbinden von Claude Desktop

Öffnen Sie Claude Desktop und gehen Sie zu Settings › Developer › Edit Config.
Fügen Sie den folgenden Eintrag zur claude_desktop_config.json hinzu (ersetzen Sie die URL, den Benutzernamen und das Passwort durch Ihre eigenen Werte):

{
  "mcpServers": {
    "webtoffee-ai": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://yoursite.example/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "{admin_user}",
        "WP_API_PASSWORD": "{application-password}"
      }
    }
  }
}

Anwendungspasswort: Gehen Sie zu Benutzer › Profil › Anwendungspasswörter, geben Sie einen Namen wie "Claude Desktop" ein und klicken Sie auf Neues Anwendungspasswort hinzufügen.

Verbinden von Cursor oder Claude Code

Fügen Sie den Server zu Ihrer .cursor/mcp.json oder der MCP-Konfiguration von Claude Code hinzu, wobei Sie dieselbe url und denselben Authorization-Header wie oben verwenden.

Nutzung des Standard-MCP-Adapter-Servers

Der MCP-Adapter erstellt auch einen Standardserver unter wp-json/mcp/mcp-adapter-default-server/, der alle registrierten Fähigkeiten von jedem Plugin automatisch erkennt. Verbinden Sie sich mit diesem Endpunkt, um die WebToffee-Werkzeuge zusammen mit allen anderen auf Ihrer Website registrierten Fähigkeiten zu erhalten.

Fehlerbehebung

MCP-Endpunkt gibt 404 zurück

Stellen Sie sicher, dass WordPress 6.9+ installiert ist.
Bestätigen Sie, dass das MCP Adapter Plugin aktiv ist (prüfen Sie Plugins › Installierte Plugins).
Permalinks aktualisieren: Gehen Sie zu Einstellungen › Permalinks und klicken Sie auf Änderungen speichern.
Rufen Sie /wp-json/mcp/mcp-adapter-default-server/ im angemeldeten Zustand direkt in einem Browser auf, um die Rohantwort zu überprüfen.

MCP-Adapter-Hinweis im wp-admin

Wenn Sie einen Hinweis sehen, dass der MCP-Adapter fehlt, ist die Abilities API (WP 6.9+) zwar verfügbar, aber der Adapter ist nicht installiert. Installieren Sie das MCP Adapter Plugin aus dem WordPress-Plugin-Verzeichnis oder führen Sie composer require wordpress/mcp-adapter im Plugin-Verzeichnis aus. Schließen Sie den Hinweis, sobald der Adapter aktiv ist.

API- / Generierungsfehler

Häufige Probleme:

Ungültiger API-Schlüssel: Überprüfen Sie den Schlüssel unter Einstellungen › KI (AI Connectors) oder in den Plugin-Einstellungen. Achten Sie auf zusätzliche Leerzeichen.
Ungenügendes Guthaben (OpenAI): Fügen Sie Zahlungsinformationen unter platform.openai.com hinzu.
Bildgenerierung schlägt fehl: Stellen Sie sicher, dass Ihr OpenAI-Schlüssel Zugriff auf die Bildgenerierung hat, oder wechseln Sie zu einem Gemini-Anbieter mit aktivierter Bildgenerierung. Anthropic unterstützt keine Bildgenerierung.
Zeitüberschreitung (Timeout): Versuchen Sie es erneut. Bei langen Beschreibungen oder langsamen API-Antworten kann es beim ersten Versuch zu einer Zeitüberschreitung kommen.
Keine Modelle in den Einstellungen angezeigt: Mindestens ein Anbieter muss unter Einstellungen › KI (AI Connectors) oder über den Schalter für benutzerdefinierte API-Schlüssel konfiguriert sein.

Debug-Modus

Aktivieren Sie den Debug-Modus unter WooCommerce › AI Content Generator › Erweitert, um alle API-Anfragen und -Antworten zu protokollieren. Die Protokolle sind verfügbar unter WooCommerce › Status › Protokolle — suchen Sie nach der Quelle webtoffee-ai.

Support

Prüfen Sie den FAQ-Bereich auf der Einstellungsseite des Plugins.
Besuchen Sie das Support-Forum auf WordPress.org.
Kontaktieren Sie den WebToffee-Support mit angehängtem Debug-Protokoll, falls das Problem weiterhin besteht.