API ВЕГА
English

MCP-сервер каталога kari

Публичный сервер Model Context Protocol для каталога

kari — сети магазинов обуви, одежды и аксессуаров в России, Казахстане

и Беларуси. AI-ассистенты могут искать товары, проверять цены, находить магазины и узнавать,

в каких магазинах есть нужный размер.

https://mcp.kari.com/mcp
  • Транспорт: Streamable HTTP, без сохранения состояния, ответы в формате JSON.

  • Аутентификация и API-ключ не требуются.

  • Только чтение: сервер не оформляет заказы и не поддерживает корзину. Покупка и самовывоз

    доступны на сайте по ссылке url товара.

  • Ограничение частоты запросов: 60 запросов в минуту с одного IP-адреса.

  • Название в реестре: com.kari/catalog в

    официальном MCP Registry.

В этом репозитории находятся описание сервера, конфигурации клиентов и навык для агента. Сам сервер

работает на стороне 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_idquery
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/.