Бесплатный MCP для поиска товаров на Kaspi.kz — Claude теперь видит реальные цены

TL;DR — уже готово

Я выложил бесплатный MCP-сервер kaspi-mcp-free для Kaspi.kz Магазина. Подключаете его к Claude — и спрашиваете на естественном языке: «найди мне беспроводные наушники до 30 000 ₸ с рейтингом ≥ 4,5». Claude сам идёт в Kaspi, забирает актуальные карточки сегодняшнего дня — с ценой, продавцами, отзывами — и отвечает.

Если слово «MCP» вам ничего не говорит — не страшно, ниже объясняю за 60 секунд. Если уже разобрались — листайте сразу к разделу подключения.

1. Что такое MCP за 60 секунд

MCP — это USB-C для AI. Любой сервис (база данных, сайт, CRM, маркетплейс) пишет один MCP-адаптер — и сразу становится доступен во всех AI-клиентах: Claude, ChatGPT, Cursor. Один стандарт, подключается ко всему. Anthropic открыл протокол в конце 2024, за полгода его поддержали OpenAI и весь рынок.

Технические детали — в официальной спецификации MCP и документации Anthropic. Для подключения готового сервера они не понадобятся.

2. Почему обычный Claude/ChatGPT плохо ищут товары

Любой, кто пробовал спросить у Claude или ChatGPT «посоветуй смартфон до 200 000 на Kaspi», знает результат: общие слова, какие-то ссылки на Galaxy A54 из 2022 года, выдуманные цены. И это не потому, что модели глупые. Дело в архитектуре:

Это не проблема Claude или ChatGPT. У Kaspi нет публичного API, фронт защищён антибот-системами, и без специальной интеграции LLM туда просто не пройдёт. Нужен переводчик — этот переводчик называется MCP-сервер.

3. Что умеет этот MCP

Сервер по адресу shopping.redstat.kz/mcp отдаёт Claude три инструмента — три «функции», которые он может вызывать сам, когда понимает, что нужны данные с Kaspi:

Claude сам решает, какой инструмент позвать. Вы пишете естественный текст: «найди наушники до 30 000» — он вызовет shop_search. «А кто продаёт самые дешёвые?» — вызовет shop_offers. «А что в отзывах ругают?» — shop_reviews. От вас никакого SQL и API не требуется.

4. Без MCP vs с MCP — конкретный пример

Запрос: «Найди мне беспроводные наушники на Kaspi до 30 000 ₸ с рейтингом ≥ 4,5».

5. Как подключить — три пути

Выбери свой путь. Сервер уже запущен по адресу https://shopping.redstat.kz/mcp — тебе нужно только сообщить об этом своему AI-клиенту.

claude mcp add --transport http kaspi https://shopping.redstat.kz/mcp

{
  "mcpServers": {
    "kaspi": {
      "url": "https://shopping.redstat.kz/mcp"
    }
  }
}

6. Проверь что работает

Если видишь просто текстовый ответ без карточек — значит коннектор не подключился. Проверь: открыт ли новый чат (инструменты подхватываются при старте сессии), и не показывает ли интерфейс значок «MCP not connected» рядом с именем коннектора в настройках.

7. Хочешь свой сервер? (опционально, для продвинутых)

Код открытый и лежит на GitHub: mkhamzanov/kaspi-mcp-free. Это Python-проект (~5 файлов) на базе FastMCP и httpx. Установка:

git clone https://github.com/mkhamzanov/kaspi-mcp-free.git
cd kaspi-mcp-free
pip install fastmcp httpx

# запустить локально (stdio-режим для Claude Desktop)
python server.py

# или HTTP-режим (для деплоя на VPS)
# Linux/macOS:
MCP_TRANSPORT=http PORT=8000 python server.py
# Windows PowerShell:
$env:MCP_TRANSPORT="http"; $env:PORT="8000"; python server.py

Для деплоя рекомендую казахстанский VPS — это важно, потому что Kaspi режет часть облачных IP вне Казахстана (отдаёт 429). Подробнее о настройке VPS — у меня есть статья про деплой на Hetzner с SSH-ключами. Репозиторий также содержит конфиги для Vercel и Railway — но через KASPI_PROXY при деплое за пределами KZ.

8. Кому это пригодится

Личный опыт: я сделал этот MCP в первую очередь под свои задачи. Я занимаюсь Data Science и часто строю аналитику для маркетплейсов — у меня была серия про ценовые сегменты Kaspi и юнит-экономику. Каждый раз руками тащить данные было больно. С MCP — Claude сам приносит. Делюсь инструментом, потому что ~12 миллионов активных пользователей Kaspi — это слишком большой рынок, чтобы один человек его обрабатывал в одиночку. Чем больше людей вокруг умеют вайбкодить с Kaspi — тем интереснее рынок. Про это Андрей Карпаты говорит как про «vibe coding».

9. Ссылки и что почитать дальше

• https://shopping.redstat.kz/mcp — готовый публичный сервер. Просто вставь этот URL в коннектор.
• github.com/mkhamzanov/kaspi-mcp-free — репозиторий. Звезда не помешает, если зашло.
• MCP простыми словами — предыдущая статья про MCP в целом.
• modelcontextprotocol.io — официальная спецификация MCP.
• docs.claude.com — MCP — документация Anthropic по MCP.
• platform.openai.com/docs/mcp — документация OpenAI по MCP (ChatGPT).
• FastMCP — Python-фреймворк, на котором держится сервер.
• awesome MCP servers — каталог других open-source MCP-серверов для вдохновения.