Billbee MCPをCursorと連携：受注・在庫

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Billbee Order Management をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Billbee + Cursor

AI に Billbee の受注管理で作業させます。すべてのマーケットプレイスとショップの注文を検索し、SKU や EAN で商品の価格と在庫を調べ、顧客の注文履歴を確認できるほか、注文ステータスの変更、追跡番号の登録、Billbee に接続した配送業者でのラベル発行、在庫の更新、タグ付け、注文と商品の項目の変更、請求書の作成も行えます。Billbee の API キー、ログイン用メールアドレス、API パスワードを使います。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

BILLBEE_API_KEY, BILLBEE_LOGIN_EMAIL, BILLBEE_API_PASSWORD

ステップ 1 — 認証情報を取得

1. Billbee にログインし、Einstellungen（Settings）→ Billbee API を開きます。そのページの全般設定で API アクセスを有効にし、API パスワードを設定します。これは API 専用の別のパスワードで、ログイン用のパスワードではありません。
2. Billbee に API キーを申請します。API 申請フォームを使うか [email protected] にメールし、何を接続したいか（ここでは AnythingMCP 経由で注文を読む AI）を簡単に説明します。キーは Billbee から送られてきます。
3. キーを BILLBEE_API_KEY に、Billbee にログインするときのメールアドレスを BILLBEE_LOGIN_EMAIL に、手順 1 の API パスワードを BILLBEE_API_PASSWORD に入力します。
4. コネクターをインストールします。Authorize with Provider の手順はありません。各呼び出しは API キーを X-Billbee-Api-Key ヘッダーで送り、メールアドレスと API パスワードを HTTP Basic 認証で送ります。
5. まず billbee_list_shipping_providers を実行します。パラメーターは不要で、アカウントに設定された配送業者を一覧表示します。応答があれば、3 つの値はすべて正しく機能しています。

3 つの値はすべて必須: API キーだけ、またはメールアドレスと API パスワードだけの呼び出しは Billbee に拒否されます。コネクターには 3 つすべてを設定してください。

サインイン状態の維持: 更新が必要なトークンはなく、コネクターは呼び出しのたびに 3 つの値を送ります。Billbee で API パスワードを変更した場合や新しい API キーを受け取った場合は、コネクターのページで BILLBEE_API_PASSWORD または BILLBEE_API_KEY を更新してください。

読み取りと書き込み: 17 個のツールのうち 9 個は、注文、商品、顧客、配送業者、在庫拠点を読み取るだけです。残りの 8 個は本番の Billbee アカウントを変更し、Billbee はほとんどの変更を接続先のショップやマーケットプレイスに反映します。インストール時には 17 個すべてが有効です。読み取り専用にするには、コネクターのページで書き込みツールをオフにしてください。個別の読み取りツールも無効にできます。たとえば AI に顧客データを見せたくない場合は、billbee_list_customers と billbee_get_customer_orders を無効にします。

書き込みツール:

• billbee_set_order_state は注文ステータスを設定します。たとえば 3 は支払済み、4 は発送済み、8 はキャンセル、13 は梱包済みです。ショップやマーケットプレイスから購入者にメールが届くことがあります。
• billbee_add_shipment_to_order は、別の場所で作成した追跡番号を注文に登録します。ラベルは作成せず、ステータスも変えません。billbee_ship_order_with_label は、Billbee に接続した配送業者（DHL、DPD、GLS、Deutsche Post など）で、自社の契約に基づく実際の有料ラベルを発行します。providerId と productId は billbee_list_shipping_providers から取得し、AI は発行前に確認を求めます。
• billbee_update_stock は SKU ごとに商品の在庫数を絶対値で設定します（増減ではありません）。複数の在庫拠点を使う場合は billbee_list_stocks の stockId が必要です。Billbee は新しい在庫数をショップやマーケットプレイスに送ります。
• billbee_add_order_tags は注文にタグを追加します。billbee_update_order と billbee_update_product は渡した項目だけを変更します。項目名は billbee_get_order と billbee_get_product が返す名前（SellerComment や Price など）を使います。
• billbee_create_invoice は請求書テンプレートで注文の請求書を作成します。同じ注文では 5 分に 1 回までで、PDF も返せます。

書き込みツールには、ショップの注文番号ではなく Billbee 内部の注文 ID が必要です。マーケットプレイスの注文番号から ID を調べるには billbee_get_order_by_extref を使います。

注文: billbee_list_orders は注文日（minOrderDate、maxOrderDate）と最終更新日時（modifiedAtMin、modifiedAtMax）で絞り込めます。日付は 2026-01-01 のような ISO 8601 形式です。billbee_get_order は Billbee の注文 ID から、明細、住所、支払いと配送の情報を含む注文全体を返します。billbee_get_order_by_extref は、Amazon や eBay の注文番号など、マーケットプレイスやショップの注文番号で注文を探します。注文ステータスは数値で返ります。

商品と顧客: billbee_get_product は Billbee の商品 ID で商品を調べます。lookupBy を sku または ean にすると SKU や EAN でも検索でき、価格と在庫を返します。billbee_list_products は、指定日以降に作成された商品に絞り込めます（minCreatedAt）。billbee_list_customers には検索機能がないため、名前で顧客を探すにはページごとに一覧をたどります。顧客 ID がわかれば、billbee_get_customer_orders でその顧客の注文を一覧表示できます。

ページとレート制限: 一覧系のツールは 1 ページあたり最大 250 行（pageSize）を返し、応答には Page、TotalPages、TotalRows が含まれます。AI は最後のページまで次の page を順に取得します。Billbee が許可するのは API キーとユーザーの組み合わせごとに毎秒 2 リクエストまでで、それを超えると 429 を返します。少し待ってからやり直してください。無料枠を超える API の利用は Billbee で有料になるため、毎回すべてを取得するより、日付の範囲を絞ったり modifiedAtMin を使ったりするほうが適しています。

よくあるエラー: Billbee が認証情報を拒否する場合は、3 つの変数がすべて設定されているか、Einstellungen → Billbee API で API アクセスが有効になっているか、BILLBEE_API_PASSWORD にログイン用ではなく API パスワードが入っているかを確認してください。429 は毎秒 2 リクエストの制限に達したことを示します。

このコネクターは、注文の作成や削除、顧客の作成や変更、商品の作成や削除は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Billbee のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「過去 7 日間に入った注文はどれ？そのうちまだ発送していないものも教えて。」
• 「マーケットプレイスの注文番号 302-1234567-1234567 の注文を探して、明細、配送先住所、支払い情報を見せて。」
• 「SKU ABC-123 の在庫は何個ある？販売価格も教えて。」
• 「Billbee の顧客 4567 の注文をすべて、日付と合計金額付きで新しい順に一覧にして。」
• 「Amazon の注文 302-1234567-1234567 を発送済みにして、DHL の追跡番号 00340434161234567890 を登録して。」
• 「eBay の注文 14-12688-90311 の DHL ラベルを Billbee で作成して、そのあと請求書も作って。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続