Boxzooka MCP サーバー

Boxzooka の bxz-api（Product、Inbound、Order、Inventory、Shipment、Return）を MCP サーバーとしてラップします。Materials Inventory コネクタと同じパターンです。共有サーバー1つ、共有認証情報1組で、チーム全員が同じ URL に接続します。

33 ツール、読み取り + 書き込みを完全にカバー。EDI は対象外です。EDI は XML ベースで、Boxzooka では利用には IT チームとの別途セットアップの打ち合わせが必要です。実際に必要な場合はお知らせください。追加します。

ファイル

• boxzooka_mcp.py — サーバー本体

• requirements.txt — Python 依存関係

• Dockerfile — リモートホスティング用のコンテナビルド

Related MCP server: MoySklad MCP Server

1. デプロイ（Materials Inventory とは別のサービス）

これは Materials Inventory コネクタとは別のデプロイです。各サーバーには独自の Railway/Render/Fly サービスが必要です。

1. これら3つのファイルを新しいリポジトリ（または既存リポジトリのフォルダ）にプッシュします。

2. Railway → New Project → Deploy from GitHub repo → リポジトリを選択。

3. Variables に以下を追加:

   • BOXZOOKA_API_TOKEN = サンドボックストークン (c44f966f5c7fc4cdb7d7f461ab4414c6)

   • BOXZOOKA_CUSTOMER_ID = 242

   • BOXZOOKA_API_BASE_URL = 本番環境（実際の倉庫データ）では https://api.boxzooka.com。省略した場合、サンドボックス（https://sandbox.boxzooka.com）がデフォルトになります。これは静的テストデータであり、実際の出荷は反映されません。実際の数値を取得するには本番 URL を設定してください。注意: 本番環境ではサンドボックスとは異なるトークン/カスタマー ID が必要な場合があります。切り替え後に 401 が返る場合は、Boxzooka から本番用認証情報を取得してください。

4. Railway が公開 URL を発行します。例: https://boxzooka-production-xxxx.up.railway.app

5. チームに共有するコネクタ URL は、その URL に /mcp を付けたものです: https://boxzooka-production-xxxx.up.railway.app/mcp

2. チームの接続

Materials Inventory と同じです。各メンバーが自分の Claude アプリでカスタムコネクタとして追加し、上記の URL を指定します。ユーザーごとの設定は不要です。

3. セキュリティとサンドボックスに関する注意

• このトークン/カスタマーの組み合わせは現在、Boxzooka のサンドボックス環境を指しています（Boxzooka のドキュメントによると「テストおよびデバッグ目的」）。ここで見えるデータはテストデータであり、実際の倉庫のものではありません。ここの注文や在庫は、Boxzooka の物理倉庫で実際に起きていることを反映しません。本番移行の準備ができたら、Boxzooka に連絡して本番用認証情報を取得し、BOXZOOKA_API_TOKEN / BOXZOOKA_CUSTOMER_ID / BOXZOOKA_API_BASE_URL で設定してください。

• Materials Inventory と同じアクセスレベルの注意: このコネクタは注文の作成、注文のキャンセル、返品の調整などが可能です — 完全な読み取り/書き込み権限があります。URL をチーム外と共有しないでください。

4. 対象範囲

• Product: 作成、SKU による取得、更新、全件一覧、一覧（ページネーション付き）

• Inbound: 作成、PO 番号による取得、日付範囲による検索、受領日による取得（リアルタイム）、更新、受領日によるページネーション付き一覧

• Order: 作成、キャンセル、検索（order_id/order_key/external_id による）、更新、WMS 注文の日付別ロード

• Inventory: 在庫ありの全件一覧、SKU による取得、本日の調整、日付別の調整、日付別のパットアウェイ、および各項目のページネーション付きバリアント

• Shipment: オーダーキーによる取得、日付範囲による取得、日付別のページネーション付き一覧

• Return: 検索、日付による検索、作成、更新、キャンセル

対象外: EDI（XML ベース。Boxzooka の IT 部門との別途の打ち合わせが必要）。