MCP 経由で BricoBravo を Cursor に接続する方法

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

BricoBravo + Cursor

イタリアの DIY・住まい向けマーケットプレイス BricoBravo で AI エージェントから販売します。商品、合計金額、顧客、配送先住所を含む注文を日付で絞り込んで扱えます。配送業者と追跡番号による発送確定も含まれますが、インストール時はオフです。

前提条件

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

BRICOBRAVO_API_TOKEN

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

トークンが手元にあれば、セットアップは数分です。イタリアの DIY・住まい・ガーデン向けマーケットプレイス BricoBravo の販売者アカウントと、その Seller Hub の API トークンが必要です。

1. BricoBravo からショップの API トークンを入手します。sellerhub.bricobravo.com の Seller Hub で確認するか、BricoBravo の販売者サポートに問い合わせてください。
2. トークンを BRICOBRAVO_API_TOKEN に貼り付けます。sh-token ヘッダーで送信されるため、Bearer という語は付けません。
3. コネクターをインストールし、per_page を 1 にして bricobravo_search_orders を実行します。注文が 1 件返るか、開設したばかりのショップなら空のリストが返れば、トークンは有効です。

読み取れるデータ: Seller Hub の ID とマーケットプレイスの注文番号、ステータス、合計金額、作成日、商品（EAN、商品コード、名前、価格、定価、数量）、請求情報、顧客と受取人の配送情報（氏名、メール、電話、通り、郵便番号、市、県、国）を含む BricoBravo の注文です。AI は作成日時で注文を絞り込み、ページをたどります（既定は 1 ページ 100 件）。

2 つの注文番号: 各注文には Seller Hub の ID（id_order）と、1234460505385-01 のようなマーケットプレイスの番号があります。1 件の注文を読むには Seller Hub の ID が必要で、マーケットプレイスの番号を使うと BricoBravo は注文ではなくエラーの一覧を返します。マーケットプレイスの番号しかない場合は、AI がまず一覧から注文を探します。

ステータスと時刻: 0 支払済み（発送待ち）、1 完了、2 返金予定、3 返金済み。時刻はイタリア時間です。

取り込み済みの注文: コネクターは、受注管理システムがすでに取り込んだ注文も含めてすべての注文を取得するため、一覧から抜け落ちる注文はありません。

インストール時はオフ: bricobravo_mark_shipped。実際の顧客の注文について、配送業者、追跡番号、追跡 URL を付けて発送を確定します。発送済みの注文に再度使うと追跡情報が置き換わります（2 回目の発送のときなど）。配送業者には BRT、GLS Italy、SDA、Poste Italiane、TNT、DHL、UPS、FedEx、DPD などがあります。受注管理システムがすでに発送を確定している場合は、修正にだけ使ってください。管理者が意図して有効にし、その場合でも AI は注文、配送業者、追跡情報を示してあなたの承認を待ち、実行後に注文を読み直して確認します。

よくあるエラー: 401 token NOT valid は、トークンが誤っているか取り消されたことを示します。BricoBravo に新しいトークンを依頼してください。404 は、BricoBravo がそのパスまたは注文を認識していないことを示します。

このコネクターは注文の返金やキャンセル、商品・価格・在庫の変更、顧客への返信は行いません。

ステップ 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. チャットを始めましょう。エージェントが BricoBravo のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「支払済みでまだ発送していない BricoBravo の注文はどれですか。」
• 「過去 7 日間の BricoBravo の注文を、合計金額と配送先の県付きで見せてください。」
• 「注文 1234460505385-01 を探して、顧客が何を買い、どこへ送るのか教えてください。」
• 「今、返金待ちになっている注文はどれですか。」
• 「9 月に BricoBravo でいくら売れましたか。いちばん多く売れた商品はどれですか。」

FAQ

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

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続