🧾 Kash MCP Server

Kash MCP Serverは、2011年以来数千人の加盟店に信頼されている無料のクラウドベースPOS、請求書発行、CRM、およびウェブショッププラットフォームである**Kash**の公式Model Context Protocol (MCP)サーバーです。

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経由でログイン: ワンタイムパスワードがメールに送信されるため、パスワードは不要

• ログアウト: いつでもセッションをクリア

🧾 販売と注文

• 販売記録: カタログアイテム、部門行、または自由入力行を使用して販売を記録

• 注文編集: アイテムの追加、クライアントの割り当て、支払いの記録、請求書としての検証

• 注文一覧: 日付範囲、検証済み/未検証、配送方法によるフィルタリングで注文を一覧表示

• 注文詳細取得: アイテム、クライアント、支払い、合計の内訳を詳細に取得

📊 レポート

• 販売レポート: 特定の日、月、または1年全体（デフォルトは昨日）の期間のHTML要約

📦 カタログ管理

• アイテム (PLU): 価格、部門、VAT、バーコード、在庫、バリエーションなどを追加、編集、削除

• 部門: VAT、価格、グループ、バリエーションなどを追加、編集、削除

• 部門グループ: カタログを整理するために追加、編集、削除

• VATレート: 追加、編集、削除

• バリエーション: 追加、編集、削除（例：「サイズ」、「色」）

• バリエーション選択肢: 追加、編集、削除（例：「サイズ」に対する「S」、「M」、「L」）、価格差分オプション付き

👥 顧客管理 (CRM)

• 顧客の追加、編集、削除: 完全な連絡先情報、会社詳細、VAT番号、バーコード、ロイヤリティデータ、プライベートメモ、ブラックリストステータスなど

📋 データとリスト

ショップから任意の参照データを取得します：

🛠 利用可能なツール (46)

⚙️ 前提条件

Kash / free-cash-register.netアカウントが必要です。

アカウントをお持ちでない場合: account.createを使用して会話から直接作成するか、kash.click/free-pos-softwareで登録してください。

すでにお持ちの場合: ソフトウェアの設定 → WebサービスからAPIKEYとSHOPIDを取得するか、oAuthを使用して接続してください。

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

最も簡単な方法：https://mcp.kash.click/mcpのホスト型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