B&Q Marketplace MCPをGemini CLIに接続

💡 インストール不要？cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → B&Q Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerもgit cloneもローカルサーバーも不要です。

B&Qマーケットプレイス + Gemini

AIエージェントからB&Qマーケットプレイスでショップを運営する：注文、承認、追跡と配送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書、取引。マーケットプレイスはイギリスで販売されており、B&Qの販売者バックオフィスからショップAPIキーでサインインします。

前提条件

コネクタに組み込まれた完全なセットアップ手順を参照してください（コネクタを選択するとアプリ内ストアに表示されます）。このコネクタに必要な環境変数は以下の通りです：

B_AND_Q_API_KEY

ステップ1 — 資格情報を取得する

国：イギリス。

誰が販売できるか：B&QはKingfisher Merchant Hubを通じて申請を受け付けています。ビジネスはVAT登録されている必要があります。コネクタには、B&Qがすでに開設した販売者アカウントが必要です。

B&QはKingfisherに属しているため、販売者プラットフォームはKingfisherのアドレスにあります。

設定には約5分かかります。

1. B&Qの販売者バックオフィスにサインインします：https://marketplace.kingfisher.com/login。
2. バックオフィスでユーザー名（右上）を開き、My user settings > API keyを選択し、Generate a new keyをクリックします（または既存のキーをコピーします）。それをB_AND_Q_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になりますので、他のツールで使用している場合は動作しなくなります。
3. B&Qの販売者は、単一のショップでもショップIDを設定することが知られています。ユーザーが複数のショップを持っている場合は、このコネクタが動作するショップの数値IDをB_AND_Q_SHOP_IDに設定します（バックオフィスのダッシュボードでIdentifierまたはShop IDの横に表示され、b_and_q_get_accountによってshop_idとして返されます）。複数のショップで動作させるには、ショップごとにコネクタを1回インストールします。これがないと、デフォルトのショップが使用されます。
4. b_and_q_get_accountをインストールして実行します：キーに属するショップを返します。

どこから始めるか：b_and_q_get_accountはキーに関連するショップ（ID、名前、状態、通貨、チャネル）を表示します。日常業務では、b_and_q_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、価格と在庫のためにb_and_q_list_offersを、返信を待っているメッセージのためにb_and_q_list_threadsを使用します。

製品と競合オファー：b_and_q_get_productsは、EANまたは他の参照によってB&Qカタログ内の製品を検索し、マーケットプレイス製品SKUを返します。b_and_q_list_product_offersは、指定された製品の各ショップのオファーをリストし、最安値を最初に表示します（約5回の呼び出し/分）。

注文ワークフロー：新しい注文はWAITING_ACCEPTANCEで待機します。b_and_q_accept_orderは各行を承認（または拒否）します；顧客が引き落とされると、注文はSHIPPINGに移動します。その後、b_and_q_update_trackingは運送業者と追跡番号を保存し（運送業者コードはb_and_q_list_carriersから取得）、b_and_q_ship_orderは出荷を確認します（SHIPPED）。後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストにはb_and_q_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、オープンインシデントにはhas_incident=trueを使用します；b_and_q_resolve_incidentは、問題が解決された後に1つの注文行のインシデントを閉じます。注文に添付された文書（納品書、ラベル、顧客請求書）はb_and_q_list_order_documentsによってリストされます。

書き込み：最初に確認してください。 b_and_q_accept_order、b_and_q_update_tracking、b_and_q_ship_order、b_and_q_resolve_incident、b_and_q_accept_return、b_and_q_receive_return、b_and_q_update_offers、b_and_q_reply_thread、b_and_q_create_order_thread、b_and_q_import_productsはライブマーケットプレイスに作用します。各呼び出しの前に、ユーザーに何が変わるか（注文IDと行、追跡番号、古い価格と新しい価格のオファーSKU、メッセージテキストと受取人）を示し、はいを待ちます。注文行を拒否すると、それは完全にキャンセルされます。ここではどのツールも返金、注文のキャンセル、またはお金の移動は行いません；それはバックオフィスで行ってください。b_and_q_import_offersはオファーを削除することができます（REPLACEモードはファイルに存在しないすべてのオファーを削除します）、したがって、オフに切り替えられた状態でインストールされます。

オファーの更新（価格と在庫）：b_and_q_update_offers（OF24）はオファー全体を置き換えます。省略したすべてのフィールドはリセットされます：quantityが欠けていると0になり、discountやdescriptionが欠けていると削除されます。常に最初にオファーを読み取り（b_and_q_get_offerまたはb_and_q_list_offersをskuで使用）、意図した変更のみを含めて完全に返送します：shop_sku、product_id、product_id_type（product_referencesから）、state_code、price、quantity、leadtime_to_ship、logistic_class（そのコード）、min_quantity_alert、description、discount、all_prices、available_started / available_ended（available_start_date / available_end_dateとして読み取ります）および任意のoffer_additional_fields。update_deleteは空またはupdateのままにします。呼び出しはimport_idを返します；変更は非同期で適用されるため、再度オファーを読み取る前にb_and_q_get_offer_importで確認してください。state_codeの条件コードはb_and_q_list_offer_conditionsから、物流クラスコードはb_and_q_list_logistic_classesから取得します。

ファイルインポート：b_and_q_import_products（P41）およびb_and_q_import_offers（OF01）は、B&Qが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタがそれをダウンロードしてB&Qにアップロードします。b_and_q_list_product_imports / b_and_q_get_product_importおよびb_and_q_list_offer_imports / b_and_q_get_offer_importで追跡します。

返品：b_and_q_list_returns（RT11）は返品リクエストをリストします。B&Qがショップに決定を任せる場合、b_and_q_accept_returnはWAITING_ACCEPTANCEのリクエストを承認または拒否し、b_and_q_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。

メッセージ：b_and_q_list_threadsは顧客とB&Qとの会話をリストします（1つの注文のためにentity_type=MMP_ORDERおよびentity_id=<order id>でフィルタリング；entity_typeなしのentity_idは拒否されます）、b_and_q_get_threadはそのメッセージを読み取り、b_and_q_reply_threadは（受取人CUSTOMERまたはOPERATOR、つまりB&Q）に応答し、b_and_q_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはb_and_q_list_reasonsから取得します；マーケットプレイスがその言語を持っていることがわからない限り、localeは空のままにします（非アクティブなロケールは400で応答します）。

お金：b_and_q_list_invoices（IV01）はB&Qがショップに発行する会計文書をリストし、b_and_q_list_transactions（TL02）は取引行（売上、手数料、返金、支払い）をリストします。B&QがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません；その場合はb_and_q_list_document_requests（DR11）を使用し、その後取引を確認します。

参照リスト：b_and_q_list_channels（国サイト）、b_and_q_list_carriers、b_and_q_list_shipping_zones、b_and_q_list_shipping_methodsおよびb_and_q_list_logistic_classesはめったに変更されません；会話ごとに1回読み取ります。

ページネーション：注文、オファー、請求書および製品インポートはmax（最大100）およびoffsetでページ分けされます。スレッド、返品、取引、文書リクエストおよびオファーインポートはnext_page_tokenを返します；次のページを取得するためにpage_tokenとして渡します（他のすべてのフィルタはその後無視されます）まで、トークンが存在しなくなるまで続けます。

日付はISO 8601形式で、例：2026-10-01T00:00:00Z；回答はUTCで行われます。

レート制限：各APIには独自の制限があり、B&Qはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、製品およびオファーのインポートは最大でも15分ごと、b_and_q_get_accountおよび参照リストは約1日に1回です。429はRetry-Afterヘッダーを持ち、待機する秒数が示されます；ループ内で再試行しないでください。

エラー：401はキーが間違っているか、新しいものに置き換えられたことを意味し、403はこのアクションに対する権限が不足していることを示し、404はこのショップに対して注文、オファー、またはスレッドが存在しないことを示し、400は不正なパラメータまたは不正な状態の注文を示します（メッセージがそれを示します、例：ORDER_INVALID_STATE）。

ステップ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 — Geminiにコネクタを追加する

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

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が B&Qマーケットプレイス のツールを呼び出せるようになりました。

利用可能なツール

例のプロンプト

• "承認待ちのB&Qの注文はどれで、合計金額はGBPでいくらですか？"
• "私のガーデンホースリールSKU HR-30Mの在庫をB&Qで40に設定してください。"
• "注文7012345-Aの行2のインシデントを解決済みとしてマークしてください；顧客は不足していたネジを受け取りました。"
• "私のB&Qオファーの中でアクティブでないものはどれで、B&Qはどの理由を挙げていますか？"
• "今四半期にB&Qが発行した請求書とその手数料合計を表示してください。"

FAQ

B&Q APIキーはどこで取得できますか？ B&Qの販売者バックオフィスで：ユーザー名（右上）、My user settings、API key、次にGenerate a new key（または既存のキーをコピーします）。新しいキーを生成すると古いキーは無効になります。B&Qの販売者は、単一のショップでもショップIDを設定することが知られています。複数のショップがある場合は、このコネクタが動作するショップにB_AND_Q_SHOP_IDを設定します。

B&Qで販売できるのは誰で、どの国をカバーしていますか？ B&QはKingfisher Merchant Hubを通じて申請を受け付けています。ビジネスはVAT登録されている必要があります。コネクタはイギリスをカバーしています。B&QはKingfisherに属しているため、販売者プラットフォームはKingfisherのアドレスにあります。

注文をキャンセルしたり、返金したり、オファーを削除したりできますか？ どのツールも返金や注文のキャンセルは行いません；それはB&Qのバックオフィスで行ってください。注文を承認する際に行を拒否すると、それは完全にキャンセルされますので、AIはすべての書き込みを表示し、はいを待ちます。b_and_q_import_offersはオフに切り替えられた状態でインストールされます。REPLACEモードはファイルに存在しないすべてのオファーを削除しますので、AIが使用する必要がある場合のみコネクタページでオンに切り替えてください。

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディングページ
• Claudeに接続する