🧾 Servidor MCP Kash

El servidor MCP de Kash es el servidor oficial del Protocolo de Contexto de Modelo (MCP) para Kash: una plataforma gratuita de TPV, facturación, CRM y tienda web en la nube en la que confían miles de comerciantes desde 2011.

Conecte su cuenta de Kash a Claude, ChatGPT, n8n o cualquier IA compatible con MCP, y gestione todo su negocio mediante una conversación natural.

🟢 Servidor alojado: https://mcp.kash.click 📖 Documentación completa: kash.click/cash-register-software

✨ Lo que puede hacer

Simplemente hable. Sin menús, sin clics.

"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

🚀 Características

🔐 Cuenta y autenticación: no requiere configuración

• Crear una nueva cuenta de Kash directamente desde la conversación

• Listar las cuentas vinculadas a un correo electrónico para comprobar si ya existe alguna

• Iniciar sesión mediante OTP: se envía una contraseña de un solo uso a su correo electrónico, no se necesita contraseña

• Cerrar sesión para borrar la sesión en cualquier momento

🧾 Ventas y pedidos

• Registrar ventas con artículos del catálogo, líneas de departamento o líneas libres

• Editar pedidos: añadir artículos, asignar un cliente, registrar pagos, validar como factura

• Listar pedidos por rango de fechas, validados o no validados, filtrados por método de entrega

• Obtener detalles del pedido: desglose completo de artículos, cliente, pagos y totales

📊 Informes

• Informe de ventas: resumen en HTML para cualquier período: un día específico, un mes o un año completo (por defecto es el día de ayer)

📦 Gestión del catálogo

• Artículos (PLU): añadir, editar, eliminar, con precio, departamento, IVA, código de barras, stock, variaciones...

• Departamentos: añadir, editar, eliminar, con IVA, precio, grupo, variaciones...

• Grupos de departamentos: añadir, editar, eliminar, para organizar su catálogo

• Tipos de IVA: añadir, editar, eliminar

• Variaciones: añadir, editar, eliminar (p. ej., "Talla", "Color")

• Opciones de variación: añadir, editar, eliminar (p. ej., "S", "M", "L" para "Talla") con delta de precio opcional

👥 Gestión de clientes (CRM)

• Añadir, editar, eliminar clientes con información de contacto completa, detalles de la empresa, número de IVA, código de barras, datos de fidelidad, notas privadas, estado de lista negra...

📋 Datos y listas

Recupere cualquier dato de referencia de su tienda:

🛠 Herramientas disponibles (46)

⚙️ Requisitos previos

Necesita una cuenta de Kash / free-cash-register.net.

¿No tiene una? Puede crearla directamente desde la conversación usando account.create, o registrarse en kash.click/free-pos-software.

¿Ya tiene una? Recupere su APIKEY y SHOPID en el software en Configuración → Webservices o conéctese usando oAuth.

🔌 Opción 1: Servidor alojado (recomendado)

La forma más fácil: conéctese directamente al servidor MCP alojado en https://mcp.kash.click/mcp.

No requiere instalación. La autenticación se gestiona mediante OAuth 2.0 con PKCE.

Claude.ai

En Configuración → Integraciones, añada un nuevo conector:

ChatGPT

En Configuración → Conectores → Crear conector:

Smithery

Disponible en smithery.ai: busque Kash.

💻 Opción 2: Autoalojado (STDIO)

Ejecute el servidor localmente para Claude Desktop o cualquier cliente MCP basado en STDIO.

Inicio rápido mediante npx

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

Configuración de Claude Desktop

Edite 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"
      ]
    }
  }
}

O usando variables de entorno:

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

Instalar desde el código fuente

# 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 (modo HTTP)

El modo HTTP requiere Redis. Use Docker Compose:

docker compose up

O ejecútelo manualmente:

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

🔐 Flujo de autenticación

Servidor alojado (OAuth)

La autenticación se gestiona automáticamente mediante el flujo OAuth 2.0 + PKCE cuando se conecta a través de Claude.ai, ChatGPT o Smithery.

Autenticación en la conversación (OTP)

También puede autenticarse directamente dentro de la conversación, sin necesidad de contraseña:

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

Si aún no tiene una cuenta:

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

STDIO / autoalojado

Introduzca las credenciales mediante argumentos de CLI o variables de entorno: SHOPID y APIKEY.

📡 Puntos finales de la API

🌍 Internacionalización

Los títulos y descripciones de las herramientas están disponibles en inglés y francés, resueltos automáticamente a partir de la cabecera Accept-Language o la variable de entorno MCP_LANG.

Archivos de idioma: locales/en/common.json, locales/fr/common.json

Credenciales de demostración

Si desea probar la herramienta sin crear una cuenta, puede usar las siguientes credenciales

Usuario: Demo15 Contraseña: demodemo

💻 Clientes compatibles

🏪 Tipos de negocio admitidos

Al crear una cuenta con account.create, use configType para precargar un conjunto de datos adaptado a su negocio:

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 · y más...

🔗 Enlaces

• 🌐 Sitio web: kash.click

• 📖 Documentación: kash.click/cash-register-software

• 🔧 Referencia de la API: kash.click/cash-register-software/mcp

• 🆓 Registrarse gratis: kash.click/free-pos-software

📋 Licencia

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