🧾 Kash MCP 服务器

Kash MCP 服务器 是官方的 Model Context Protocol (MCP) 服务器，用于 Kash —— 这是一个自 2011 年以来深受数千名商家信赖的免费云端 POS、发票、CRM 和网店平台。

将您的 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"

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 注册。

已有账户？ 在软件的 设置 → Web 服务 中检索您的 APIKEY 和 SHOPID，或使用 oAuth 连接。

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

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

无需安装。认证通过带有 PKCE 的 OAuth 2.0 处理。

Claude.ai

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

ChatGPT

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

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 端点

🌍 国际化

工具标题和描述提供 英语 和 法语 版本，根据 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