kaspi-merchant-mcp

Первый MCP-сервер для Kaspi Marketplace в мире. 721 000 продавцов в Казахстане теперь могут управлять заказами через AI-ассистентов.

Kaspi.kz — крупнейший маркетплейс Казахстана. API работает по спецификации JSON:API (Content-Type: application/vnd.api+json).

[!WARNING] Sandbox отсутствует — все операции выполняются на реальных данных продакшна.

Операции accept_order, complete_order, cancel_order необратимы!

Инструменты (8 штук)

Инструмент	Метод	Описание
`get_orders`	GET	Список заказов с фильтрацией по статусу и дате
`get_order`	GET	Один заказ по ID
`get_order_items`	GET	Позиции заказа (товары, кол-во, цена)
`accept_order`	PATCH	Принять заказ (ACCEPTED_BY_MERCHANT)
`complete_order`	PATCH	Завершить заказ (COMPLETED)
`cancel_order`	PATCH	Отменить заказ (CANCELLED)
`get_cities`	GET	Список городов Kaspi
`get_products`	GET	Товарные предложения продавца

Статусы заказов

Статус	Описание
`NEW`	Новый заказ, ожидает обработки
`SIGN_REQUIRED`	Требуется подпись (для крупных покупок)
`PICKUP`	Готов к выдаче
`DELIVERY`	В доставке (курьерская)
`KASPI_DELIVERY`	В доставке через Kaspi Доставку
`ARCHIVE`	Архив (завершённые/отменённые)

Быстрый старт

1. Получите API-токен

Откройте Kaspi Seller Cabinet → Настройки → API → Скопируйте токен.

2. Настройте MCP-сервер

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "kaspi": {
      "command": "npx",
      "args": ["-y", "@theyahia/kaspi-merchant-mcp"],
      "env": {
        "KASPI_AUTH_TOKEN": "ваш-токен"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add kaspi -- npx -y @theyahia/kaspi-merchant-mcp
# Установите переменную окружения:
export KASPI_AUTH_TOKEN="ваш-токен"

VS Code (Copilot)

.vscode/mcp.json:

{
  "servers": {
    "kaspi": {
      "command": "npx",
      "args": ["-y", "@theyahia/kaspi-merchant-mcp"],
      "env": {
        "KASPI_AUTH_TOKEN": "ваш-токен"
      }
    }
  }
}

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "kaspi": {
      "command": "npx",
      "args": ["-y", "@theyahia/kaspi-merchant-mcp"],
      "env": {
        "KASPI_AUTH_TOKEN": "ваш-токен"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kaspi": {
      "command": "npx",
      "args": ["-y", "@theyahia/kaspi-merchant-mcp"],
      "env": {
        "KASPI_AUTH_TOKEN": "ваш-токен"
      }
    }
  }
}

Примеры запросов

"Покажи новые заказы за сегодня"
"Прими заказ 12345678"
"Какие заказы ожидают отправки?"
"Покажи детали заказа ABC-123"
"Отмени заказ XYZ, причина: нет в наличии"
"Список городов Kaspi"

Разработка

git clone https://github.com/theYahia/kaspi-merchant-mcp.git
cd kaspi-merchant-mcp
npm install
npm run build
npm test

Ссылки

Kaspi Seller API документация
JSON:API спецификация
Часть серии russian-mcp — MCP-серверы для СНГ-рынка

Лицензия

MIT

@theyahia/kaspi-merchant-mcp

Quick Install