Caisse Enregistreuse MCP Server

🚀 🧾 Kash MCP Server

Kash MCP Serverは、MCP (Model Context Protocol) に準拠したサーバーです。ChatGPT、Claude、その他のMCP互換クライアントが販売記録システム（またはPOS、レジ）に接続できるようにします。

このサーバーは、以下のようなシンプルなインターフェースを提供します。

• 📊 売上と収益を表示する
• 🧾 レシートを作成および記録する
• 🛒 商品と在庫を管理する
• 🧠 会話形式のリクエストによって自動レポートを生成する

🟢 ライブサーバー: https://mcp.kash.click

レジをChatGPT、Claude、またはn8nに接続し、会話するだけでビジネスを管理しましょう。

レジがあなたの文章を理解し、コマンドを実行し、レポートを分析するというシナリオを想像してみてください。クリックすることなく、このインテリジェントなゲートウェイにより、free-cash-register.netソフトウェアがChatGPT、Claude、およびn8nと互換性を持ち、あなたの対話が具体的なアクションに変わります。 「4番のテーブルにコーヒー2杯の注文を記録して」や「125番の注文の請求書を表示して」と言うだけで、すぐに実行されます。

また、「今週の収益はいくらか」や「火曜日の最も良い顧客は誰か」と尋ねることもできます。あなたの好きなアシスタントが直接レジと通信し、即座に応答します。これは、ビジネスを運営する新しい方法です。よりスムーズで、速く、非常に自然です。あなたの声がインターフェースになり、あなたのアシスタントが新しい同僚になります。

このプロジェクトは、kash.click APIをModel Context Protocol (MCP) ツールとして公開しており、HTTP (Streamable) および/またはSTDIOを介して利用可能です。

✨ 主な機能

• 販売: カタログと自由行をサポートする sale_create
• 注文: 指定された日付範囲内の注文リストを取得する
• データ (リスト): 商品、部門、部門グループ、顧客、バリエーション、配達、支払方法、レジ、配達ゾーン、中継地点、割引、ユーザーなど

💻 使用例

基本的な使用法

以下は、ChatGPTやClaudeなどのMCP互換クライアントで利用できるコマンドの例です。

- 💬 “今日の売上を表示して”
- 💬 “84番のテーブルにコーヒー2杯とクロワッサン1個の販売を記録して”
- 💬 “午後6時15分にデュポン夫人に赤いバラ10本を配達する注文を記録して”
- 💬 “今週のレジレポートを生成して”
- 💬 “今年の持ち帰り販売は増えていますか？”
- 💬 “注文125の請求書を表示して”
- 💬 “今週の収益はいくらですか？”
- 💬 “火曜日の最も良い顧客は誰ですか？”

📦 インストール

Claude

最小限のインストール

Claude Desktopの設定ディレクトリ内の claude_desktop_config.json ファイルを編集します。

Windows

%APPDATA%\Claude\claude_desktop_config.json

Mac OS

~/Library/Application Support/Claude/claude_desktop_config.json

SHOPIDとAPIKEYを置き換えた後、以下の内容を記述します。

{
  "mcpServers": {
    "caisse": {
      "command": "npx",
      "args": [
        "caisse-enregistreuse-mcp-server",
        "--shopid=[replaceWithYourSHOPID]",
        "--apikey=[replaceWithYourAPIKEY]"
      ]
    }
  }
}

npxを介したインストール

インストールフォルダを作成し、シェルで以下のコマンドを実行します。

npx caisse-enregistreuse-mcp-server --shopid=12345 --apikey=abcdef123456

npmを介したインストール

# 1) 依存関係のインストール
npm install

# 2) 環境変数の設定 (以下を参照)

# 3) ビルド
npm run build

設定

バイナリ/ランナーは src/stdio.ts を起動し、MCP stdin/stdoutを介して通信します。Claude Desktopの設定ディレクトリ内の claude_desktop_config.json ファイルを編集し、インストールパスをカスタマイズし、SHOPIDとAPIKEYを設定します（https://kash.click から取得）。

{
  "mcpServers": {
    "caisse": {
      "command": "node",
      "args": [
        "{{PATH_TO_SRC}}/build/stdio.js"
      ],
      "cwd": "{{PATH_TO_SRC}}",
      "env": {
        "SHOPID": "16",
        "APIKEY": "XXXXXXXX"
      }
    }
  }
}

ChatGPT

ワークスペースアカウントが必要です。

設定 → コネクタ → コネクタの作成 で、以下の内容を入力します。

追加すると、コネクタは新しい会話で利用可能になります。

環境変数

.env ファイルを作成します。

APIKEY=XXXXXXXXXXXXXX
SHOPID=XXX

▶️ 起動

HTTPモード (Streamable MCP)

HTTPモードでは、Redisサーバーが必要です。https://mcp.kash.click で利用可能なホスト型MCP HTTP/WebSocketサーバーの使用をお勧めします。

• POST https://mcp.kash.click/mcp (JSON-RPC MCPメッセージを送信)
• GET https://mcp.kash.click/health → { "status": "ok" }
• GET https://mcp.kash.click/.well-known/mcp/manifest.json → MCPマニフェスト

🔧 技術詳細

利用可能なMCPツール (抜粋)

sale_create

販売を作成します。

入力 (Zodスキーマ、主要なフィールド):

• shopId: string, apiKey: string
• payment: number
• deliveryMethod: 0|1|2|3|4|5|6
• idUser?: number | string
• idClient?: number | string
• idtable?: number | string
• idcaisse?: number | string
• numcouverts?: number | string
• publicComment?: string
• privateComment?: string
• pagerNum?: number | string
• client?: {{ firstname?, lastname?, email?, phone?, address?, zip?, city?, country? }}
• `items: Array< {{ type:'catalog', productId?, quantity?, titleOverride?, priceOverride?, declinaisons? }} | {{ type:'dept', departmentId?, price?, title? }} | {{ type:'free', price?, title? }}

  `

レガシーアイテムエンコーディング:

• カタログ: productId_quantity_titleOverride_priceOverride_[...declinaisons]
• 部門販売: -<departmentId>_<price>_<title>
• 自由行: Free_<price>_<title> → itemsList[] として送信されます。

data_list_* (例)

• data_list_products
• data_list_departments
• data_list_department_groups
• data_list_clients
• data_list_variations
• data_list_delivery_men
• data_list_payments
• data_list_cashboxes
• data_list_delivery_zones
• data_list_relay_points
• data_list_discounts
• data_list_users
• data_list_tables

すべてのツールは {{ format=('json'|'csv'|'html') }} を受け付けます。

📄 ライセンス

© 2025. GNU GENERAL PUBLIC LICENSE