HUSKY - WooCommerce Product Filter Professional

MCP Sunucusu: Müşterileriniz Mağazanızda Claude ve ChatGPT'den Arama Yapsın

MCP Sunucusu: Müşterileriniz Mağazanızda Claude ve ChatGPT'den Arama Yapsın

Giderek daha fazla insan alışverişe bir sohbet penceresinde başlıyor. Claude'dan ya da ChatGPT'den "43 numara, 120 euronun altında su geçirmez trekking botu" istiyor ve asistanın satın alabilecekleri ürünlerle dönmesini bekliyor. Asistan yalnızca okuyabildiği şeyi önerebilir. Yalnızca bir web sitesi olan mağaza arada bir taranır. Kendi MCP sunucusu olan mağaza ise her sorulduğunda gerçek filtreleri, fiyatları ve stok durumuyla canlı olarak aranır.

HUSKY, 3.4.7 sürümünden beri WooCommerce mağazanıza bir MCP sunucusu ekler. MCP (Model Context Protocol), yapay zeka asistanlarının dış verilere bağlanması için kullanılan standart yöntemdir. Sunucu açıldığında, mağazanıza bağlı bir asistan kataloğunuzu HUSKY filtre formunuzla tamamen aynı şekilde filtreler ve ürünlerinizle, fiyatlarınızla ve bağlantılarınızla yanıt verir. Müşteri daha sonra ürün sayfanızı açar ve her zamanki gibi sitenizde satın alır.

Demo mağazamızda hemen deneyin: Claude veya ChatGPT'ye https://demo.products-filter.com/hello-mcp adresini bağlayıcı olarak ekleyin ve bir şey isteyin, örneğin "30 doların altında kırmızı giysiler".

Ne kazanırsınız

  • Müşterileriniz için alışveriş asistanı, size ve onlara ücretsiz. Bir yapay zeka hizmeti için ödeme yapmazsınız. Müşteriniz zaten kullandığı asistana tek bir adres ekler ve kataloğunuzla kendi sözcükleriyle, kendi dilinde konuşur.
  • Büyük kataloglarda arama kolaylaşır. Binlerce ürünü ve onlarca özelliği olan bir mağazada insanlar uzun filtre formlarından vazgeçer. Asistan tüm filtrelerinizi okur, birleştirir ve sonucu adım adım daraltır: "yalnızca stokta olanlar", "daha ucuz olanlar", "aynısı mavi renkte".
  • Güvenebileceğiniz yanıtlar. Asistan sitenizin eski bir kopyasına bakarak tahmin yürütmez. Her arama filtre formunuzla aynı sorgu üzerinden çalışır; yani ziyaretçinin gördüğü filtreleri, aynı mantığı (OR, AND, NOT IN), aynı değerleri ve aynı sayıları görür.
  • Ürün sayfalarınıza trafik. Her sonuç ürün sayfanıza bağlanır. Arama, değişken bir ürünü tek bir varyasyona indirdiyse bağlantı o varyasyon önceden seçili olarak açılır, örneğin ?attribute_pa_color=red&attribute_pa_size=42.
  • Dilleriniz ve para birimleriniz. WPML veya Polylang ile asistan müşterinin dilinde arama yapabilir. FOX Currency Switcher ile fiyatları müşterinin para biriminde gösterebilir ve ürün bağlantısı da o para biriminde açılır.
  • Görünür bir duyuru. Sitenizdeki bir kutu müşterilere yapay zeka asistanlarıyla alışveriş yapabileceklerini söyler; yapay zeka araçları da sunucunuzu standart keşif dosyaları üzerinden kendileri bulur.

Mağazam için güvenli mi?

Sunucu yalnızca herkese açık kataloğu göstermek için tasarlanmıştır, başka hiçbir şeyi değil.

  • Varsayılan olarak kapalı. Siz açana kadar sunucu, adresleri, keşif dosyaları, head bağlantısı, llms.txt bölümü ve kısa kod kutusu sitenizde bulunmaz.
  • Salt okunur. Üç aracın hepsi yalnızca okur. Sunucu üzerinden hiçbir şey satın alınamaz, sepete eklenemez, düzenlenemez veya silinemez. Ödeme bağlantısı hiçbir zaman döndürülmez.
  • Misafir ziyaretçi olarak çalışır. Taslakları, özel ürünleri, parola korumalı ürünleri ve katalogdan gizlenmiş ürünleri hiçbir zaman döndürmez. WooCommerce stokta olmayan ürünleri gizliyorsa sunucu da gizler. WooCommerce "Coming soon" modunda araçlar yanıt vermeyi reddeder.
  • Hesap yok, anahtar yok, kişisel veri yok. Sunucu, herhangi bir ziyaretçinin görebildiğini okuduğu için oturum açmayı gerektirmez. Çerez bırakmaz ve arayan hakkında hiçbir şey saklamaz.
  • İstek sınırları. Her adrese katı bir sınır uygulanır; varsayılan olarak dakikada 60 istek ve 20'lik ani artışlar. Sınır aşıldığında arayan, beklemesi gereken saniye sayısıyla birlikte HTTP 429 alır. Engel geçicidir ve kendiliğinden kalkar, elle açılacak bir şey yoktur.
  • Yapay zeka platformları için ayrı bir sınır. claude.ai veya ChatGPT kullanan müşteriler mağazanıza asistanın kendi sunucularından ulaşır, bu yüzden birçok müşteri birkaç adresi paylaşır. Anthropic ve OpenAI'nin bu amaçla yayımladığı adres aralıklarına kendi, daha yüksek sınırları uygulanır; böylece popüler bir mağaza kendi müşterilerini dışarıda bırakmaz.
  • Önbellek. Aynı aramaların tekrarı kısa süreli bir önbellekten gelir (varsayılan 90 saniye); böylece aynı soru yüz kez sorulsa da yüz veritabanı sorgusu çalışmaz. Ürünlerde, stokta, fiyatlarda, terimlerde veya filtre ayarlarında yapılan her değişiklik önbelleği temizler.
  • Tarayıcı kaynakları. Diğer web sitelerindeki tarayıcı tabanlı MCP istemcilerinin sunucunuzu kullanmasını istemiyorsanız, izin verdiğiniz kaynakları listeleyin.

Gereksinimler

HUSKY 3.4.7 veya daha yeni, WordPress 6.0 veya daha yeni, WooCommerce, PHP 7.4 ile 8.5 arası. WordPress 6.9 ve sonrasında araçlar WordPress Abilities API'ye de kaydedilir.

1. Etkinleştirin

  1. HUSKY ayarlarını açın ve MCP Server sekmesine gidin.
  2. Enable MCP server seçeneğini Yes yapın.
  3. Save changes düğmesine tıklayın. Kaydedene kadar adres yanıt vermez.

Sekmede artık Copy düğmesiyle birlikte Your MCP server address alanı görünür.

HUSKY ayarlarındaki MCP Server sekmesi

2. Sunucu adresiniz

Adres Ne zaman
https://your-shop.com/wp-json/husky/v1/mcp varsayılan adres, her zaman çalışır
https://your-shop.com/index.php?rest_route=/husky/v1/mcp düz kalıcı bağlantılarda varsayılan adres
https://your-shop.com/ai-shop belirlediyseniz kendi kısa adresiniz

Kendi adresiniz. Your own address (pretty URL) alanına boş olan herhangi bir yolu yazın, örneğin ai-shop. Alan, siz yazarken denetler ve bir sayfa, yazı, kategori veya dosya zaten o yolu kullanıyorsa sizi uyarır. Kısa bir adresi müşterilere vermek daha kolaydır. Varsayılan adres çalışmaya devam eder; server card, llms.txt, head bağlantısı ve kısa kod kutusu ise kısa adrese geçer. Web sunucusu bilinmeyen adresleri WordPress'e ilettiği sürece (standart .htaccess ve nginx try_files kuralları bunu yapar) düz bağlantılar dahil her kalıcı bağlantı yapısıyla çalışır.

MCP istemcileri için: Streamable HTTP aktarımı, kimlik doğrulama yok, aynı adreste 2026-07-28, 2025-11-25 ve 2025-06-18 protokol sürümleri.

3. Müşterilerinize duyurun

Kimsenin bilmediği bir sunucu kimseye yarar sağlamaz. HUSKY, onu duyurmak için iki yol sunar: biri insanlar, biri yapay zeka araçları için.

Sayfalarınızda bir kutu

[woof_mcp_connect] kısa kodunu istediğiniz yere ekleyin: bir sayfaya, bir yazıya veya kenar çubuğunuzdaki ya da alt bilgideki bir Text ya da Shortcode widget'ına. Blok düzenleyicide AI assistant connection (HUSKY MCP) bloğunu kullanın. Kutu, sunucu adresinizi Copy düğmesiyle ve Claude, ChatGPT ile diğer asistanlar için üç kısa adımla gösterir.

Müşterilere mağaza sayfalarında gösterilen bağlantı kutusu

Başlık ve metin, MCP Server sekmesinde Box for your shop pages altında bir kez ayarlanır ya da kullanım başına verilir:

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

Metinler, filtrenin geri kalanı gibi HUSKY taksonomi etiketi çeviri alanıyla çevrilebilir.

Kutu için iyi bir yer mağaza kenar çubuğu, alt bilgi ya da menünüzden bağlantı verilen "Yapay zekayla alışveriş" gibi kısa bir sayfadır.

Yapay zeka araçları için keşif dosyaları

Yapay zeka ajanları ve dizinler, bir sitenin makine tarafından okunabilir açıklamalarını arar. Sunucu açıkken HUSKY bunları sizin için yayımlar:

  • llms.txt. Sitenizin kökündeki düz metin bir dosyadır ve yapay zeka araçlarına sitenin ne olduğunu ve nereye bakacaklarını söyler. HUSKY ona MCP sunucunuzla ilgili bir bölüm ekler:
  • llms.txt dosyanızı Rank Math veya Website LLMs.txt eklentisi oluşturuyorsa bölüm onların dosyasına eklenir;
  • sitenizde llms.txt yoksa HUSKY, sunucu açıkken /llms.txt adresinde bir tane sunar;
  • fiziksel bir llms.txt dosyası hiçbir zaman değiştirilmez. Sekme, bölümü dosyaya yapıştırılmaya hazır halde gösterir.
  • Server card, <your address>/server-card adresinde; sunucu adını, açıklamasını ve adreslerini içerir.
  • /.well-known/ai-catalog.json, server card'a işaret eder.
  • Her sayfada sayfa head bölümünde bağlantılar (<link rel="ai-catalog"> ve <link rel="service-desc">).

llms.txt bölümünü ve head bağlantısını sekmede Discovery altından kapatabilirsiniz.

4. Müşteri nasıl bağlanır

Sekme, aşağıdaki her kod parçasını adresiniz önceden doldurulmuş ve her birinin yanında bir Copy düğmesiyle gösterir. https://your-shop.com/ai-shop adresini kendi adresinizle değiştirin.

Claude (claude.ai, Claude Desktop)

  1. Customize → Connectors bölümünü açın (claude.ai/customize/connectors).
  2. Add custom connector düğmesine tıklayın ve adresi yapıştırın.
  3. OAuth alanlarını boş bırakın ve Add düğmesine tıklayın.

Bir sohbette, bağlayıcıyı araçlar menüsünden açın ve örneğin şunu isteyin: "42 numara, 150 euronun altında kırmızı spor ayakkabı bul."

ChatGPT

  1. chatgpt.com/plugins adresini açın, + düğmesine basın ve Add custom MCP server seçeneğini seçin.
  2. Bir ad girin, adresi Server URL olarak yapıştırın ve No authentication seçeneğini seçin.
  3. Onaylayın, Create as a plugin seçeneğini seçin, ardından bir sohbette @ yazıp onu seçin.

Hangi planların ve çalışma alanı rollerinin özel bağlayıcı ekleyebileceğine Anthropic, OpenAI ve çalışma alanı yöneticisi karar verir, mağazanız değil.

Claude Code

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

Cursor

Bir projede .cursor/mcp.json, tüm projeler için ~/.cursor/mcp.json:

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

VS Code (GitHub Copilot)

.vscode/mcp.json ya da MCP: Add Server → HTTP komutu:

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

Diğer herhangi bir MCP istemcisi

Uzak sunucu olarak ekleyin: Streamable HTTP, kimlik doğrulama yok. Sunucuyu bir terminalden denetlemek için:

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

5. Asistan neler yapabilir

Araç Ne yapar
husky_get_filter_schema Formunuzdaki filtreleri sırasıyla listeler: kategoriler, özellikler, markalar, fiyat, stok, indirimde olanlar, meta alanları, metin araması vb.; her biri değerleri, ürün sayıları ve mantığıyla birlikte. Ayrıca sıralama düzenlerini, dilleri ve para birimlerini de verir.
husky_search_products Bu filtrelerin herhangi bir birleşimiyle arama yapar. Ürün sayfasını ad, fiyat, indirimli fiyat, stok, görsel, puan, özellikler ve bağlantıyla döndürür; ayrıca kalan değerlerin sayılarını verir, böylece asistan aramayı daraltabilir. Hiçbir şey bulunamazsa hangi filtrenin kaldırılacağını söyler ve en yakın alternatifleri önerir.
husky_get_product ID, URL veya SKU ile tek bir ürün: açıklama, galeri, kategoriler, özellikler, fiyat ve stok bilgisiyle varyasyonlar ve bağlantı.

Müşterilerinizin yapabileceği istekler:

  • "16 GB RAM'li, 800'ün altında, stokta olan dizüstü bilgisayarlar."
  • "Bu ceketin benzeri, ama su geçirmez ve mavi."
  • "İndirimdeki en ucuz kulaklıklar, bağlantısıyla birlikte."
  • "Gibt es diese Schuhe in Größe 42? Preise bitte in Euro."

Instructions for agents. Her asistan, araçların nasıl kullanılacağını anlatan kısa bir metin alır: önce şemayı çağır, yalnızca gerçek filtre değerlerini kullan, bağlantı ver. Bu metni sekmede Instructions for agents altından düzenleyebilirsiniz; örneğin iade politikanızı ya da istediğiniz üslubu ekleyebilirsiniz. Reset to default, HUSKY sürümünüzün metnini geri getirir. Varsayılanı kullandığınız sürece, güncellemelerle gelen iyileştirmeleri de alırsınız.

Name, title and description shown to agents alanları site başlığınızdan alınır ve sekmeden değiştirilebilir.

6. Diller ve para birimleri

  • WPML ve Polylang. Asistan bir dil iletebilir. Sonuçlar, sayılar, adlar ve bağlantılar o zaman o dildedir ve yalnızca o dildeki ürünler döndürülür. Dil verilmezse varsayılan dil kullanılır.
  • FOX Currency Switcher. Asistan başka bir para birimi istemedikçe fiyatlar ana para biriminizdedir. Müşterinin para birimi seçimi, geo-IP ve çerezler sunucuyu hiçbir zaman etkilemez. Bir para birimi istendiğinde fiyatlar FOX tarafından mağazanızdaki gibi dönüştürülür, para birimi başına sabit fiyatlar dahil; ürün bağlantıları da para birimini taşır (?currency=EUR), böylece ürün sayfası asistanın söylediği fiyatla açılır.

Asistanın açtığı bir ürün bağlantısı: Almanca dil, euro fiyatları, varyasyon önceden seçili

7. İstek sınırı ve önbellek ayarları

Ayar Varsayılan
IP adresi başına dakikada 60 istek, 20'lik ani artışlar
Yapay zeka platformları (yayımlanan her aralık) dakikada 1200 istek, 300'lük ani artışlar
Aynı aramalar için önbellek 90 saniye
Sayfa başına en fazla ürün 50 (1 ile 100 arasında ayarlayabilirsiniz)
  • Varsayılan yapay zeka platformu listesi yalnızca sağlayıcıların kendi belgelerinde yayımladığı aralıkları içerir: Anthropic (Claude) ve OpenAI (ChatGPT bağlayıcıları). Varsayılan listeyi kullandığınız sürece liste HUSKY güncellemelerini izler. Listeyi düzenlerseniz sizin listeniz korunur ve Reset to default HUSKY sürümünüzün listesini yükler.
  • 0 bir sınırı kapatır. Rate limit: Off hepsini kapatır.
  • Sayaçlar, varsa kalıcı nesne önbelleğinizde (Redis, Memcached) ya da APCu'da, yoksa veritabanında tutulur.

8. Sorun giderme

Belirti Neye bakmalı
Adres 404 döndürüyor Sunucu kapalı ya da açtıktan sonra ayarlar kaydedilmemiş.
Kısa adres 404 döndürüyor Başka bir sayfa veya dosya o adresi kullanıyor (sekme çakışmayı gösterir) ya da web sunucusu bilinmeyen adresleri WordPress'e iletmiyor. Varsayılan adres yine çalışır.
/.well-known/ai-catalog.json bulunamıyor WordPress bir alt klasöre kurulu ve alan adının kökünde yanıt veremiyor. Server card ve head bağlantısı yine çalışır.
/.well-known/ai-catalog.json 403 döndürüyor nginx yapılandırmanız noktayla başlayan tüm adresleri engelliyor. Bu kuralın üstüne location ^~ /.well-known/ { try_files $uri $uri/ /index.php?$args; } ekleyin.
Adresi tarayıcıda açmak ya da bir sohbete yapıştırmak 405 veriyor Beklenen durum. Adres bir web sayfası değildir: yalnızca MCP isteklerine yanıt verir. Onu asistana bağlayıcı olarak ekleyin (bölüm 4).
Asistan "too many requests" diyor İstek sınırına ulaşıldı. Sekmedeki sayıları artırın ya da platformun yayımladığı aralığı ekleyin.
Fiyatlar ana para biriminde Beklenen durum. Asistandan başka bir para birimi isteyin ("euro cinsinden").
Bir güvenlik duvarı veya güvenlik eklentisi asistanı engelliyor MCP adresine tarayıcı dışı istekler için izin verin. claude.ai ve ChatGPT kendi sunucularından çağrı yapar.
Sonuçlar mağazada gördüklerinizden farklı Parola korumalı ürünler MCP sonuçlarında hiçbir zaman yer almaz. Ayrıca oturumunuzun kapalı olduğunu kontrol edin: bazı ürünler yalnızca oturum açmış kullanıcılara görünür.

9. Geliştiriciler için

Filtre Amaç
woof_mcp_filters Ajanlara verilen filtre listesini değiştirir
woof_mcp_product_card Arama sonuçlarındaki bir ürün kartını değiştirir
woof_mcp_product_details husky_get_product yanıtını değiştirir
woof_mcp_product_is_public Bir ürünün gösterilip gösterilemeyeceğine karar verir
woof_mcp_server_card Server card'ı değiştirir
woof_mcp_llms_txt llms.txt bölümünü değiştirir
woof_mcp_default_ai_ranges Varsayılan yapay zeka platformu aralıklarını değiştirir
woof_mcp_client_ip HUSKY'ye bir proxy'nin arkasındaki gerçek arayan IP'sini bildirir
woof_mcp_respect_coming_soon Araçlara "Coming soon" modunda izin verir

WordPress 6.9 ve sonrasında aynı üç işlem WordPress Abilities API'ye de kaydedilir (husky/get-filter-schema, husky/search-products, husky/get-product), böylece WordPress MCP Adapter bunları da sunabilir.