B&Q Marketplace MCPサーバー：注文・在庫・発送

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

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

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

セットアップ

国: イギリス。

販売可能な人: B&QはKingfisher Merchant Hubを通じて申請を受け付けています; ビジネスはVAT登録されている必要があります。コネクタには、B&Qがすでに開設したセラーアカウントが必要です。

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

セットアップには約5分かかります。

1. B&Qセラーバックオフィスにサインインします: https://marketplace.kingfisher.com/login。
2. バックオフィスでユーザー名を開き（右上）、マイユーザー設定 > APIキーを選択し、新しいキーを生成をクリックします（または既存のキーをコピーします）。それを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）。

前提条件: B_AND_Q_API_KEY

コネクタをローカルにインストールする

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

http://localhost:3000/connectors/storeを開き、B&Qマーケットプレイスを選択し、前提条件の下にリストされている環境変数を貼り付けます。

利用可能なツール

例のプロンプト

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

次のステップ

• Claudeに接続する
• ChatGPTに接続する