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
- HUSKY ayarlarını açın ve MCP Server sekmesine gidin.
- Enable MCP server seçeneğini Yes yapın.
- 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.

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.

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.txtadresinde bir tane sunar; - fiziksel bir
llms.txtdosyası 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-cardadresinde; 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)
- Customize → Connectors bölümünü açın (
claude.ai/customize/connectors). - Add custom connector düğmesine tıklayın ve adresi yapıştırın.
- 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
chatgpt.com/pluginsadresini açın, + düğmesine basın ve Add custom MCP server seçeneğini seçin.- Bir ad girin, adresi Server URL olarak yapıştırın ve No authentication seçeneğini seçin.
- 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.

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.
0bir 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.