Kash Business management assistant

🧾 Kash MCP 服务

Kash MCP 服务是面向 Kash 的官方 模型上下文协议（MCP） 服务。Kash 是一个免费的云端 POS、开票、CRM 和网店平台，自 2011 年以来深受数千家商户信赖。

将你的 Kash 账户连接到 Claude、ChatGPT、n8n 或任何兼容 MCP 的 AI，即可通过自然对话管理整个业务。

🟢 托管服务：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"

---

🚀 功能

🔐 账户与身份验证 — 无需配置

• 直接通过对话创建新的 Kash 账户
• 列出关联到某个邮箱的账户，检查账户是否已存在
• 通过 OTP 登录——一次性密码将发送到你的邮箱，无需密码
• 随时登出以清除会话

🧾 销售与订单

• 使用目录商品、部门商品行或自由商品行记录销售
• 编辑订单——添加商品、指定客户、记录付款，并验证为发票
• 按日期范围列出订单，可按已验证或未验证筛选，也可按配送方式筛选
• 获取订单详情——完整显示商品、客户、付款和总额明细

📊 报表

• 销售报表——任意时间段的 HTML 摘要：指定日期、月份或全年（默认为昨天）

📦 目录管理

• 商品（PLU）：添加、编辑、删除——可设置价格、部门、VAT、条码、库存、规格……
• 部门：添加、编辑、删除——可设置 VAT、价格、分组、规格……
• 部门分组：添加、编辑、删除——用于整理目录
• VAT 税率：添加、编辑、删除
• 规格：添加、编辑、删除（例如“尺寸”“颜色”）
• 规格选项：添加、编辑、删除（例如“尺寸”的“S”“M”“L”），可选设置价格差额

👥 客户管理（CRM）

• 添加、编辑、删除客户，并管理完整联系信息、公司详情、VAT 编号、条码、忠诚度数据、私人备注、黑名单状态……

📋 数据与列表

检索商店中的任意参考数据：

工具	数据
data.list.products	商品 / 货品
data.list.departments	部门 / 类别
data_list_department_groups	部门分组
data_list_vats	VAT 税率
data_list_clients	客户
data_list_variations	规格类型
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	桌台（餐厅模式）
data.list.orders	按日期范围筛选的订单

---

🛠 可用工具（46）

类别	工具
账户	account.list, account.create
身份验证	auth.request.otp, auth.login.with_otp, auth.logout
销售	order.create, order.edit, order.detail, data.list.orders, data.list.pending_orders
报表	report.get
商品	plu_add, plu_edit, plu_delete, data.list.products
部门	dept_add, dept_edit, dept_delete, data.list.departments
部门组	dept_group_add, dept_group_edit, dept_group_delete, data_list_department_groups
增值税	vat_add, vat_edit, vat_delete, data_list_vats
变体	variation_add, variation_edit, variation_delete, data_list_variations
变体选项	variation_choice_add, variation_choice_edit, variation_choice_delete
客户	client_add, client_edit, client_delete, data_list_clients
数据	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
实用工具	ping

---

⚙️ 前提条件

你需要一个 Kash / free-cash-register.net 账户。

还没有账户？ 你可以在对话中直接使用 account.create 创建账户，或前往 kash.click/free-pos-software 注册。

已经有账户？ 在软件的 设置 → Webservices 中获取你的 APIKEY 和 SHOPID，或使用 oAuth 连接。

---

🔌 选项 1 — 托管服务（推荐）

最简单的方式：直接连接到托管的 MCP 服务 https://mcp.kash.click/mcp。

无需安装。身份验证通过 OAuth 2.0 + PKCE 自动处理。

Claude.ai

在 设置 → 集成 中添加新的连接器：

字段	值
名称	Kash
MCP 服务 URL	https://mcp.kash.click/mcp
身份验证	OAuth

ChatGPT

在 设置 → 连接器 → 创建连接器 中：

字段	值
名称	Kash POS
MCP 服务 URL	https://mcp.kash.click/mcp
身份验证	OAuth

Smithery

可在 smithery.ai 获取 — 搜索 Kash。

---

💻 选项 2 — 可自托管（STDIO）

在本地运行服务，供 Claude Desktop 或任何基于 STDIO 的 MCP 客户端使用。

通过 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）

通过 Claude.ai、ChatGPT 或 Smithery 连接时，OAuth 2.0 + PKCE 流程会自动处理身份验证。

在对话中进行身份验证（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 端点

端点	说明
POST https://mcp.kash.click/mcp	MCP JSON-RPC 端点
GET https://mcp.kash.click/health	健康检查 → { "status": "ok" }
GET https://mcp.kash.click/.well-known/mcp/manifest.json	MCP 清单（工具列表）
GET https://mcp.kash.click/.well-known/openid-configuration	OAuth 发现

---

🌍 国际化

工具标题和说明提供英语和法语版本，并根据 Accept-Language 标头或 MCP_LANG 环境变量自动选择。

区域设置文件：locales/en/common.json、locales/fr/common.json

---

演示凭据

如果您想在不创建账户的情况下试用该工具，可以使用以下凭据

登录名：Demo15 密码：demodemo

---

💻 兼容的客户端

客户端	模式
Claude.ai	HTTP / OAuth
Claude Desktop	STDIO
ChatGPT	HTTP / OAuth
n8n	HTTP
Flowise / LangChain	HTTP
Smithery	HTTP / OAuth
任意 MCP 客户端	STDIO 或 HTTP

---

🏪 支持的业务类型

使用 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 通用公共许可证 v3.0