MCP-Server: Kunden durchsuchen Ihren Shop mit Claude und ChatGPT
Immer mehr Menschen beginnen ihren Einkauf in einem Chatfenster. Sie bitten Claude oder ChatGPT um „wasserdichte Wanderschuhe in Größe 43 unter 120 Euro“ und erwarten, dass der Assistent mit Produkten zurückkommt, die sie kaufen können. Der Assistent kann aber nur empfehlen, was er lesen kann. Ein Shop, der nur eine Website ist, wird gelegentlich gecrawlt. Ein Shop mit eigenem MCP-Server wird bei jeder Anfrage live durchsucht, mit seinen echten Filtern, Preisen und Lagerbeständen.
Seit Version 3.4.7 fügt HUSKY Ihrem WooCommerce-Shop einen MCP-Server hinzu. MCP (Model Context Protocol) ist der Standard, über den KI-Assistenten externe Daten anbinden. Sobald er eingeschaltet ist, filtert ein mit Ihrem Shop verbundener Assistent Ihren Katalog genau so wie Ihr HUSKY-Filterformular und antwortet mit Ihren Produkten, Preisen und Links. Der Kunde öffnet dann Ihre Produktseite und kauft wie gewohnt in Ihrem Shop.
Probieren Sie es jetzt in unserem Demo-Shop: Fügen Sie https://demo.products-filter.com/hello-mcp in Claude oder ChatGPT als Connector hinzu und fragen Sie nach etwas, zum Beispiel „rote Kleidung unter 30 Dollar“.
Was Sie davon haben
- Ein Einkaufsassistent für Ihre Kunden, kostenlos für Sie und für sie. Sie zahlen keinen KI-Dienst. Ihr Kunde nutzt den Assistenten, den er ohnehin hat, trägt eine Adresse ein und spricht mit Ihrem Katalog in seinen eigenen Worten und in seiner Sprache.
- Große Kataloge lassen sich leicht durchsuchen. In einem Shop mit Tausenden Produkten und Dutzenden Attributen geben Besucher bei langen Filterformularen auf. Der Assistent liest alle Ihre Filter, kombiniert sie und grenzt das Ergebnis Schritt für Schritt ein: „nur auf Lager“, „die günstigeren“, „dasselbe in Blau“.
- Antworten, auf die Verlass ist. Der Assistent rät nicht anhand einer alten Kopie Ihrer Website. Jede Suche läuft über dieselbe Abfrage wie Ihr Filterformular. Er sieht also dieselben Filter, dieselbe Logik (OR, AND, NOT IN), dieselben Werte und dieselben Anzahlen wie ein Besucher.
- Besucher für Ihre Produktseiten. Jedes Ergebnis verlinkt auf Ihre Produktseite. Wenn die Suche ein variables Produkt auf eine Variante eingegrenzt hat, öffnet der Link es mit bereits gewählter Variante, zum Beispiel
?attribute_pa_color=red&attribute_pa_size=42. - Ihre Sprachen und Währungen. Mit WPML oder Polylang kann der Assistent in der Sprache des Kunden suchen. Mit FOX Currency Switcher kann er Preise in der Währung des Kunden anzeigen, und der Produktlink öffnet sich ebenfalls in dieser Währung.
- Ein sichtbarer Hinweis. Ein Feld auf Ihrer Website zeigt Kunden, dass sie mit ihrem KI-Assistenten einkaufen können, und KI-Tools finden Ihren Server selbstständig über standardisierte Discovery-Dateien.
Ist das für meinen Shop sicher?
Der Server ist so gebaut, dass er den öffentlichen Katalog zeigt und sonst nichts.
- Standardmäßig aus. Solange Sie ihn nicht einschalten, existieren der Server, seine Adressen, die Discovery-Dateien, der Link im Seitenkopf, der llms.txt-Abschnitt und das Shortcode-Feld auf Ihrer Website nicht.
- Nur lesend. Alle drei Tools lesen nur. Über den Server kann nichts gekauft, in einen Warenkorb gelegt, bearbeitet oder gelöscht werden. Es werden nie Checkout-Links zurückgegeben.
- Arbeitet wie ein Gastbesucher. Er gibt nie Entwürfe, private Produkte, passwortgeschützte Produkte oder im Katalog ausgeblendete Produkte zurück. Blendet WooCommerce nicht vorrätige Artikel aus, blendet der Server sie ebenfalls aus. Im WooCommerce-Modus „Coming soon“ verweigern die Tools die Antwort.
- Keine Konten, keine Schlüssel, keine personenbezogenen Daten. Der Server braucht keine Anmeldung, weil er nur liest, was jeder Besucher sehen kann. Er setzt keine Cookies und speichert nichts über den Aufrufer.
- Rate Limits. Jede Adresse unterliegt einem strengen Limit, standardmäßig 60 Anfragen pro Minute mit Spitzen von 20. Bei Überschreitung erhält der Aufrufer HTTP 429 mit der Anzahl der Sekunden, die er warten muss. Die Sperre ist vorübergehend und hebt sich von selbst auf, es muss nichts von Hand entsperrt werden.
- Ein eigenes Limit für KI-Plattformen. Kunden, die claude.ai oder ChatGPT nutzen, erreichen Ihren Shop von den eigenen Servern des Assistenten aus, sodass sich viele Kunden wenige Adressen teilen. Die Adressbereiche, die Anthropic und OpenAI dafür veröffentlichen, erhalten ein eigenes, höheres Limit, damit ein beliebter Shop seine eigenen Kunden nicht aussperrt.
- Cache. Wiederholte identische Suchen kommen aus einem kurzen Cache (standardmäßig 90 Sekunden), sodass dieselbe Frage, hundertmal gestellt, nicht hundert Datenbankabfragen auslöst. Jede Änderung an Produkten, Lagerbestand, Preisen, Begriffen oder Filtereinstellungen leert ihn.
- Browser-Origins. Wenn browserbasierte MCP-Clients auf anderen Websites Ihren Server nicht nutzen sollen, tragen Sie die erlaubten Origins ein.
Voraussetzungen
HUSKY 3.4.7 oder neuer, WordPress 6.0 oder neuer, WooCommerce, PHP 7.4 bis 8.5. Ab WordPress 6.9 werden die Tools zusätzlich in der WordPress Abilities API registriert.
1. Einschalten
- Öffnen Sie die HUSKY-Einstellungen und wechseln Sie zum Tab MCP Server.
- Stellen Sie Enable MCP server auf Yes.
- Klicken Sie auf Save changes. Bis Sie speichern, antwortet die Adresse nicht.
Der Tab zeigt nun Your MCP server address mit einem Copy-Button.

2. Ihre Server-Adresse
| Adresse | Wann |
|---|---|
https://your-shop.com/wp-json/husky/v1/mcp |
die Standardadresse, funktioniert immer |
https://your-shop.com/index.php?rest_route=/husky/v1/mcp |
die Standardadresse bei einfachen Permalinks |
https://your-shop.com/ai-shop |
Ihre eigene kurze Adresse, falls Sie eine festlegen |
Ihre eigene Adresse. Geben Sie bei Your own address (pretty URL) einen beliebigen freien Pfad ein, zum Beispiel ai-shop. Das Feld prüft den Pfad während der Eingabe und warnt Sie, wenn bereits eine Seite, ein Beitrag, eine Kategorie oder eine Datei ihn verwendet. Eine kurze Adresse lässt sich Kunden leichter nennen. Die Standardadresse funktioniert weiterhin, und die Server Card, llms.txt, der Link im Seitenkopf und das Shortcode-Feld wechseln auf die kurze Adresse. Sie funktioniert mit jeder Permalink-Struktur, auch mit einfachen Permalinks, solange der Webserver unbekannte Adressen an WordPress weiterreicht (die üblichen .htaccess- und nginx-try_files-Regeln tun das).
Für MCP-Clients: Transport Streamable HTTP, keine Authentifizierung, Protokollversionen 2026-07-28, 2025-11-25 und 2025-06-18 unter derselben Adresse.
3. Kunden informieren
Ein Server, den niemand kennt, nützt niemandem. HUSKY bietet zwei Wege, ihn bekannt zu machen: einen für Menschen, einen für KI-Tools.
Ein Feld auf Ihren Seiten
Setzen Sie den Shortcode [woof_mcp_connect] an eine beliebige Stelle: auf eine Seite, in einen Beitrag oder in ein Text- oder Shortcode-Widget in Ihrer Seitenleiste oder Ihrem Footer. Im Block-Editor verwenden Sie den Block AI assistant connection (HUSKY MCP). Das Feld zeigt Ihre Server-Adresse mit einem Copy-Button und drei kurze Schritte für Claude, ChatGPT und andere Assistenten.

Titel und Text legen Sie einmal im Tab MCP Server unter Box for your shop pages fest, oder je Verwendung:
[woof_mcp_connect title="Shop with your AI assistant" text="Add this address to Claude or ChatGPT and just say what you are looking for."]
Die Texte lassen sich wie der Rest des Filters mit dem Feld für die Übersetzung der HUSKY-Taxonomie-Bezeichnungen übersetzen.
Ein guter Platz für das Feld ist die Shop-Seitenleiste, der Footer oder eine kurze Seite wie „Mit KI einkaufen“, die Sie im Menü verlinken.
Discovery-Dateien für KI-Tools
KI-Agenten und Verzeichnisse suchen nach maschinenlesbaren Beschreibungen einer Website. Solange der Server eingeschaltet ist, veröffentlicht HUSKY sie für Sie:
- llms.txt. Das ist eine Textdatei im Stammverzeichnis Ihrer Website, die KI-Tools mitteilt, worum es auf der Website geht und wo sie suchen sollen. HUSKY ergänzt sie um einen Abschnitt mit Ihrem MCP-Server:
- Wenn Rank Math oder das Plugin Website LLMs.txt Ihre llms.txt erzeugt, wird der Abschnitt in deren Datei eingefügt;
- wenn Ihre Website keine llms.txt hat, liefert HUSKY unter
/llms.txteine aus, solange der Server eingeschaltet ist; - eine physische
llms.txt-Datei wird nie verändert. Der Tab zeigt den Abschnitt fertig zum Einfügen. - Server Card unter
<your address>/server-card, mit Servername, Beschreibung und Adressen. /.well-known/ai-catalog.json, die auf die Server Card verweist.- Links im Seitenkopf (
<link rel="ai-catalog">und<link rel="service-desc">) auf jeder Seite.
Den llms.txt-Abschnitt und den Link im Seitenkopf können Sie im Tab unter Discovery ausschalten.
4. So verbindet sich ein Kunde
Der Tab zeigt jedes der folgenden Snippets mit bereits eingetragener Adresse und je einem Copy-Button daneben. Ersetzen Sie https://your-shop.com/ai-shop durch Ihre eigene Adresse.
Claude (claude.ai, Claude Desktop)
- Öffnen Sie Customize → Connectors (
claude.ai/customize/connectors). - Klicken Sie auf Add custom connector und fügen Sie die Adresse ein.
- Lassen Sie die OAuth-Felder leer und klicken Sie auf Add.
Schalten Sie in einem Chat den Connector im Werkzeugmenü ein und fragen Sie zum Beispiel: „Finde rote Sneaker in Größe 42 unter 150 Euro.“
ChatGPT
- Öffnen Sie
chatgpt.com/plugins, klicken Sie auf + und wählen Sie Add custom MCP server. - Geben Sie einen Namen ein, fügen Sie die Adresse als Server URL ein und wählen Sie No authentication.
- Bestätigen Sie, wählen Sie Create as a plugin, geben Sie dann in einem Chat
@ein und wählen Sie es aus.
Welche Tarife und Workspace-Rollen eigene Connectors hinzufügen dürfen, entscheiden Anthropic, OpenAI und der Workspace-Administrator, nicht Ihr Shop.
Claude Code
claude mcp add --transport http my-shop https://your-shop.com/ai-shop
Cursor
.cursor/mcp.json in einem Projekt oder ~/.cursor/mcp.json für alle Projekte:
{
"mcpServers": {
"my-shop": {
"url": "https://your-shop.com/ai-shop"
}
}
}
VS Code (GitHub Copilot)
.vscode/mcp.json oder der Befehl MCP: Add Server → HTTP:
{
"servers": {
"my-shop": {
"type": "http",
"url": "https://your-shop.com/ai-shop"
}
}
}
Jeder andere MCP-Client
Fügen Sie ihn als Remote-Server hinzu: Streamable HTTP, keine Authentifizierung. So prüfen Sie den Server im Terminal:
npx @modelcontextprotocol/inspector --cli https://your-shop.com/ai-shop --transport http --method tools/list
5. Was der Assistent kann
| Tool | Funktion |
|---|---|
husky_get_filter_schema |
Listet die Filter Ihres Formulars in ihrer Reihenfolge auf: Kategorien, Attribute, Marken, Preis, Lagerbestand, Angebote, Meta-Felder, Textsuche und so weiter, jeweils mit ihren Werten, Produktanzahlen und ihrer Logik, dazu die Sortierungen, Sprachen und Währungen. |
husky_search_products |
Sucht mit einer beliebigen Kombination dieser Filter. Liefert die Produktseite mit Name, Preis, Angebotspreis, Lagerbestand, Bild, Bewertung, Attributen und Link sowie die Anzahlen der verbleibenden Werte, damit der Assistent die Suche weiter eingrenzen kann. Wenn nichts gefunden wird, nennt es den Filter, der entfallen sollte, und schlägt die nächstliegenden Alternativen vor. |
husky_get_product |
Ein Produkt nach ID, URL oder SKU: Beschreibung, Galerie, Kategorien, Attribute, Varianten mit Preisen und Lagerbestand sowie der Link. |
Anfragen, die Ihre Kunden stellen können:
- „Laptops mit 16 GB RAM unter 800, auf Lager.“
- „Etwas wie diese Jacke, aber wasserdicht und in Blau.“
- „Die günstigsten Kopfhörer im Angebot, mit Link.“
- „Gibt es diese Schuhe in Größe 42? Preise bitte in Euro.“
Instructions for agents. Jeder Assistent erhält einen kurzen Text dazu, wie er die Tools verwenden soll: zuerst das Schema abrufen, nur echte Filterwerte verwenden, Links angeben. Sie können ihn im Tab unter Instructions for agents bearbeiten, zum Beispiel um Ihre Rückgabebedingungen oder den gewünschten Tonfall zu ergänzen. Reset to default stellt den Text Ihrer HUSKY-Version wieder her. Solange Sie den Standard behalten, erhalten Sie dessen Verbesserungen mit den Updates.
Name, Titel und Beschreibung für Agenten werden aus Ihrem Website-Titel übernommen und können im Tab geändert werden.
6. Sprachen und Währungen
- WPML und Polylang. Der Assistent kann eine Sprache mitgeben. Ergebnisse, Anzahlen, Namen und Links erscheinen dann in dieser Sprache, und es werden nur Produkte dieser Sprache zurückgegeben. Ohne Sprachangabe gilt die Standardsprache.
- FOX Currency Switcher. Preise werden in Ihrer Basiswährung angegeben, sofern der Assistent keine andere anfordert. Die Währungswahl eines Kunden, Geo-IP und Cookies haben nie Einfluss auf den Server. Wird eine Währung angefordert, rechnet FOX die Preise genau wie in Ihrem Shop um, einschließlich fester Preise je Währung, und die Produktlinks enthalten die Währung (
?currency=EUR), sodass die Produktseite mit demselben Preis öffnet, den der Assistent genannt hat.

7. Einstellungen für Rate Limit und Cache
| Einstellung | Standard |
|---|---|
| Pro IP-Adresse | 60 Anfragen pro Minute, Spitzen von 20 |
| KI-Plattformen (jeder veröffentlichte Bereich) | 1200 Anfragen pro Minute, Spitzen von 300 |
| Cache für identische Suchen | 90 Sekunden |
| Produkte pro Seite höchstens | 50 (einstellbar von 1 bis 100) |
- Die Standardliste der KI-Plattformen enthält nur Bereiche, die die Anbieter in ihrer eigenen Dokumentation veröffentlichen: Anthropic (Claude) und OpenAI (ChatGPT-Connectors). Solange Sie die Standardliste behalten, folgt sie den HUSKY-Updates. Wenn Sie sie bearbeiten, bleibt Ihre Liste erhalten, und Reset to default lädt die Liste Ihrer HUSKY-Version.
0schaltet ein einzelnes Limit aus. Rate limit: Off schaltet alle aus.- Die Zähler liegen, wenn verfügbar, in Ihrem persistenten Objekt-Cache (Redis, Memcached) oder in APCu, sonst in der Datenbank.
8. Fehlerbehebung
| Symptom | Was zu prüfen ist |
|---|---|
| Die Adresse antwortet mit 404 | Der Server ist ausgeschaltet, oder die Einstellungen wurden nach dem Einschalten nicht gespeichert. |
| Die kurze Adresse antwortet mit 404 | Eine andere Seite oder Datei verwendet sie (der Tab zeigt den Konflikt), oder der Webserver reicht unbekannte Adressen nicht an WordPress weiter. Die Standardadresse funktioniert weiterhin. |
/.well-known/ai-catalog.json wird nicht gefunden |
WordPress ist in einem Unterordner installiert und kann nicht im Stammverzeichnis der Domain antworten. Die Server Card und der Link im Seitenkopf funktionieren weiterhin. |
/.well-known/ai-catalog.json antwortet mit 403 |
Ihre nginx-Konfiguration blockiert alle Adressen, die mit einem Punkt beginnen. Fügen Sie location ^~ /.well-known/ { try_files $uri $uri/ /index.php?$args; } oberhalb dieser Regel ein. |
| Die Adresse im Browser zu öffnen oder in einen Chat einzufügen ergibt 405 | Das ist zu erwarten. Die Adresse ist keine Webseite: Sie beantwortet nur MCP-Anfragen. Fügen Sie sie dem Assistenten als Connector hinzu (Abschnitt 4). |
| Der Assistent meldet „zu viele Anfragen“ | Das Rate Limit wurde erreicht. Erhöhen Sie die Werte im Tab oder fügen Sie den veröffentlichten Bereich der Plattform hinzu. |
| Preise erscheinen in der Basiswährung | Das ist zu erwarten. Bitten Sie den Assistenten um eine andere Währung („in Euro“). |
| Eine Firewall oder ein Sicherheits-Plugin blockiert den Assistenten | Erlauben Sie die MCP-Adresse für Anfragen, die nicht aus einem Browser kommen. claude.ai und ChatGPT rufen von ihren eigenen Servern aus auf. |
| Ergebnisse weichen von dem ab, was Sie im Shop sehen | Passwortgeschützte Produkte erscheinen nie in MCP-Ergebnissen. Prüfen Sie außerdem, dass Sie abgemeldet sind: Manche Produkte sind nur für angemeldete Benutzer sichtbar. |
9. Für Entwickler
| Filter | Zweck |
|---|---|
woof_mcp_filters |
Die an Agenten übergebene Filterliste ändern |
woof_mcp_product_card |
Eine Produktkarte in den Suchergebnissen ändern |
woof_mcp_product_details |
Die Antwort von husky_get_product ändern |
woof_mcp_product_is_public |
Entscheiden, ob ein Produkt angezeigt werden darf |
woof_mcp_server_card |
Die Server Card ändern |
woof_mcp_llms_txt |
Den llms.txt-Abschnitt ändern |
woof_mcp_default_ai_ranges |
Die Standard-Adressbereiche der KI-Plattformen ändern |
woof_mcp_client_ip |
HUSKY die echte IP des Aufrufers hinter einem Proxy mitteilen |
woof_mcp_respect_coming_soon |
Die Tools im Modus „Coming soon“ zulassen |
Ab WordPress 6.9 sind dieselben drei Operationen in der WordPress Abilities API registriert (husky/get-filter-schema, husky/search-products, husky/get-product), sodass der WordPress MCP Adapter sie ebenfalls bereitstellen kann.