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