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 скрывает товары, которых нет в наличии, сервер скрывает их тоже. В режиме «Coming soon» в WooCommerce инструменты отказываются отвечать.
- Без аккаунтов, ключей и персональных данных. Серверу не нужен вход, потому что он читает только то, что видит любой посетитель. Он не ставит 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. Включите сервер
- Откройте настройки HUSKY и перейдите на вкладку MCP Server.
- Установите для Enable MCP server значение Yes.
- Нажмите Save changes. Пока вы не сохранили настройки, адрес не отвечает.
Теперь на вкладке показан Your MCP server address с кнопкой Copy.

2. Адрес вашего сервера
| Адрес | Когда |
|---|---|
https://your-shop.com/wp-json/husky/v1/mcp |
адрес по умолчанию, работает всегда |
https://your-shop.com/index.php?rest_route=/husky/v1/mcp |
адрес по умолчанию при простых постоянных ссылках |
https://your-shop.com/ai-shop |
ваш собственный короткий адрес, если вы его задали |
Свой адрес. В поле 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, как и остальную часть фильтра.
Хорошее место для блока: боковая колонка магазина, подвал или небольшая страница вроде «Покупки с ИИ», на которую ведёт ссылка из меню.
Файлы обнаружения для ИИ-инструментов
ИИ-агенты и каталоги ищут машиночитаемые описания сайта. Пока сервер включён, 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)
- Откройте Customize → Connectors (
claude.ai/customize/connectors). - Нажмите Add custom connector и вставьте адрес.
- Поля OAuth оставьте пустыми и нажмите Add.
В чате включите коннектор в меню инструментов и спросите, например: «Найди красные кроссовки 42 размера дешевле 150 евро».
ChatGPT
- Откройте
chatgpt.com/plugins, нажмите + и выберите Add custom MCP server. - Введите название, вставьте адрес в поле Server URL и выберите No authentication.
- Подтвердите, выберите 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. Что умеет ассистент
| Инструмент | Что он делает |
|---|---|
husky_get_filter_schema |
Перечисляет фильтры вашей формы в их порядке: рубрики, атрибуты, бренды, цена, наличие, распродажа, мета-поля, текстовый поиск и так далее, каждый со своими значениями, количеством товаров и логикой, а также порядки сортировки, языки и валюты. |
husky_search_products |
Ищет по любой комбинации этих фильтров. Возвращает страницу товаров с названием, ценой, ценой со скидкой, наличием, изображением, рейтингом, атрибутами и ссылкой, а также счётчики оставшихся значений, чтобы ассистент мог сузить поиск. Если ничего не найдено, сообщает, какой фильтр убрать, и предлагает ближайшие альтернативы. |
husky_get_product |
Один товар по ID, URL или артикулу (SKU): описание, галерея, рубрики, атрибуты, вариации с ценами и наличием, а также ссылка. |
Запросы, которые могут задавать ваши клиенты:
- «Ноутбуки с 16 ГБ оперативной памяти дешевле 800, в наличии».
- «Что-нибудь похожее на эту куртку, но непромокаемое и синего цвета».
- «Самые дешёвые наушники по распродаже, со ссылкой».
- "Gibt es diese Schuhe in Größe 42? Preise bitte in Euro."
Instructions for agents. Каждый ассистент получает короткий текст о том, как пользоваться инструментами: сначала вызвать схему, использовать только реальные значения фильтров, давать ссылки. Вы можете изменить его на вкладке в разделе Instructions for agents, например чтобы добавить условия возврата или нужный вам тон. Reset to default возвращает текст вашей версии HUSKY. Пока вы оставляете текст по умолчанию, его улучшения приходят вместе с обновлениями.
Название, заголовок и описание, которые видят агенты, берутся из заголовка вашего сайта и могут быть изменены на вкладке.
6. Языки и валюты
- WPML и Polylang. Ассистент может передать язык. Тогда результаты, счётчики, названия и ссылки будут на этом языке, и возвращаются только товары этого языка. Если язык не указан, используется язык по умолчанию.
- FOX Currency Switcher. Цены указываются в вашей базовой валюте, пока ассистент не запросит другую. Выбор валюты покупателем, геолокация по IP и cookies никогда не влияют на сервер. Когда запрошена валюта, цены пересчитываются FOX точно так же, как в вашей витрине, включая фиксированные цены для отдельных валют, а ссылки на товары содержат валюту (
?currency=EUR), поэтому страница товара открывается с той же ценой, которую назвал ассистент.

7. Настройки лимитов запросов и кэша
| Настройка | По умолчанию |
|---|---|
| На один IP-адрес | 60 запросов в минуту, пики до 20 |
| ИИ-платформы (каждый опубликованный диапазон) | 1200 запросов в минуту, пики до 300 |
| Кэш одинаковых поисков | 90 секунд |
| Максимум товаров на странице | 50 (можно задать от 1 до 100) |
- Список ИИ-платформ по умолчанию содержит только диапазоны, которые вендоры публикуют в собственной документации: Anthropic (Claude) и OpenAI (коннекторы ChatGPT). Пока вы оставляете список по умолчанию, он обновляется вместе с HUSKY. Если вы его изменили, ваш список сохраняется, а Reset to default загружает список вашей версии HUSKY.
0отключает один лимит. Rate limit: Off отключает все лимиты сразу.- Счётчики хранятся в вашем постоянном объектном кэше (Redis, Memcached) или в APCu, если они доступны, иначе в базе данных.
8. Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Адрес отвечает 404 | Сервер выключен, или настройки не были сохранены после его включения. |
| Короткий адрес отвечает 404 | Этот адрес занят другой страницей или файлом (вкладка показывает конфликт), или веб-сервер не передаёт неизвестные адреса в WordPress. Адрес по умолчанию при этом работает. |
/.well-known/ai-catalog.json не найден |
WordPress установлен в подпапке и не может отвечать в корне домена. Server card и ссылка в head при этом работают. |
/.well-known/ai-catalog.json отвечает 403 |
Конфигурация nginx блокирует все адреса, начинающиеся с точки. Добавьте location ^~ /.well-known/ { try_files $uri $uri/ /index.php?$args; } выше этого правила. |
| При открытии адреса в браузере или вставке его в чат приходит 405 | Так и должно быть. Адрес не является веб-страницей: он отвечает только на MCP-запросы. Добавьте его в ассистент как коннектор (раздел 4). |
| Ассистент пишет «слишком много запросов» | Достигнут лимит запросов. Увеличьте значения на вкладке или добавьте опубликованный диапазон платформы. |
| Цены указаны в базовой валюте | Так и должно быть. Попросите у ассистента другую валюту («в евро»). |
| Файрвол или плагин безопасности блокирует ассистента | Разрешите MCP-адрес для запросов не из браузера. claude.ai и ChatGPT обращаются со своих собственных серверов. |
| Результаты отличаются от того, что вы видите в магазине | Товары под паролем никогда не попадают в результаты MCP. Проверьте также, что вы вышли из аккаунта: некоторые товары видны только авторизованным пользователям. |
9. Для разработчиков
| Фильтр | Назначение |
|---|---|
woof_mcp_filters |
Изменить список фильтров, передаваемый агентам |
woof_mcp_product_card |
Изменить карточку товара в результатах поиска |
woof_mcp_product_details |
Изменить ответ husky_get_product |
woof_mcp_product_is_public |
Решить, можно ли показывать товар |
woof_mcp_server_card |
Изменить server card |
woof_mcp_llms_txt |
Изменить раздел llms.txt |
woof_mcp_default_ai_ranges |
Изменить диапазоны ИИ-платформ по умолчанию |
woof_mcp_client_ip |
Сообщить HUSKY реальный IP вызывающей стороны за прокси |
woof_mcp_respect_coming_soon |
Разрешить инструменты в режиме «Coming soon» |
В WordPress 6.9 и новее те же три операции зарегистрированы в WordPress Abilities API (husky/get-filter-schema, husky/search-products, husky/get-product), поэтому WordPress MCP Adapter тоже может их предоставлять.