chirak-mcp

Chirak MCP サーバー

AI クライアント（Claude Desktop、Cursor、Windsurf）を Chirak の販売、在庫、注文管理 API に接続する Model Context Protocol（MCP）サーバーです。

概要

Chirak MCP サーバーを使用すると、LLM インターフェースから、標準の Model Context Protocol ツールを介して STDIO 経由で、在庫のリアルタイム照会、販売取引の記録、商品情報の管理、業務分析の照会を実行できます。

前提条件

• Node.js 18.0.0 以降
• Chirak API キー（Chirak iOS/iPadOS アプリケーションの「設定」>「連携と AI」から生成）

インストールと設定

Smithery（自動インストール）

Smithery を使用して Claude Desktop 用の Chirak を自動インストールするには：

npx -y smithery mcp add ufhouck/chirak

Claude Desktop（手動設定）

次の設定を claude_desktop_config.json に追加します：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chirak": {
      "command": "npx",
      "args": ["-y", "chirak-mcp"],
      "env": {
        "CHIRAK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor と Windsurf

エディターの MCP 設定で MCP サーバーを設定します：

• コマンド： npx
• 引数： -y chirak-mcp
• 環境変数：
  • CHIRAK_API_KEY：your_api_key_here

Smithery

Smithery CLI 経由でインストールするには：

npx -y smithery mcp add ufhouck/chirak

環境変数

変数	必須	説明
CHIRAK_API_KEY	はい	Chirak Cloud API の認証キー（chk_live_...）。
CHIRAK_API_BASE_URL	いいえ	接続先の API エンドポイント（デフォルト：https://chirak.app/api/v1）。

ツール

在庫と商品

ツール	説明
get_products	カテゴリー、在庫レベル、検索文字列で任意に絞り込んで、在庫商品を一覧表示・検索します。
add_product	SKU、名称、価格、バーコード、初期在庫を指定して、新しい商品情報を作成します。
update_stock	指定した移動タイプ（入庫、出庫、棚卸、紛失）に基づいて、在庫数を調整します。
update_product	タイトル、価格、カテゴリーなど、既存商品の属性を変更します。
delete_product	在庫商品の情報を削除します。

販売と注文

ツール	説明
get_sales	日付またはステータスで絞り込んで、最近の注文と販売記録を取得します。
record_sale	明細項目、適用した支払い方法、顧客との関連付けを含む販売取引を作成します。
cancel_sale	販売取引を取り消し、商品を自動的に在庫へ戻します。
get_daily_summary	総売上、利益、取引件数、売れ筋商品など、日次の集計指標を取得します。

顧客管理

ツール	説明
get_customers	顧客情報、未払い残高、購入概要を照会します。
add_customer	新しい顧客プロフィールを作成します。
update_customer	連絡先情報と顧客メモを更新します。
delete_customer	顧客情報を削除します。

書類と請求書（請求管理）

ツール	説明
list_documents	種類やステータスで絞り込んで、請求書、領収書、返品請求書、見積書を取得します。
get_document	明細を含む書類の詳細、顧客の詳細、税金／VAT の計算内容を取得します。
create_document	明細を含む正式な請求書、販売領収書、または見積書を作成して発行します。
delete_document	請求書または領収書の記録を完全に削除します。
export_document_text	印刷またはチャット表示に適した、書式付きの ASCII サーマルレシート／伝票レイアウトを生成します。

開発

リポジトリをクローンし、依存関係をインストールします：

git clone https://github.com/ufhouck/chirak-mcp.git
cd chirak-mcp
npm install
npm run build

STDIO を使用してローカルで実行するには：

export CHIRAK_API_KEY="your_api_key_here"
node dist/index.js

セキュリティ

• すべての API 通信は TLS（HTTPS）経由で行われます。
• API 認証情報は、SHA-256 ハッシュの照合によってサーバー側で認証されます。
• リクエストは、分離されたテナントデータベースのパーティション内でのみ処理されます。

プライバシーポリシー

Chirak は、開発者とユーザーのプライバシーを大切にしています。この MCP サーバーを利用する際は、以下の点にご留意ください：

• AI クライアントと Chirak Cloud API 間のすべてのデータ転送は、TLS によって転送中に暗号化されます。
• ストアのデータベースパーティションは、テナント ID ごとに厳密に分離されたマルチテナント構成になっています。
• API キーはサーバー側で SHA-256 ハッシュを使って検証され、平文で保存されることはありません。
• プライバシーポリシーの全文：https://chirak.app/privacy

ライセンス

MIT License です。詳細は LICENSE をご覧ください。