🧾 Kash MCP Server

Kash MCP Server — это официальный сервер Model Context Protocol (MCP) для Kash — бесплатной облачной платформы для POS, выставления счетов, CRM и интернет-магазинов, которой доверяют тысячи продавцов с 2011 года.

Подключите свою учетную запись Kash к Claude, ChatGPT, n8n или любому другому ИИ, совместимому с MCP, и управляйте всем своим бизнесом с помощью естественного общения.

🟢 Хостинг-сервер: https://mcp.kash.click
📖 Полная документация: kash.click/cash-register-software

✨ Что вы можете делать

Просто общайтесь. Никаких меню, никаких кликов.

"Record a sale of 2 coffees and 1 croissant at table 84"
"Show me this week's revenue report"
"Add a new item called Summer Tart at €4.50 in the Pastries department"
"Who are my best customers this month?"
"Create a Kash account for my restaurant"
"Record the card payment for order #1042"
"Add a Large size option to the Size variation"

Related MCP server: Itcons.app MCP Server

🚀 Функции

🔐 Учетная запись и аутентификация — настройка не требуется

• Создание новой учетной записи Kash прямо из диалога

• Список учетных записей, привязанных к электронной почте, чтобы проверить, существует ли уже одна из них

• Вход через OTP — одноразовый пароль отправляется на вашу электронную почту, пароль не требуется

• Выход для завершения сеанса в любое время

🧾 Продажи и заказы

• Регистрация продаж с элементами каталога, позициями отделов или свободными позициями

• Редактирование заказов — добавление товаров, назначение клиента, регистрация платежей, подтверждение в качестве счета

• Список заказов по диапазону дат, подтвержденных или неподтвержденных, с фильтрацией по способу доставки

• Получение деталей заказа — полная разбивка по товарам, клиенту, платежам и итогам

📊 Отчеты

• Отчет о продажах — сводка в формате HTML за любой период: конкретный день, месяц или полный год (по умолчанию за вчера)

📦 Управление каталогом

• Товары (PLU): добавление, редактирование, удаление — с ценой, отделом, НДС, штрих-кодом, запасами, вариациями...

• Отделы: добавление, редактирование, удаление — с НДС, ценой, группой, вариациями...

• Группы отделов: добавление, редактирование, удаление — для организации вашего каталога

• Ставки НДС: добавление, редактирование, удаление

• Вариации: добавление, редактирование, удаление (например, "Размер", "Цвет")

• Выбор вариаций: добавление, редактирование, удаление (например, "S", "M", "L" для "Размера") с опциональной дельтой цены

👥 Управление клиентами (CRM)

• Добавление, редактирование, удаление клиентов с полной контактной информацией, данными компании, номером НДС, штрих-кодом, данными лояльности, личными заметками, статусом черного списка...

📋 Данные и списки

Получайте любые справочные данные из вашего магазина:

🛠 Доступные инструменты (46)

⚙️ Предварительные требования

Вам нужна учетная запись Kash / free-cash-register.net.

Нет учетной записи? Вы можете создать ее прямо из диалога, используя account.create, или зарегистрироваться на kash.click/free-pos-software.

Уже есть? Получите свой APIKEY и SHOPID в программе в разделе Настройка → Веб-сервисы или подключитесь через oAuth.

🔌 Вариант 1 — Хостинг-сервер (рекомендуется)

Самый простой способ: подключиться напрямую к хостинг-серверу MCP по адресу https://mcp.kash.click/mcp.

Установка не требуется. Аутентификация осуществляется через OAuth 2.0 с PKCE.

Claude.ai

В разделе Настройки → Интеграции добавьте новый коннектор:

ChatGPT

В разделе Настройки → Коннекторы → Создать коннектор:

Smithery

Доступно на smithery.ai — выполните поиск по запросу Kash.

💻 Вариант 2 — Самостоятельный хостинг (STDIO)

Запустите сервер локально для Claude Desktop или любого клиента MCP на базе STDIO.

Быстрый старт через npx

npx caisse-enregistreuse-mcp-server --shopid=YOUR_SHOPID --apikey=YOUR_APIKEY

Конфигурация Claude Desktop

Отредактируйте claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kash": {
      "command": "npx",
      "args": [
        "caisse-enregistreuse-mcp-server",
        "--shopid=YOUR_SHOPID",
        "--apikey=YOUR_APIKEY"
      ]
    }
  }
}

Или используя переменные окружения:

{
  "mcpServers": {
    "kash": {
      "command": "node",
      "args": ["PATH_TO_BUILD/build/stdio.js"],
      "cwd": "PATH_TO_BUILD",
      "env": {
        "SHOPID": "YOUR_SHOPID",
        "APIKEY": "YOUR_APIKEY"
      }
    }
  }
}

Установка из исходного кода

# 1) Clone
git clone https://github.com/paracetamol951/caisse-enregistreuse-mcp-server.git
cd caisse-enregistreuse-mcp-server

# 2) Install dependencies
npm install

# 3) Create .env
echo "SHOPID=YOUR_SHOPID" > .env
echo "APIKEY=YOUR_APIKEY" >> .env

# 4) Build
npm run build

# 5) Run
node build/stdio.js

Docker (режим HTTP)

Режим HTTP требует Redis. Используйте Docker Compose:

docker compose up

Или запустите вручную:

docker run -d -p 6379:6379 redis
npm run dev

🔐 Процесс аутентификации

Хостинг-сервер (OAuth)

Аутентификация выполняется автоматически через поток OAuth 2.0 + PKCE при подключении через Claude.ai, ChatGPT или Smithery.

Аутентификация в диалоге (OTP)

Вы также можете пройти аутентификацию прямо в диалоге — пароль не требуется:

1. auth.request.otp(email)         → OTP sent to your inbox
2. auth.login.with_otp(email, otp) → session initialized ✓
3. auth.logout()                   → clear session when done

Если у вас еще нет учетной записи:

1. account.list(email)             → check existing accounts
2. account.create(email, title)    → create + session auto-initialized ✓

STDIO / самостоятельный хостинг

Передайте учетные данные через аргументы CLI или переменные окружения — SHOPID и APIKEY.

📡 API-эндпоинты

🌍 Интернационализация

Названия и описания инструментов доступны на английском и французском языках, определяемых автоматически на основе заголовка Accept-Language или переменной окружения MCP_LANG.

Файлы локализации: locales/en/common.json, locales/fr/common.json

Демонстрационные учетные данные

Если вы хотите попробовать инструмент без создания учетной записи, вы можете использовать следующие данные:

Логин: Demo15 Пароль: demodemo

💻 Совместимые клиенты

🏪 Поддерживаемые типы бизнеса

При создании учетной записи с помощью account.create используйте configType для предварительной загрузки набора данных, адаптированного для вашего бизнеса:

Bar · Bakery · Restaurant · Fast-food · Cafe · Coffee-shop · Pizzeria · Brewery · Food-truck · Snack · Florist · Retail · Pharmacy · Supermarket · Clothing-store · Ecommerce · Services · Beauty-institute · Coiffeur · Market · Library · Camping · и другие...

🔗 Ссылки

• 🌐 Веб-сайт: kash.click

• 📖 Документация: kash.click/cash-register-software

• 🔧 Справочник API: kash.click/cash-register-software/mcp

• 🆓 Зарегистрироваться бесплатно: kash.click/free-pos-software

📋 Лицензия

© 2025 Net-assembly. GNU General Public License v3.0