Kash Business management assistant

🧾 Kash MCP サーバー

Kash MCP Server は、Kash の公式 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"

---

🚀 機能

🔐 アカウントと認証 — 設定不要

• 会話から直接、新しい 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	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 から登録できます。

すでにアカウントをお持ちの場合、ソフトウェアの Setup → Webservices から APIKEY と SHOPID を取得するか、oAuth で接続してください。

---

🔌 オプション 1 — ホスト型サーバー（推奨）

最も簡単な方法は、ホスト型 MCP サーバー https://mcp.kash.click/mcp に直接接続することです。

インストールは不要です。認証は OAuth 2.0 と PKCE で処理されます。

Claude.ai

Settings → Integrations で、新しいコネクターを追加します。

フィールド	値
名前	Kash
MCP サーバー URL	https://mcp.kash.click/mcp
認証	OAuth

ChatGPT

Settings → Connectors → Create Connector で設定します。

フィールド	値
名前	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 General Public License v3.0