使用说明

🧾 Kash MCP服务器

Kash MCP服务器 是官方的吗模型上下文协议（MCP）服务器卡什 --一个免费的、基于云的POS、发票、CRM和网店平台，自2011年以来受到数千家商家的信赖。

将您的Kash帐户连接到 克劳德，ChatGPT，n8n，或任何兼容MCP的人工智能，并通过自然对话管理您的整个业务。

🟢 托管服务器： https://mcp.kash.click
📖 完整文档： kash.click/cash-register软件

✨ 你能做什么

只是说话。没有菜单，没有点击。

"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）：添加、编辑、删除——包括价格、部门、增值税、条形码、库存、变化。..
部门：添加、编辑、删除——含增值税、价格、组、变体。..
部门组：添加、编辑、删除--组织目录
增值税税率：添加、编辑、删除
变体：添加、编辑、删除（例如“大小”、“颜色”）
变体选择：添加、编辑、删除（例如“S”、“M”、“L”代表“大小”），并可选择价格增量

👥 客户管理（CRM）

添加、编辑、删除 拥有完整联系信息、公司详细信息、增值税号码、条形码、忠诚度数据、私人笔记、黑名单状态的客户。..

📋 数据和列表

从您的商店检索任何参考数据：

工具	数据
`data.list.products`	项目/文章
`data.list.departments`	部门/类别
`data_list_department_groups`	部门组
`data_list_vats`	增值税税率
`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.lick/free-pos软件.

已经有了？ 取回您的 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`

史密瑟里

可用史密斯艾 --搜索卡什.

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

在本地为Claude Desktop或任何基于STDIO的MCP客户端运行服务器。

通过npx快速启动

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

Claude桌面配置

编辑 claude_desktop_config.json:

视窗: %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

演示凭据

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

💻 兼容客户端

客户端	模式
Claude.ai	HTTP/OAuth
克劳德桌面	STDIO
ChatGPT	HTTP/OAuth
n8n	HTTP
流/语言链	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软件
🔧 API 参考: kash.click/cash调节器软件/mcp
🆓 免费注册: kash.lick/free-pos软件

POS对话管理系统

使用说明

🧾 Kash MCP服务器

✨ 你能做什么

🚀 特性

🔐 帐户和身份验证--无需配置

🧾 销售与订单

📊 报告

📦 目录管理

👥 客户管理（CRM）

📋 数据和列表

🛠 可用工具（46）

⚙️ 先决条件

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

Claude.ai

ChatGPT

史密瑟里

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

通过npx快速启动

Claude桌面配置

从源代码安装

Docker（HTTP模式）

🔐 身份验证流程

托管服务器（OAuth）

对话中身份验证（OTP）

STDIO/自托管

📡 API端点

🌍 国际化

演示凭据

💻 兼容客户端

🏪 支持的业务类型

🔗 链接

📋 许可证

使用说明

🧾 Kash MCP服务器

✨ 你能做什么

🚀 特性

🔐 帐户和身份验证--无需配置

🧾 销售与订单

📊 报告

📦 目录管理

👥 客户管理（CRM）

📋 数据和列表

🛠 可用工具（46）

⚙️ 先决条件

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

Claude.ai

ChatGPT

史密瑟里

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

通过npx快速启动

Claude桌面配置

从源代码安装

Docker（HTTP模式）

🔐 身份验证流程

托管服务器（OAuth）

对话中身份验证（OTP）

STDIO/自托管

📡 API端点

🌍 国际化

演示凭据

💻 兼容客户端

🏪 支持的业务类型

🔗 链接

📋 许可证

相关 MCP

3D Slicer模型协议集成工具

博物馆艺术收藏搜索服务

Unity MCP 桥接服务

Cloudflare MCP 服务器

GCP资源管理工具

Photoshop MCP 图像编辑服务