Kaspi Merchant

БесплатноНе проверен

Enables managing Kaspi Marketplace orders through AI assistants, including listing, accepting, completing, and canceling orders, with real-time operations direc

автор: theYahia

GitHub Embed

Описание

Enables managing Kaspi Marketplace orders through AI assistants, including listing, accepting, completing, and canceling orders, with real-time operations directly on production data (no sandbox).

README

Первый 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

from github.com/theYahia/kaspi-merchant-mcp

Установить Kaspi Merchant в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install kaspi-merchant-mcp

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add kaspi-merchant-mcp -- npx -y @theyahia/kaspi-merchant-mcp

FAQ

Kaspi Merchant MCP бесплатный?

Да, Kaspi Merchant MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Kaspi Merchant?

Нет, Kaspi Merchant работает без API-ключей и переменных окружения.

Kaspi Merchant — hosted или self-hosted?

Доступен hosted-вариант: Unyly запускает сервер в облаке, локальная установка не обязательна.

Как установить Kaspi Merchant в Claude Desktop, Claude Code или Cursor?

Открой Kaspi Merchant на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Compare Kaspi Merchant with

Kaspi MerchantvsFetch Kaspi MerchantvsAWS KB Retrieval Kaspi MerchantvsSpring AI MCP Server Kaspi Merchantvsllm-analysis-assistant

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai

Command Palette