MCP-сервер каталога kari
Публичный сервер Model Context Protocol для каталога
kari — сети магазинов обуви, одежды и аксессуаров в России, Казахстане
и Беларуси. AI-ассистенты могут искать товары, проверять цены, находить магазины и узнавать,
в каких магазинах есть нужный размер.
https://mcp.kari.com/mcp
-
Транспорт: Streamable HTTP, без сохранения состояния, ответы в формате JSON.
-
Аутентификация и API-ключ не требуются.
-
Только чтение: сервер не оформляет заказы и не поддерживает корзину. Покупка и самовывоз
доступны на сайте по ссылке
urlтовара. -
Ограничение частоты запросов: 60 запросов в минуту с одного IP-адреса.
-
Название в реестре:
com.kari/catalogв
В этом репозитории находятся описание сервера, конфигурации клиентов и навык для агента. Сам сервер
работает на стороне kari и не является проектом с открытым исходным кодом.
Что можно спросить
-
«Найди белые кроссовки 38 размера дешевле 5000 рублей в Казани»
-
«Есть ли в Алматы магазин, где сегодня можно забрать эту модель 41 размера?»
-
«Покажи магазины kari в Минске и их часы работы»
-
«Сравни состав и рейтинг этих двух ботинок»
-
«Найди женские ботинки 37 размера в Москве со скидкой»
Подключение
Claude (claude.ai, приложения для компьютера и мобильных устройств)
Settings → Connectors → Add custom connector. Укажите URL https://mcp.kari.com/mcp.
Настройки OAuth не требуются.
Claude Code
claude mcp add --transport http kari https://mcp.kari.com/mcp
Также можно установить plugin из этого репозитория — он добавит и сервер, и навык:
/plugin marketplace add kari-it/kari-mcp
/plugin install kari-catalog@kari
ChatGPT
Откройте Settings → Apps & Connectors → Advanced, включите Developer mode, затем создайте
connector с URL https://mcp.kari.com/mcp и параметром аутентификации No authentication.
VS Code / GitHub Copilot
.vscode/mcp.json:
{
"servers": {
"kari": { "type": "http", "url": "https://mcp.kari.com/mcp" }
}
}
Cursor
~/.cursor/mcp.json:
{
"mcpServers": {
"kari": { "url": "https://mcp.kari.com/mcp" }
}
}
Другие клиенты
Подойдёт любой клиент, поддерживающий удалённые MCP-серверы через Streamable HTTP. Для клиентов,
работающих только через stdio, используйте мост, например mcp-remote:
{
"mcpServers": {
"kari": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.kari.com/mcp"] }
}
}
Инструменты
Для каждого инструмента укажите country: ru (Россия, RUB), kz (Казахстан, KZT) или by (Беларусь, BYN).
Цены и наличие зависят от города. Если не указать city_id, используется столица.
| Инструмент | Назначение | Основные входные параметры |
|---|---|---|
find_city | Находит города, где работает kari, по части названия; возвращает до 10 городов с city_id | query |
find_stores | Показывает магазины в городе с адресами, часами работы и координатами; поддерживает фильтрацию по названию, адресу, торговому центру или станции метро; по 10 магазинов на странице | city_id, query, page |
search_products | Ищет товары в каталоге с учётом фильтров; возвращает цену, диапазон размеров и ссылку на сайт | query, city_id, price_min, price_max, size, brand, sort, limit, page |
get_product | Возвращает сведения о товаре: цену, изображения, цвет, состав, рейтинг и размеры с указанием наличия в городе | articul, city_id |
check_availability | Показывает магазины в городе, где можно получить товар нужного размера, и сроки выдачи; количество товаров не раскрывается | articul, size, city_id |
sort: relevance, price_asc, price_desc, rating, discount.
Для всех инструментов указаны аннотации readOnlyHint: true, destructiveHint: false.
Типичный сценарий
-
Вызовите
find_cityс названием города пользователя и сохранитеcity_id. -
Вызовите
search_products, передав запрос на языке пользователя и нужные фильтры. -
Вызовите
get_productдля выбранногоarticul, чтобы получить сведения о размерах, составе и параметреavailable. -
Вызовите
check_availabilityдля нужного размера, чтобы узнать, в каких магазинах и когда его можно получить. -
Передайте пользователю
urlтовара: заказ оформляется на сайте.
Примечания для моделей:
-
sizesвsearch_productsобозначает диапазон размеров модели, а не наличие на складе. -
availableвget_productозначает, что товар можно заказать в этом городе — из магазина илисо склада. Это не означает, что товар сегодня есть на полке. Сроки самовывоза указывает
check_availability. -
У товаров без размеров (сумок и аксессуаров) поле
sizesпустое. Вызывайтеcheck_availabilityбез параметра
size. -
old_priceиdiscount_percentвозвращаются только в том случае, если на сайте указана скидка.
Вызов без MCP-клиента
Отправляйте по одному сообщению JSON-RPC 2.0 в каждом POST-запросе. Пакетные запросы не поддерживаются,
заголовок сессии не требуется.
curl -X POST https://mcp.kari.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"country":"ru","query":"белые кроссовки","limit":3}}}'
Текстовое описание для моделей доступно по адресу https://mcp.kari.com/.
Навык для агента
skills/kari-catalog/SKILL.md — это
Agent Skill, который подсказывает агенту, когда использовать этот сервер и в каком
порядке вызывать инструменты. Claude Code подключает его через plugin, указанный выше; другие агенты могут
скопировать папку в каталог навыков.
Обнаружение сервера
-
https://kari.com/llms.txt,https://kari.com/ai/— описание для пользователей и моделей. -
https://mcp.kari.com/.well-known/mcp/server-card.jsonи
https://kari.com/.well-known/mcp.json — карточка сервера.
- server.json — запись, опубликованная в MCP Registry.
На русском
Открытый MCP-сервер каталога kari: поиск обуви, одежды и аксессуаров, цены, магазины и
наличие размеров в России, Казахстане и Беларуси. Адрес — https://mcp.kari.com/mcp,
аутентификация не требуется, сервер работает только на чтение. Ограничение — 60 запросов в минуту с одного адреса.
Инструкции по подключению доступны на странице https://kari.com/ai/.
Контакты
Вопросы о сервере: https://kari.com/ai/.