Installation & Nutzung

DasUCP in Shopware 6 einrichten und verwenden

Installation

1. Plugin installieren — ZIP in der Administration hochladen oder den Ordner nach custom/plugins/SvenDasUCP/ legen.
2. Plugin-Liste aktualisieren:

   bin/console plugin:refresh

3. Installieren und aktivieren:

   bin/console plugin:install --activate SvenDasUCP

4. Administration-JavaScript bauen:

   ./bin/build-administration.sh

5. Storefront bauen:

   ./bin/build-storefront.sh

6. Cache leeren:

   bin/console cache:clear

bin/console messenger:consume async

API-Key einrichten

Du brauchst einen API-Key von OpenAI (ChatGPT) oder Anthropic (Claude).

Option A: OpenAI

1. Account erstellen auf platform.openai.com
2. API Keys → Create new secret key — Key sofort kopieren (beginnt mit sk-)
3. Billing → Add payment method — 5 EUR Guthaben aufladen

Empfohlenes Modell: gpt-4o-mini (schnell & günstig)

Option B: Anthropic

1. Account erstellen auf console.anthropic.com
2. API Keys → Create Key (beginnt mit sk-ant-)
3. Settings → Billing — Guthaben aufladen

Empfohlenes Modell: claude-sonnet-4-5-20250514

Key im Plugin hinterlegen

1. In Einstellungen → System → Plugins → UCP – AI Shopping Assistant
2. KI-Anbieter auswählen (OpenAI oder Anthropic)
3. KI-API-Schlüssel einfügen
4. KI-Modell eintragen (z. B. gpt-4o-mini)
5. Klick auf API Key testen — grüne Meldung = alles okay
6. Speichern

Chat-Widget

1. In der Plugin-Konfiguration: Chat-Widget aktivieren → Ja
2. Shop-Name eintragen (wird in der Chat-Überschrift und im Kontext der KI verwendet)
3. System-Prompt (optional) — eigene Anweisungen, Tonfall, Persönlichkeit
4. Speichern — das Chat-Icon erscheint unten rechts auf jeder Storefront-Seite

Was das Chat-Widget kann

Sprache & Voice

Das Chat-Widget unterstützt Spracheingabe (Mikrofon) und Sprachausgabe (Text-to-Speech). HTTPS ist erforderlich, sonst blockieren Browser den Mikrofon-Zugriff.

• Mikrofon-Button — nimmt kontinuierlich auf, sendet automatisch bei Pause (ca. 1,5 Sek. Stille)
• TTS-Toggle — KI liest die Antworten vor (Browser-native Stimme)
• Während der Ausgabe ist das Mikrofon pausiert (kein Selbst-Hören)
• Toggle in der Plugin-Konfiguration unter Design → Spracheingabe / -ausgabe

UCP-Dashboard

Unter UCP → Dashboard findest du:

• Chat-Statistik — Gesamtanzahl und letzte 7 Tage
• Shop-Wissen-Status — Zeichenanzahl, letzter Analyse-Zeitpunkt
• Konfigurations-Überblick — API-Key, Chat aktiv, Logging
• Quick-Actions — Shop analysieren, Chat-Verlauf öffnen, Plugin konfigurieren

Shop-Wissen / Self-Learning

Unter UCP → Shop-Wissen:

1. Klick auf Shop analysieren
2. Der Crawler sammelt asynchron über die Message-Queue:
   • Shop-Basis-Info (Name, Adresse, Kontakt)
   • Alle aktiven Kategorien mit Beschreibung
   • Alle Hersteller mit Beschreibung
   • Interne CMS-Seiten
   • Aktive Zahlungs- und Versandarten
   • Live-Storefront via sitemap.xml (Blog, Landingpages, Info-Seiten)
3. Optional: Mit KI zusammenfassen — sendet die Rohdaten an den KI-Anbieter, der daraus eine kompakte Shop-Beschreibung generiert
4. Das Ergebnis ist editierbar — du kannst Fehler korrigieren, Dinge ergänzen, den Ton anpassen
5. Speichern — ab dem nächsten Chat wird das Wissen automatisch dem KI-System-Prompt mitgegeben

FAQ-Manager & Importer

Den FAQ-Manager siehst du auch im Backend-Screenshot oben — links die Liste mit Drag-Handles, Aktiv-Toggles und Position-Nummern.

Unter UCP → FAQ:

Einzelne Einträge anlegen

1. Klick auf Neuer Eintrag
2. Frage und Antwort eingeben
3. Position (kleinere Zahl = weiter oben in Listen)
4. Aktiv-Toggle (inaktive Einträge werden nicht verwendet)
5. Speichern

Bulk-Import

Klick auf Importieren öffnet ein Modal mit Textarea. Der Parser erkennt mehrere Formate:

F: Wie lange dauert die Lieferung? A: 2-4 Werktage innerhalb Deutschlands.
F: Liefert ihr auch nach Österreich? A: Ja, in die gesamte EU.
Q: Do you ship internationally? A: Yes, to all EU countries.
Frage: Gibt es Mengenrabatt? Antwort: Ab 500 EUR gibt es 10% Rabatt.

Live-Vorschau zeigt was erkannt wird. Button Importieren (N) legt alle Einträge aktiv mit fortlaufender Position an.

FAQ-CMS-Element (Erlebniswelten)

Zeige die FAQs im Storefront als schönes Accordion an:

1. Inhalte → Erlebniswelten öffnen, gewünschte Layout-Seite bearbeiten
2. Block-Kategorie UCP auswählen → Block FAQ-Accordion hinzufügen
3. Element-Konfiguration:
   • Überschrift — z. B. „Häufige Fragen“ (Standard)
   • Maximale Anzahl — 0 = alle aktiven Einträge
   • Schema.org FAQPage mitliefern — erzeugt strukturierte Daten für Google Rich Snippets
4. Seite speichern und veröffentlichen

Chat-Verlauf (DSGVO)

Standardmäßig deaktiviert (DSGVO-Opt-in). Zum Aktivieren:

1. In der Plugin-Konfiguration, Karte Chat-Verlauf (DSGVO)
2. Toggle Chat-Verlauf speichern → Ja
3. Aufbewahrungsdauer setzen (1–365 Tage, Standard 30)
4. Datenschutzhinweis im Widget — zeigt einen kleinen Hinweis am unteren Rand des Chats
5. Speichern

Unter UCP → Chat-Verlauf siehst du alle Unterhaltungen gruppiert nach Session, jede ist als Transkript einsehbar und einzeln löschbar (DSGVO-Auskunftsrecht).

AI-Discoverability

Das Plugin macht deinen Shop für AI-Systeme (ChatGPT Search, Google SGE, Perplexity, Bing Copilot, Claude-Web) automatisch auffindbar. Alle drei Mechanismen sind per Toggle aktivierbar.

Schema.org JSON-LD

Strukturierte Daten in jeder Storefront-Seite:

• Organization + WebSite+SearchAction (jede Seite)
• Product (Product Detail Page — Preis, Verfügbarkeit, SKU, EAN, Brand, Rating)
• BreadcrumbList (Kategorie/PDP)
• FAQPage (nur via CMS-Element — Google-konform)

llms.txt & llms-full.txt

Aufstrebender LLM-Standard:

• /llms.txt — kurze Übersicht mit Key-Endpoints
• /llms-full.txt — detaillierter Shop-Kontext (nutzt automatisch dein Self-Learned Shop-Wissen)
• 1 Stunde Cache, öffentlich (keine Auth)

Produkt-Feed

GET /ucp/feed.json?page=1&limit=100 — paginierter Produktkatalog als JSON. Enthält ID, SKU, EAN, Preis, Lagerbestand, Kategorien, Brand, Rating. 15 min Cache.

AI Reach — IndexNow, robots.txt, ChatGPT Custom GPT & Claude (MCP)

Unter UCP → AI Discovery findest du vier Tools, die deinen Shop für KI-Systeme noch auffindbarer und nutzbarer machen. Das ergänzt das passive AI-Discoverability-Pack (Schema.org, llms.txt, Produktfeed) um aktive Signale und direkte Connectors.

IndexNow (Bing & Yandex)

IndexNow ist ein offener Standard von Microsoft und Yandex. Wenn du Content änderst, sendest du einen HTTP-Ping an api.indexnow.org — Bing und Yandex crawlen dann binnen Minuten statt Tagen. Da ChatGPT Search im Hintergrund Bing nutzt, profitiert auch ChatGPT davon.

Was das Plugin macht:

• Generiert automatisch einen IndexNow-Schlüssel (32 Zeichen Hex)
• Stellt die Key-Datei unter /ucp-indexnow-<key>.txt bereit (IndexNow-Verifizierung)
• Pingt automatisch bei Änderungen an FAQ-Einträgen, Shop-Wissen und CMS-Seiten
• Ping-Manuell-Button für sofortige Benachrichtigung

1. In UCP → AI Discovery den Toggle "Automatische IndexNow-Benachrichtigung" aktivieren
2. Einmalig "Jetzt manuell pingen" klicken — Bing erkennt damit den Key
3. Ab sofort läuft das automatisch bei jedem Content-Update

robots.txt — AI-Bot-Allowlist

Viele KI-Crawler respektieren robots.txt. Ein expliziter Allow-Eintrag pro Bot ist ein klares Signal "dieser Shop ist offen für KI-Indexierung".

Das Plugin stellt einen fertigen Block unter UCP → AI Discovery zum Kopieren bereit. Abgedeckte Bots:

• OpenAI: GPTBot, ChatGPT-User, OAI-SearchBot
• Anthropic: ClaudeBot, Claude-Web, anthropic-ai
• Perplexity: PerplexityBot, Perplexity-User
• Google: Google-Extended, GoogleOther
• Apple Intelligence: Applebot-Extended, Applebot
• Meta AI: FacebookBot, meta-externalagent
• Weitere: cohere-ai, CCBot, Bytespider, Amazonbot, DuckAssistBot, YouBot

1. Auf der AI-Discovery-Seite den Block kopieren
2. In die robots.txt am Root deines Shops einfügen (oder deine Sales-Channel-Domain-Config in Shopware)
3. Alternativ: /ucp/robots.txt ist als Live-Endpoint verfügbar — bei Änderungen der Bot-Liste im Plugin passt er sich automatisch an

ChatGPT Custom GPT

ChatGPT Custom GPTs (auch "GPTs" oder "ChatGPT Plugins" genannt) sind eigene Assistenten, die User über chatgpt.com/gpts öffnen können. Mit deinem Shop-Plugin kann jeder Custom GPT:

• Produkte in deinem Shop suchen (inkl. echter Preise und Verfügbarkeit)
• Artikel in den Warenkorb legen
• Checkout-Links erzeugen (User zahlen über deinen normalen Shop-Checkout)

Das Plugin generiert alle nötigen Felder zum Einfügen in den ChatGPT-Editor.

1. chatgpt.com/gpts/editor öffnen (ChatGPT Plus/Team-Account nötig)
2. Tab "Konfigurieren" → scrollen zu "Aktionen" → "Neue Aktion erstellen"
3. In "Schema" die URL aus der Admin-Seite einfügen (/ucp/openapi.json)
4. Bei "Authentifizierung" → API-Schlüssel / Bearer → deinen UCP-API-Schlüssel eintragen (aus Plugin-Config → Externe API)
5. Datenschutz-URL des Shops eintragen
6. Metadaten (Name, Beschreibung, Anweisungen) aus der Admin-Seite kopieren — das Plugin generiert passende Vorschläge
7. GPT speichern und entweder privat teilen (nur per Link) oder im GPT Store veröffentlichen für mehr Reichweite

Anthropic Claude (MCP Connector)

Seit v2.0 bringt das Plugin einen nativen Model-Context-Protocol-Server mit unter POST /ucp/mcp. Anders als ChatGPT (OpenAPI/Actions) nutzt Anthropic dafür das offene MCP-Protokoll. Heißt für dich: nur eine URL kopieren, in Claude.ai einfügen — fertig.

Was MCP für dich besonders macht:

• Kein Custom-GPT-Approval, keine Action-Konfiguration — URL einfügen, fertig
• Funktioniert sofort in Claude.ai (Free/Pro/Max/Team/Enterprise) und Claude Desktop
• Dieselbe URL läuft auch in Cursor, Cline, Windsurf und allen anderen MCP-Clients — ein Server, viele Clients
• Im Chat ruft Claude die Tools search_products, view_cart, add_to_cart, remove_from_cart und get_checkout_link direkt gegen deinen Shop auf

1. Im Backend UCP → AI Discovery in der Karte "Anthropic Claude (MCP)" die MCP-URL kopieren (https://deinshop.de/ucp/mcp)
2. claude.ai/settings/connectors öffnen → "Add custom connector"
3. URL einfügen, einen Namen vergeben (z. B. den Shop-Namen) → "Add"
4. In jedem Claude-Chat über das +-Menü unten links → "Connectors" → den Connector aktivieren
5. Fertig — Claude kann jetzt direkt in deinem Shop einkaufen

Externe REST-API (optional)

Für eigene AI-Integrationen (ChatGPT Custom GPTs, LangChain, n8n, eigener Chatbot auf anderer Seite):

Discovery (öffentlich)

Commerce-Endpoints (Auth erforderlich)

UCP-API-Schlüssel unter Externe API in der Plugin-Konfiguration setzen, als Authorization: Bearer <key> senden.