MCP-сервер: нехай покупці шукають у вашому магазині з Claude і ChatGPT

Дедалі більше людей починають покупки у вікні чату. Вони просять Claude або ChatGPT знайти «водостійкі трекінгові черевики 43 розміру до 120 євро» і чекають, що асистент поверне товари, які можна купити. Асистент може порекомендувати лише те, що здатен прочитати. Магазин, який є просто сайтом, індексують час від часу. Магазин із власним MCP-сервером опитують наживо, з реальними фільтрами, цінами й залишками, щоразу, коли хтось питає.

Починаючи з версії 3.4.7, HUSKY додає до вашого магазину WooCommerce MCP-сервер. MCP (Model Context Protocol) це стандартний спосіб підключення ШІ-асистентів до зовнішніх даних. Коли сервер увімкнено, асистент, підключений до вашого магазину, фільтрує каталог так само, як форма фільтра HUSKY, і відповідає вашими товарами, цінами та посиланнями. Потім покупець відкриває сторінку товару й купує на вашому сайті, як завжди.

Спробуйте просто зараз на нашому демо-магазині: додайте https://demo.products-filter.com/hello-mcp як конектор у Claude або ChatGPT і запитайте щось, наприклад «червоний одяг до 30 доларів».

Що ви з цього отримаєте

• Помічник для покупців, безкоштовний для вас і для них. Ви не платите за ШІ-сервіс. Покупець користується асистентом, який у нього вже є, додає одну адресу й спілкується з вашим каталогом своїми словами та своєю мовою.
• У великому каталозі легко шукати. У магазині з тисячами товарів і десятками атрибутів люди кидають довгі форми фільтрів. Асистент читає всі ваші фільтри, поєднує їх і крок за кроком звужує результат: «тільки в наявності», «дешевші», «таке саме синє».
• Відповіді, яким можна вірити. Асистент не вгадує за старою копією вашого сайту. Кожен пошук іде тим самим запитом, що й ваша форма фільтра, тому асистент бачить ті самі фільтри, ту саму логіку (OR, AND, NOT IN), ті самі значення й ті самі лічильники, що й відвідувач.
• Трафік на сторінки товарів. Кожен результат веде на сторінку товару. Якщо пошук звузив варіативний товар до однієї варіації, посилання відкриває його з уже вибраною варіацією, наприклад ?attribute_pa_color=red&attribute_pa_size=42.
• Ваші мови й валюти. З WPML або Polylang асистент може шукати мовою покупця. З FOX Currency Switcher він може показувати ціни у валюті покупця, і посилання на товар теж відкривається в цій валюті.
• Помітне оголошення. Блок на вашому сайті повідомляє покупцям, що вони можуть купувати через свого ШІ-асистента, а ШІ-інструменти самі знаходять ваш сервер за стандартними файлами виявлення.

Чи безпечно це для мого магазину?

Сервер створено так, щоб показувати публічний каталог і більше нічого.

• Вимкнено за замовчуванням. Доки ви його не ввімкнете, сервера, його адрес, файлів виявлення, посилання в head, розділу llms.txt і блока із шорткодом на вашому сайті не існує.
• Лише читання. Усі три інструменти тільки читають. Через сервер не можна нічого купити, додати в кошик, змінити чи видалити. Посилання на оформлення замовлення не повертаються ніколи.
• Працює як гість. Сервер не повертає чернетки, приватні товари, товари під паролем і товари, приховані з каталогу. Якщо WooCommerce ховає товари, яких немає в наявності, сервер теж їх ховає. У режимі WooCommerce «Coming soon» інструменти відмовляються відповідати.
• Без акаунтів, ключів і персональних даних. Серверу не потрібен вхід, бо він читає лише те, що бачить будь-який відвідувач. Він не встановлює cookies і нічого не зберігає про того, хто звертається.
• Ліміти запитів. Для кожної адреси діє жорсткий ліміт, за замовчуванням 60 запитів на хвилину зі сплесками до 20. Після перевищення ліміту той, хто звертається, отримує HTTP 429 із кількістю секунд очікування. Блокування тимчасове й знімається саме, розблоковувати нічого вручну не треба.
• Окремий ліміт для ШІ-платформ. Покупці, які користуються claude.ai або ChatGPT, звертаються до вашого магазину з власних серверів асистента, тож багато покупців ділять кілька адрес. Діапазони адрес, які Anthropic і OpenAI публікують для цього, мають власний, вищий ліміт, щоб популярний магазин не блокував власних покупців.
• Кеш. Повторні однакові пошуки беруться з короткого кешу (за замовчуванням 90 секунд), тож те саме запитання, поставлене сто разів, не запускає сто запитів до бази даних. Будь-яка зміна товарів, наявності, цін, термів чи налаштувань фільтра очищає його.
• Джерела запитів у браузері. Якщо ви не хочете, щоб браузерні MCP-клієнти на інших сайтах користувалися вашим сервером, перелічіть дозволені джерела (origins).

Вимоги

HUSKY 3.4.7 або новіший, WordPress 6.0 або новіший, WooCommerce, PHP від 7.4 до 8.5. У WordPress 6.9 і новіших інструменти також реєструються в WordPress Abilities API.

1. Увімкніть сервер

1. Відкрийте налаштування HUSKY і перейдіть на вкладку MCP Server.
2. Встановіть Enable MCP server у значення Yes.
3. Натисніть Save changes. Доки ви не збережете, адреса не відповідає.

Тепер на вкладці з'явиться Your MCP server address з кнопкою Copy.

2. Адреса вашого сервера

Власна адреса. У полі Your own address (pretty URL) введіть будь-який вільний шлях, наприклад ai-shop. Поле перевіряє його під час введення й попереджає, якщо цей шлях уже займає сторінка, запис, категорія чи файл. Коротку адресу легше повідомити покупцям. Типова адреса й далі працює, а server card, llms.txt, посилання в head і блок із шорткодом переходять на коротку. Вона працює з будь-якою структурою постійних посилань, зокрема з простою, якщо вебсервер передає невідомі адреси до WordPress (стандартні правила .htaccess і nginx try_files це роблять).

Для MCP-клієнтів: транспорт Streamable HTTP, без автентифікації, версії протоколу 2026-07-28, 2025-11-25 і 2025-06-18 на тій самій адресі.

3. Повідомте про нього покупцям

Сервер, про який ніхто не знає, нікому не допомагає. HUSKY дає два способи оголосити про нього: один для людей, другий для ШІ-інструментів.

Блок на ваших сторінках

Розмістіть шорткод [woof_mcp_connect] де завгодно: на сторінці, у записі або у віджеті Text чи Shortcode у бічній панелі чи футері. У редакторі блоків використовуйте блок AI assistant connection (HUSKY MCP). Блок показує адресу вашого сервера з кнопкою Copy і три короткі кроки для Claude, ChatGPT та інших асистентів.

Заголовок і текст задаються один раз на вкладці MCP Server у розділі Box for your shop pages або окремо для кожного використання:

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

Тексти можна перекласти в полі HUSKY taxonomy label translations, як і решту фільтра.

Хороше місце для блока: бічна панель магазину, футер або коротка сторінка на кшталт «Купуйте з ШІ» з посиланням у меню.

Файли виявлення для ШІ-інструментів

ШІ-агенти й каталоги шукають машинозчитувані описи сайту. Поки сервер увімкнено, HUSKY публікує їх за вас:

• llms.txt. Це простий текстовий файл у корені сайту, який підказує ШІ-інструментам, що це за сайт і де дивитися. HUSKY додає до нього розділ із вашим MCP-сервером:
• якщо ваш llms.txt генерує Rank Math або плагін Website LLMs.txt, розділ додається до їхнього файлу;
• якщо на сайті немає llms.txt, HUSKY віддає його за адресою /llms.txt, поки сервер увімкнено;
• фізичний файл llms.txt ніколи не змінюється. Вкладка показує розділ, готовий для вставки в нього.
• Server card за адресою <your address>/server-card, з назвою, описом і адресами сервера.
• /.well-known/ai-catalog.json, що вказує на server card.
• Посилання в head сторінки (<link rel="ai-catalog"> і <link rel="service-desc">) на кожній сторінці.

Розділ llms.txt і посилання в head можна вимкнути на вкладці в розділі Discovery.

4. Як покупець підключається

Вкладка показує кожен із наведених нижче фрагментів із уже підставленою вашою адресою та кнопкою Copy біля кожного. Замініть https://your-shop.com/ai-shop на свою адресу.

Claude (claude.ai, Claude Desktop)

1. Відкрийте Customize → Connectors (claude.ai/customize/connectors).
2. Натисніть Add custom connector і вставте адресу.
3. Залиште поля OAuth порожніми й натисніть Add.

У чаті увімкніть конектор у меню інструментів і запитайте, наприклад: «Знайди червоні кросівки 42 розміру до 150 євро.»

ChatGPT

1. Відкрийте chatgpt.com/plugins, натисніть + і виберіть Add custom MCP server.
2. Введіть назву, вставте адресу в поле Server URL і виберіть No authentication.
3. Підтвердіть, виберіть Create as a plugin, потім введіть @ у чаті й виберіть його.

Які тарифні плани й ролі в робочому просторі можуть додавати власні конектори, вирішують Anthropic, OpenAI та адміністратор робочого простору, а не ваш магазин.

Claude Code

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

Cursor

.cursor/mcp.json у проєкті або ~/.cursor/mcp.json для всіх проєктів:

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

VS Code (GitHub Copilot)

.vscode/mcp.json або команда MCP: Add Server → HTTP:

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

Будь-який інший MCP-клієнт

Додайте його як віддалений сервер: Streamable HTTP, без автентифікації. Щоб перевірити сервер із терміналу:

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

5. Що вміє асистент

Запити, які можуть робити ваші покупці:

• «Ноутбуки з 16 ГБ оперативної пам'яті до 800, в наявності.»
• «Щось схоже на цю куртку, але водостійке й синє.»
• «Найдешевші навушники зі знижкою, з посиланням.»
• "Gibt es diese Schuhe in Größe 42? Preise bitte in Euro."

Instructions for agents. Кожен асистент отримує короткий текст про те, як користуватися інструментами: спочатку викликати схему, використовувати лише реальні значення фільтрів, давати посилання. Ви можете змінити його на вкладці в розділі Instructions for agents, наприклад додати правила повернення товару або потрібний тон. Reset to default повертає текст вашої версії HUSKY. Поки ви залишаєте типовий текст, ви отримуєте його покращення з оновленнями.

Name, title and description shown to agents беруться із заголовка вашого сайту, і їх можна змінити на вкладці.

6. Мови й валюти

• WPML і Polylang. Асистент може передати мову. Тоді результати, кількості, назви й посилання будуть цією мовою, і повертаються лише товари цієї мови. Без вказаної мови використовується мова за замовчуванням.
• FOX Currency Switcher. Ціни подаються у вашій базовій валюті, якщо асистент не попросить іншу. Вибір валюти покупцем, geo-IP і cookies ніколи не впливають на сервер. Коли запитано валюту, FOX перераховує ціни точно так, як на вашій вітрині, зокрема з фіксованими цінами для окремих валют, а посилання на товари містять валюту (?currency=EUR), тож сторінка товару відкривається з тією самою ціною, яку назвав асистент.

7. Налаштування лімітів і кешу

• Типовий список ШІ-платформ містить лише діапазони, які вендори публікують у власній документації: Anthropic (Claude) і OpenAI (конектори ChatGPT). Поки ви залишаєте типовий список, він оновлюється разом з HUSKY. Якщо ви його змінили, ваш список зберігається, а Reset to default завантажує список вашої версії HUSKY.
• 0 вимикає один ліміт. Rate limit: Off вимикає всі.
• Лічильники зберігаються в постійному кеші об'єктів (Redis, Memcached) або в APCu, якщо вони доступні, інакше в базі даних.

8. Усунення несправностей

9. Для розробників

У WordPress 6.9 і новіших ті самі три операції зареєстровано в WordPress Abilities API (husky/get-filter-schema, husky/search-products, husky/get-product), тож WordPress MCP Adapter також може їх надавати.