Serwer MCP: wyszukiwanie w Twoim sklepie z poziomu Claude i ChatGPT

Coraz więcej osób zaczyna zakupy w oknie czatu. Pytają Claude lub ChatGPT o „wodoodporne buty trekkingowe w rozmiarze 43 do 120 euro” i oczekują, że asystent wróci z produktami, które można kupić. Asystent może polecić tylko to, co potrafi odczytać. Sklep będący zwykłą stroną internetową jest od czasu do czasu odwiedzany przez roboty. Sklep z własnym serwerem MCP jest przeszukiwany na żywo, z prawdziwymi filtrami, cenami i stanami magazynowymi, za każdym razem, gdy ktoś o to zapyta.

Od wersji 3.4.7 HUSKY dodaje do sklepu WooCommerce serwer MCP. MCP (Model Context Protocol) to standardowy sposób łączenia asystentów AI z zewnętrznymi danymi. Po włączeniu asystent połączony ze sklepem filtruje katalog dokładnie tak, jak formularz filtrów HUSKY, i odpowiada Twoimi produktami, cenami i linkami. Klient otwiera następnie stronę produktu i kupuje w Twoim sklepie, jak zwykle.

Wypróbuj teraz w naszym sklepie demo: dodaj https://demo.products-filter.com/hello-mcp jako konektor w Claude lub ChatGPT i poproś o coś, na przykład „czerwone ubrania do 30 dolarów”.

Co z tego masz

• Asystent zakupowy dla klientów, bezpłatny dla Ciebie i dla nich. Nie płacisz za żadną usługę AI. Klient korzysta z asystenta, którego już ma, dodaje jeden adres i rozmawia z Twoim katalogiem własnymi słowami i w swoim języku.
• Duże katalogi łatwo przeszukiwać. W sklepie z tysiącami produktów i dziesiątkami atrybutów ludzie rezygnują z długich formularzy filtrów. Asystent czyta wszystkie Twoje filtry, łączy je i zawęża wynik krok po kroku: „tylko dostępne”, „tańsze”, „to samo w niebieskim”.
• Odpowiedzi, którym można ufać. Asystent nie zgaduje na podstawie starej kopii Twojej strony. Każde wyszukiwanie przechodzi przez to samo zapytanie co formularz filtrów, więc widzi te same filtry, tę samą logikę (OR, AND, NOT IN), te same wartości i te same liczniki, które widzi odwiedzający.
• Ruch na stronach produktów. Każdy wynik prowadzi do strony produktu. Jeśli wyszukiwanie zawęziło produkt z wariantami do jednego wariantu, link otwiera go z już wybranym wariantem, na przykład ?attribute_pa_color=red&attribute_pa_size=42.
• Twoje języki i waluty. Dzięki WPML lub Polylang asystent może wyszukiwać w języku klienta. Dzięki FOX Currency Switcher może pokazywać ceny w walucie klienta, a link do produktu również otwiera się w tej walucie.
• Widoczna informacja. Pole na Twojej stronie informuje klientów, że mogą robić zakupy ze swoim asystentem AI, a narzędzia AI same znajdują Twój serwer dzięki standardowym plikom wykrywania.

Czy jest bezpieczny dla mojego sklepu?

Serwer pokazuje publiczny katalog i nic poza nim.

• Domyślnie wyłączony. Dopóki go nie włączysz, serwer, jego adresy, pliki wykrywania, link w nagłówku, sekcja llms.txt i pole shortcode nie istnieją w Twojej witrynie.
• Tylko do odczytu. Wszystkie trzy narzędzia tylko czytają. Przez serwer nie można niczego kupić, dodać do koszyka, edytować ani usunąć. Nigdy nie są zwracane linki do kasy.
• Działa jak gość. Nigdy nie zwraca wersji roboczych, produktów prywatnych, produktów chronionych hasłem ani produktów ukrytych w katalogu. Jeśli WooCommerce ukrywa produkty niedostępne, serwer też je ukrywa. W trybie „Coming soon” w WooCommerce narzędzia odmawiają odpowiedzi.
• Bez kont, kluczy i danych osobowych. Serwer nie wymaga logowania, ponieważ czyta tylko to, co widzi każdy odwiedzający. Nie ustawia ciasteczek i nie zapisuje niczego o wywołującym.
• Limity zapytań. Każdy adres ma ścisły limit, domyślnie 60 zapytań na minutę z seriami po 20. Po przekroczeniu limitu wywołujący dostaje kod HTTP 429 z liczbą sekund do odczekania. Blokada jest tymczasowa i znika sama, nie trzeba niczego odblokowywać ręcznie.
• Osobny limit dla platform AI. Klienci korzystający z claude.ai lub ChatGPT łączą się z Twoim sklepem z serwerów asystenta, więc wielu klientów dzieli kilka adresów. Zakresy adresów publikowane w tym celu przez Anthropic i OpenAI mają własny, wyższy limit, dzięki czemu popularny sklep nie blokuje własnych klientów.
• Cache. Powtarzające się identyczne wyszukiwania pochodzą z krótkiej pamięci podręcznej (domyślnie 90 sekund), więc to samo pytanie zadane sto razy nie uruchamia stu zapytań do bazy danych. Każda zmiana produktów, stanów magazynowych, cen, terminów lub ustawień filtrów ją czyści.
• Źródła przeglądarkowe. Jeśli nie chcesz, aby klienci MCP działający w przeglądarce na innych stronach korzystali z Twojego serwera, wypisz dozwolone źródła (origins).

Wymagania

HUSKY 3.4.7 lub nowszy, WordPress 6.0 lub nowszy, WooCommerce, PHP od 7.4 do 8.5. W WordPress 6.9 i nowszych narzędzia są dodatkowo rejestrowane w WordPress Abilities API.

1. Włącz serwer

1. Otwórz ustawienia HUSKY i przejdź do zakładki MCP Server.
2. Ustaw Enable MCP server na Yes.
3. Kliknij Save changes. Dopóki nie zapiszesz, adres nie odpowiada.

Zakładka pokazuje teraz Your MCP server address z przyciskiem Copy.

2. Adres serwera

Własny adres. W polu Your own address (pretty URL) wpisz dowolną wolną ścieżkę, na przykład ai-shop. Pole sprawdza ją w trakcie pisania i ostrzega, gdy korzysta z niej już strona, wpis, kategoria lub plik. Krótki adres łatwiej podać klientom. Adres domyślny nadal działa, a server card, llms.txt, link w nagłówku i pole shortcode przechodzą na krótki adres. Działa z każdą strukturą permalinków, także domyślną, o ile serwer WWW przekazuje nieznane adresy do WordPress (standardowe reguły .htaccess i nginx try_files to robią).

Dla klientów MCP: transport Streamable HTTP, bez uwierzytelniania, wersje protokołu 2026-07-28, 2025-11-25 i 2025-06-18 pod tym samym adresem.

3. Poinformuj klientów

Serwer, o którym nikt nie wie, nikomu nie pomaga. HUSKY daje dwa sposoby ogłoszenia go: jeden dla ludzi, drugi dla narzędzi AI.

Pole na stronach

Umieść shortcode [woof_mcp_connect] w dowolnym miejscu: na stronie, we wpisie albo w widgecie Text lub Shortcode na pasku bocznym lub w stopce. W edytorze blokowym użyj bloku AI assistant connection (HUSKY MCP). Pole pokazuje adres serwera z przyciskiem Copy oraz trzy krótkie kroki dla Claude, ChatGPT i innych asystentów.

Tytuł i tekst ustawia się jednorazowo w zakładce MCP Server w sekcji Box for your shop pages albo przy każdym użyciu osobno:

[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."]

Teksty można przetłumaczyć w polu tłumaczeń etykiet taksonomii HUSKY, tak jak resztę filtra.

Dobre miejsce na to pole to pasek boczny sklepu, stopka albo krótka strona, na przykład „Zakupy z AI”, podlinkowana z menu.

Pliki wykrywania dla narzędzi AI

Agenci AI i katalogi szukają maszynowo czytelnych opisów witryny. Gdy serwer jest włączony, HUSKY publikuje je za Ciebie:

• llms.txt. To zwykły plik tekstowy w katalogu głównym witryny, który mówi narzędziom AI, czym jest witryna i gdzie szukać. HUSKY dodaje do niego sekcję z Twoim serwerem MCP:
• jeśli llms.txt generuje Rank Math lub wtyczka Website LLMs.txt, sekcja jest dodawana do ich pliku;
• jeśli witryna nie ma llms.txt, HUSKY udostępnia go pod adresem /llms.txt, dopóki serwer jest włączony;
• fizyczny plik llms.txt nigdy nie jest zmieniany. Zakładka pokazuje sekcję gotową do wklejenia do niego.
• Server card pod adresem <your address>/server-card, z nazwą serwera, opisem i adresami.
• /.well-known/ai-catalog.json, wskazujący na server card.
• Linki w nagłówku strony (<link rel="ai-catalog"> i <link rel="service-desc">) na każdej stronie.

Sekcję llms.txt i link w nagłówku możesz wyłączyć w zakładce w sekcji Discovery.

4. Jak klient się łączy

Zakładka pokazuje każdy poniższy fragment z już wstawionym Twoim adresem i przyciskiem Copy obok każdego z nich. Zastąp https://your-shop.com/ai-shop własnym adresem.

Claude (claude.ai, Claude Desktop)

1. Otwórz Customize → Connectors (claude.ai/customize/connectors).
2. Kliknij Add custom connector i wklej adres.
3. Pozostaw pola OAuth puste i kliknij Add.

W czacie włącz konektor w menu narzędzi i zapytaj na przykład: „Znajdź czerwone trampki w rozmiarze 42 do 150 euro.”

ChatGPT

1. Otwórz chatgpt.com/plugins, naciśnij + i wybierz Add custom MCP server.
2. Wpisz nazwę, wklej adres jako Server URL i wybierz No authentication.
3. Potwierdź, wybierz Create as a plugin, następnie wpisz @ w czacie i wybierz go.

To, które plany i role w przestrzeni roboczej mogą dodawać własne konektory, decydują Anthropic, OpenAI i administrator przestrzeni roboczej, a nie Twój sklep.

Claude Code

claude mcp add --transport http my-shop https://your-shop.com/ai-shop

Cursor

.cursor/mcp.json w projekcie albo ~/.cursor/mcp.json dla wszystkich projektów:

{
    "mcpServers": {
        "my-shop": {
            "url": "https://your-shop.com/ai-shop"
        }
    }
}

VS Code (GitHub Copilot)

.vscode/mcp.json albo polecenie MCP: Add Server → HTTP:

{
    "servers": {
        "my-shop": {
            "type": "http",
            "url": "https://your-shop.com/ai-shop"
        }
    }
}

Dowolny inny klient MCP

Dodaj go jako serwer zdalny: Streamable HTTP, bez uwierzytelniania. Aby sprawdzić serwer z terminala:

npx @modelcontextprotocol/inspector --cli https://your-shop.com/ai-shop --transport http --method tools/list

5. Co potrafi asystent

Prośby, które mogą zadawać klienci:

• „Laptopy z 16 GB RAM do 800, dostępne od ręki.”
• „Coś w rodzaju tej kurtki, ale wodoodporne i w kolorze niebieskim.”
• „Najtańsze słuchawki w promocji, z linkiem.”
• "Gibt es diese Schuhe in Größe 42? Preise bitte in Euro."

Instructions for agents. Każdy asystent dostaje krótki tekst o tym, jak używać narzędzi: najpierw wywołać schemat, używać tylko prawdziwych wartości filtrów, podawać linki. Możesz go edytować w zakładce w sekcji Instructions for agents, na przykład aby dodać politykę zwrotów lub pożądany ton. Reset to default przywraca tekst z Twojej wersji HUSKY. Dopóki zostawiasz tekst domyślny, jego ulepszenia otrzymujesz wraz z aktualizacjami.

Name, title and description shown to agents są pobierane z tytułu witryny i można je zmienić w zakładce.

6. Języki i waluty

• WPML i Polylang. Asystent może przekazać język. Wyniki, liczniki, nazwy i linki są wtedy w tym języku i zwracane są tylko produkty w tym języku. Bez podanego języka używany jest język domyślny.
• FOX Currency Switcher. Ceny są w walucie bazowej, chyba że asystent poprosi o inną. Wybór waluty przez klienta, geolokalizacja IP i ciasteczka nigdy nie wpływają na serwer. Gdy zażądana jest waluta, ceny są przeliczane przez FOX dokładnie tak jak w Twoim sklepie, łącznie ze stałymi cenami dla poszczególnych walut, a linki do produktów zawierają walutę (?currency=EUR), dzięki czemu strona produktu otwiera się z tą samą ceną, którą podał asystent.

7. Ustawienia limitów zapytań i cache

• Domyślna lista platform AI zawiera tylko zakresy, które dostawcy publikują we własnej dokumentacji: Anthropic (Claude) i OpenAI (konektory ChatGPT). Dopóki zostawiasz listę domyślną, jest ona aktualizowana wraz z HUSKY. Jeśli ją edytujesz, Twoja lista zostaje zachowana, a Reset to default wczytuje listę z Twojej wersji HUSKY.
• 0 wyłącza jeden limit. Rate limit: Off wyłącza je wszystkie.
• Liczniki są przechowywane w trwałej pamięci podręcznej obiektów (Redis, Memcached) lub w APCu, jeśli są dostępne, a w przeciwnym razie w bazie danych.

8. Rozwiązywanie problemów

9. Dla programistów

W WordPress 6.9 i nowszych te same trzy operacje są rejestrowane w WordPress Abilities API (husky/get-filter-schema, husky/search-products, husky/get-product), więc WordPress MCP Adapter może je również udostępniać.