🧾 Kash MCP Server

Kash MCP Server ist der offizielle Model Context Protocol (MCP) Server für Kash — eine kostenlose, cloudbasierte POS-, Rechnungsstellungs-, CRM- und Webshop-Plattform, der seit 2011 Tausende von Händlern vertrauen.

Verbinden Sie Ihr Kash-Konto mit Claude, ChatGPT, n8n oder einer anderen MCP-kompatiblen KI — und verwalten Sie Ihr gesamtes Unternehmen durch natürliche Konversation.

🟢 Gehosteter Server: https://mcp.kash.click 📖 Vollständige Dokumentation: kash.click/cash-register-software

✨ Was Sie tun können

Sprechen Sie einfach. Keine Menüs, keine Klicks.

"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

🚀 Funktionen

🔐 Konto & Authentifizierung — keine Konfiguration erforderlich

• Erstellen Sie ein neues Kash-Konto direkt aus der Konversation heraus

• Listen Sie Konten auf, die mit einer E-Mail-Adresse verknüpft sind, um zu prüfen, ob bereits eines existiert

• Login via OTP — ein Einmalpasswort wird an Ihre E-Mail gesendet, kein Passwort erforderlich

• Logout, um die Sitzung jederzeit zu beenden

🧾 Verkäufe & Bestellungen

• Verkäufe erfassen mit Katalogartikeln, Abteilungszeilen oder freien Zeilen

• Bestellungen bearbeiten — Artikel hinzufügen, Kunden zuweisen, Zahlungen erfassen, als Rechnung validieren

• Bestellungen auflisten nach Datumsbereich, validiert oder nicht validiert, gefiltert nach Liefermethode

• Bestelldetails abrufen — vollständige Aufschlüsselung von Artikeln, Kunden, Zahlungen und Summen

📊 Berichte

• Verkaufsbericht — HTML-Zusammenfassung für jeden Zeitraum: ein bestimmter Tag, Monat oder das volle Jahr (Standard ist gestern)

📦 Katalogverwaltung

• Artikel (PLU): hinzufügen, bearbeiten, löschen — mit Preis, Abteilung, MwSt., Barcode, Bestand, Varianten...

• Abteilungen: hinzufügen, bearbeiten, löschen — mit MwSt., Preis, Gruppe, Varianten...

• Abteilungsgruppen: hinzufügen, bearbeiten, löschen — zur Organisation Ihres Katalogs

• MwSt.-Sätze: hinzufügen, bearbeiten, löschen

• Varianten: hinzufügen, bearbeiten, löschen (z. B. "Größe", "Farbe")

• Variantenoptionen: hinzufügen, bearbeiten, löschen (z. B. "S", "M", "L" für "Größe") mit optionalem Preisdelta

👥 Kundenverwaltung (CRM)

• Hinzufügen, bearbeiten, löschen von Kunden mit vollständigen Kontaktdaten, Firmendetails, USt-IdNr., Barcode, Treuedaten, privaten Notizen, Blacklist-Status...

📋 Daten & Listen

Abrufen beliebiger Referenzdaten aus Ihrem Shop:

🛠 Verfügbare Tools (46)

⚙️ Voraussetzungen

Sie benötigen ein Kash / free-cash-register.net Konto.

Haben Sie noch keines? Sie können es direkt aus der Konversation heraus mit account.create erstellen oder sich unter kash.click/free-pos-software registrieren.

Haben Sie bereits eines? Rufen Sie Ihren APIKEY und SHOPID in der Software unter Setup → Webservices ab oder verbinden Sie sich über oAuth.

🔌 Option 1 — Gehosteter Server (empfohlen)

Der einfachste Weg: Verbinden Sie sich direkt mit dem gehosteten MCP-Server unter https://mcp.kash.click/mcp.

Keine Installation erforderlich. Die Authentifizierung erfolgt über OAuth 2.0 mit PKCE.

Claude.ai

Fügen Sie unter Einstellungen → Integrationen einen neuen Connector hinzu:

ChatGPT

Unter Einstellungen → Connectors → Connector erstellen:

Smithery

Verfügbar auf smithery.ai — suchen Sie nach Kash.

💻 Option 2 — Selbst gehostet (STDIO)

Führen Sie den Server lokal für Claude Desktop oder einen beliebigen STDIO-basierten MCP-Client aus.

Schnellstart via npx

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

Claude Desktop Konfiguration

Bearbeiten Sie 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"
      ]
    }
  }
}

Oder unter Verwendung von Umgebungsvariablen:

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

Installation aus dem Quellcode

# 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-Modus)

Der HTTP-Modus erfordert Redis. Verwenden Sie Docker Compose:

docker compose up

Oder manuell ausführen:

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

🔐 Authentifizierungsablauf

Gehosteter Server (OAuth)

Die Authentifizierung wird automatisch durch den OAuth 2.0 + PKCE-Ablauf abgewickelt, wenn Sie sich über Claude.ai, ChatGPT oder Smithery verbinden.

Authentifizierung innerhalb der Konversation (OTP)

Sie können sich auch direkt innerhalb der Konversation authentifizieren — kein Passwort erforderlich:

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

Wenn Sie noch kein Konto haben:

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

STDIO / selbst gehostet

Übergeben Sie Anmeldedaten über CLI-Argumente oder Umgebungsvariablen — SHOPID und APIKEY.

📡 API-Endpunkte

🌍 Internationalisierung

Tool-Titel und Beschreibungen sind auf Englisch und Französisch verfügbar und werden automatisch über den Accept-Language-Header oder die Umgebungsvariable MCP_LANG aufgelöst.

Locale-Dateien: locales/en/common.json, locales/fr/common.json

Demo-Anmeldedaten

Wenn Sie das Tool ausprobieren möchten, ohne ein Konto zu erstellen, können Sie die folgenden Anmeldedaten verwenden

Login: Demo15 Passwort: demodemo

💻 Kompatible Clients

🏪 Unterstützte Unternehmenstypen

Verwenden Sie beim Erstellen eines Kontos mit account.create den Parameter configType, um einen auf Ihr Unternehmen zugeschnittenen Datensatz vorzuladen:

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 · und mehr...

🔗 Links

• 🌐 Website: kash.click

• 📖 Dokumentation: kash.click/cash-register-software

• 🔧 API-Referenz: kash.click/cash-register-software/mcp

• 🆓 Kostenlos registrieren: kash.click/free-pos-software

📋 Lizenz

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