Kash Business management

Asistente de gestión de Kash.click. Conecta tu asistente a tu negocio: historial completo de ventas, clientes, pagos, información fiscal, empleados, puntos de venta.

GitHub

Prueba este MCPPatrocinado

Documentación

🧾 Kash MCP Server

Kash MCP Server es el servidor oficial de Model Context Protocol (MCP) para Kash — una plataforma gratuita de POS, facturación, CRM y tienda en línea basada en la nube, confiable para miles de comerciantes desde 2011.

Conecta tu cuenta de Kash a Claude, ChatGPT, n8n o cualquier IA compatible con MCP — y gestiona todo tu negocio mediante conversación natural.

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

✨ Lo que puedes hacer

Solo habla. 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"

🚀 Características

🔐 Cuenta y autenticación — sin configuración requerida

Crea una nueva cuenta de Kash directamente desde la conversación
Lista las cuentas vinculadas a un correo electrónico para comprobar si ya existe una
Inicia sesión mediante OTP — se envía una contraseña de un solo uso a tu correo, sin necesidad de contraseña
Cierra sesión para borrar la sesión en cualquier momento

🧾 Ventas y pedidos

Registra ventas con artículos del catálogo, líneas de departamento o líneas libres
Edita pedidos — añade artículos, asigna un cliente, registra pagos, valida como factura
Lista pedidos por rango de fechas, validados o no validados, filtrados por método de entrega
Obtén detalles del pedido — desglose completo de artículos, cliente, pagos y totales

📊 Informes

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

📦 Gestión de 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 tu 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, datos de empresa, número de IVA, código de barras, datos de fidelidad, notas privadas, estado de lista negra...

📋 Datos y listas

Recupera cualquier dato de referencia de tu tienda:

Herramienta	Datos
`data.list.products`	Artículos / artículos
`data.list.departments`	Departamentos / categorías
`data_list_department_groups`	Grupos de departamentos
`data_list_vats`	Tipos de IVA
`data_list_clients`	Clientes
`data_list_variations`	Tipos de variación
`data_list_payments`	Métodos de pago
`data_list_cashboxes`	Cajas registradoras
`data_list_delivery_men`	Métodos de entrega
`data_list_delivery_zones`	Zonas de entrega
`data_list_relay_points`	Puntos de relevo / recogida
`data_list_discounts`	Descuentos y suplementos
`data.list.users`	Personal / usuarios
`data_list_tables`	Mesas (modo restaurante)
`data.list.orders`	Pedidos por rango de fechas

🛠 Herramientas disponibles (46)

Categoría	Herramientas
Cuenta	`account.list`, `account.create`
Autenticación	`auth.request.otp`, `auth.login.with_otp`, `auth.logout`
Ventas	`order.create`, `order.edit`, `order.detail`, `data.list.orders`, `data.list.pending_orders`
Informes	`report.get`
Artículos	`plu_add`, `plu_edit`, `plu_delete`, `data.list.products`
Departamentos	`dept_add`, `dept_edit`, `dept_delete`, `data.list.departments`
Grupos de departamentos	`dept_group_add`, `dept_group_edit`, `dept_group_delete`, `data_list_department_groups`
IVA	`vat_add`, `vat_edit`, `vat_delete`, `data_list_vats`
Variaciones	`variation_add`, `variation_edit`, `variation_delete`, `data_list_variations`
Opciones de variación	`variation_choice_add`, `variation_choice_edit`, `variation_choice_delete`
Clientes	`client_add`, `client_edit`, `client_delete`, `data_list_clients`
Datos	`data_list_payments`, `data_list_cashboxes`, `data_list_delivery_men`, `data_list_delivery_zones`, `data_list_relay_points`, `data_list_discounts`, `data.list.users`, `data_list_tables`
Utilidad	`ping`

⚙️ Requisitos previos

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

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

¿Ya tienes una? Recupera tu APIKEY y SHOPID en el software en Configuración → Servicios web o conéctate usando oAuth.

🔌 Opción 1 — Servidor alojado (recomendado)

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

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

Claude.ai

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

Campo	Valor
Nombre	`Kash`
URL del servidor MCP	`https://mcp.kash.click/mcp`
Autenticación	`OAuth`

ChatGPT

En Configuración → Conectores → Crear conector:

Campo	Valor
Nombre	`Kash POS`
URL del servidor MCP	`https://mcp.kash.click/mcp`
Autenticación	`OAuth`

Smithery

Disponible en smithery.ai — busca Kash.

💻 Opción 2 — Autoalojado (STDIO)

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

Inicio rápido con npx

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

Configuración de Claude Desktop

Edita 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. Usa Docker Compose:

docker compose up

O ejecuta 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 te conectas a través de Claude.ai, ChatGPT o Smithery.

Autenticación en la conversación (OTP)

También puedes autenticarte directamente en 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 tienes una cuenta:

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

STDIO / autoalojado

Pasa las credenciales mediante argumentos de CLI o variables de entorno — SHOPID y APIKEY.

📡 Endpoints de API

Endpoint	Descripción
`POST https://mcp.kash.click/mcp`	Endpoint JSON-RPC de MCP
`GET https://mcp.kash.click/health`	Comprobación de salud → `{ "status": "ok" }`
`GET https://mcp.kash.click/.well-known/mcp/manifest.json`	Manifiesto MCP (lista de herramientas)
`GET https://mcp.kash.click/.well-known/openid-configuration`	Descubrimiento OAuth

🌍 Internacionalización

Los títulos y descripciones de las herramientas están disponibles en inglés y francés, resueltos automáticamente desde el encabezado 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 quieres probar la herramienta sin crear una cuenta, puedes usar las siguientes credenciales

Usuario: Demo15 Contraseña: demodemo

💻 Clientes compatibles

Cliente	Modo
Claude.ai	HTTP / OAuth
Claude Desktop	STDIO
ChatGPT	HTTP / OAuth
n8n	HTTP
Flowise / LangChain	HTTP
Smithery	HTTP / OAuth
Cualquier cliente MCP	STDIO o HTTP

🏪 Tipos de negocio compatibles

Al crear una cuenta con account.create, usa configType para precargar un conjunto de datos adaptado a tu 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 API: kash.click/cash-register-software/mcp
🆓 Regístrate gratis: kash.click/free-pos-software