Kapruka MCP — MCP-сервер для Claude Code
Подключает к агенту REST API Kapruka.com: ассистент получает инструменты для работы с товарами и заказами магазина прямо из чата.
claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcpЧто делает Kapruka MCP
Kapruka MCP оборачивает REST API Kapruka.com и отдаёт его функции LLM-клиенту как MCP-инструменты. Внутри — сервер на FastMCP, асинхронный клиент на httpx с обработкой ошибок, модули инструментов по группам (товары, заказы) и конфигурация из переменных окружения. Есть отдельный CLI cli.py: им запускают сервер, проверяют доступность API и смотрят список зарегистрированных инструментов.
Публичный вариант доступен по адресу https://mcp.kapruka.com/mcp — его и прописывают в конфиг клиента. Если поднимаете сервер сами, заранее понадобятся Python, виртуальное окружение и ключ Kapruka API в .env. По умолчанию сервер слушает порт 8000 по streamable HTTP; для отладки в MCP Inspector его запускают через --stdio. Без ключа API локальная копия к Kapruka не подключится.
Отдельная история — доверенные партнёры. Тем, кого нельзя внести в IP-allowlist, вход открывают по заголовку X-Partner-Key, а лимиты задают через X-Partner-Customer-Id. Настраивается это переменными PARTNER_KEYS, PARTNER_SCOPES и PARTNER_LIMITS. Это уже про серверную часть, а не про подключение из редактора.
Какие задачи решает
- подключить к агенту каталог товаров Kapruka.com
- оформить заказ в магазине через инструменты MCP
- проверить, что REST API Kapruka отвечает
- посмотреть список зарегистрированных MCP-инструментов
- выдать доступ доверенному партнёру без IP-allowlist
Примеры запросов агенту
- Найди в Kapruka подарок до 5000 рупий и покажи варианты
- Оформи заказ на этот товар с доставкой в Коломбо
- Проверь, какие инструменты Kapruka сейчас подключены
Как установить Kapruka MCP
Командой платформы: удалённый сервер
claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcpКомандой платформы: удалённый сервер
codex mcp add kapruka-mcp --url https://mcp.kapruka.com/mcpФайл настроек
{
"mcpServers": {
"kapruka-mcp": {
"url": "https://mcp.kapruka.com/mcp"
}
}
}Файл настроек
{
"servers": {
"kapruka-mcp": {
"type": "http",
"url": "https://mcp.kapruka.com/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http kapruka-mcp https://mcp.kapruka.com/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Kapruka MCP
Как установить Kapruka MCP в Claude Code?
Одной командой: claude mcp add --transport http kapruka-mcp https://mcp.kapruka.com/mcp.
Что делает Kapruka MCP?
Открывает агенту функции магазина Kapruka.com через REST API: работа с товарами, заказами и другими группами, разложенными по модулям инструментов.
Что нужно, чтобы запустить сервер локально?
Python с виртуальным окружением, установленные зависимости из pip install -e ".[dev]" и файл .env с адресом и ключом Kapruka API. Запуск — python cli.py server.
