bol.com MCPでClaudeと注文・出品を確認

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

bol.com + Claude

オランダおよびベルギーのマーケットプレイス向けのbol.com小売業者API：注文、追跡可能な出荷、返品、FBB在庫、価格と在庫を含むオファー、手数料、カタログコンテンツ、競合オファー、評価、請求書およびパフォーマンス指標。クライアントIDとシークレット。

前提条件

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

BOL_CLIENT_ID, BOL_CLIENT_SECRET

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

セットアップには約3分かかります。bol.comの販売者アカウント（Verkopen via bol）が必要で、bol Seller DashboardのAPI設定にアクセスする必要があります。コネクタには小売業者API用のクライアントIDとクライアントシークレットが必要です。

1. bol Seller Dashboardでアカウントを開き、次にInstellingen → Diensten → API Instellingen（設定、サービス、API設定）を選択します。bolが技術的な連絡先を求めた場合は保存してください。
2. Client credentials voor de Retailer APIの下でAanmaken（作成）をクリックし、キーに名前を付けてToon secret（シークレットを表示）をクリックします。
3. client IDをBOL_CLIENT_IDに、secretをBOL_CLIENT_SECRETにコピーします。シークレットを失った場合は、新しい資格情報を作成してください。
4. コネクタをインストールします。接続を確認するためにbol_com_list_ordersを実行します：自分で出荷するオープン注文が返されます（FBR）。

クラウドとセルフホストは同じ方法で動作します：資格情報は同じで、登録するリダイレクトURLやIPアドレスはありません。

認証：コネクタはhttps://login.bol.com/token（クライアント資格情報）でクライアントIDとシークレットを交換し、約5分間有効なベアラートークンを取得し、期限が切れるまで再利用します。bolはログインサービスを攻撃するアドレスをブロックするため、毎回新しいトークンを要求しません。

開始する場所：bol_com_list_ordersはオープンFBR注文を新しい順にリストします；bol_com_get_orderは顧客の配送および請求の詳細とアイテムを追加します。bol_com_list_offersはあなたのオファーをリストし、bol_com_list_inventoryはbolがあなたのために保有している在庫（FBB）を表示します。

読み取る内容：注文、輸送および追跡可能な出荷、理由と顧客コメントを含む返品、FBB在庫、価格、在庫および国の可用性を含むオファー、オファーが販売されていない理由、価格での製品の手数料、EANによるbolカタログコンテンツ、競合オファーおよび誰がバイボックスを持っているか、星評価、訪問数およびオファーごとのバイボックスの割合、週ごとの販売者パフォーマンス指標、請求書（読み取り専用）。

出荷：bol_com_create_shipmentは、あなたが自分で出荷するアイテムの出荷を確認し、運送業者と追跡コードを含みます。bol_com_add_track_and_traceは出荷に欠けているコードを追加します；既存のコードを変更することはできません。

オファー：bol_com_create_offerおよびbol_com_update_offerはオファーを作成し、価格、在庫、履行、国または保留フラグを変更します。更新は指定されたフィールドのみを変更しますが、配列（バンドル価格、国）は古いもの全体を置き換えます。409は、誰かが同時にオファーを変更したことを意味します。価格はVATを含むEURで、在庫は0から999です。

インストール時にオフになっている：bol_com_cancel_order_item（配達できない注文アイテムをキャンセル）およびbol_com_delete_offer（オファーを削除）。キャンセルは元に戻せず、販売者スコアにカウントされ、削除されたオファーはbolからすぐに消え、復元できません。オファーを一時停止するには、代わりにbol_com_update_offerで保留に設定します。AIが使用する必要がある場合のみ、コネクタページでオンにしてください；AIはすべての変更を確認するように求めます。出荷、追跡、オファーの作成および更新はオンになっています。

非同期書き込み：出荷、輸送およびキャンセルは結果ではなくプロセスステータスで応答します。bol_com_get_process_status（またはbol_com_find_process_statusesをエンティティおよびイベントタイプで）で、SUCCESSまたはFAILUREの時点を表示します。bolはプロセスステータスを1日保持します。オファーは同期的です。

ページング：注文、出荷、返品および在庫リストは1からpageを取り、1ページあたり50行です；空の回答はもうページがないことを意味します。オファーはカーソルを使用します：page.nextCursorを渡し続け、欠落するまで続けます。

レート制限：bolはエンドポイントごとに設定します。注文リストと出荷リストは1分あたり25回の呼び出しを許可し、返品と在庫は1分あたり20回、請求書は1分あたり24回；注文詳細は1秒あたり25回、オファーは1秒あたり25から50回です。429は秒単位のRetry-Afterを持ちます；ライブ値はapi.bol.com/retailer/public/ratelimitsで確認できます。

IDとフォーマット：注文IDには文字（A4K8290LP0）を含むことができ、EANは文字列、日付はYYYY-MM-DD、時間はオフセット付きのISO 8601です。未使用のフィールドは省略され、bolは空の文字列に対して400を返します。

一般的なエラー：エラーはapplication/problem+jsonとして返され、title、detailおよびフィールド名を示すviolationsが含まれます。400は通常、フィールドが欠落または空であることを意味します。429はレート制限です：Retry-Afterの時間を待ってください。

カバーされていない内容：返品の処理や登録（返品を受け入れるとbolが顧客に返金します）、配送ラベルの購入、資金を移動させるもの。

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

あなたのサーバーURL：AnythingMCPで、MCP Servers → このコネクタがあるサーバーを開き、そのURLをコピーします（https://cloud.anythingmcp.com/mcp/…）。このガイドがYOUR_SERVER_IDを示す場所で使用します。

推奨パス：claude.ai webで動作し、設定ファイルを編集する必要はありません。

1. Claudeで、**Customize → Connectors**を開きます。
2. +をクリックし、次にAdd custom connectorを選択します。
3. 名前を入力します（例：bol.com）とリモートMCPサーバーURLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、次にAddをクリックします。
4. Connectをクリックし、AnythingMCPにサインインして（OAuth）アクセスを許可します。

以下のすべてのツールがチャットに表示されます：プロンプトの入力を開始してください。

利用可能なツール

例のプロンプト

• "今日出荷する必要があるオープン注文はどれで、キャンセルリクエストがあるものはありますか？"
• "顧客の住所とアイテムを含む注文A4K8290LP0を表示してください。"
• "私のオファーの中で販売されていないものはどれで、その理由は何ですか？"
• "EAN 8712345678901のバイボックスは誰が持っていて、価格はいくらですか？"
• "EAN 8712345678901の私のオファーの価格を24.95に、在庫を40に設定してください。"

よくある質問

Claude CodeとClaude Desktopの両方で動作しますか？ はい、両方ともhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを指します。

返品や注文のキャンセルを処理できますか？ 返品を読み取りますが、処理や登録はできません。返品を受け入れるとbolが顧客に返金します。注文アイテムをキャンセルすることはbol_com_cancel_order_itemで可能ですが、インストール時にオフになっています。

ベルギーおよびオランダの販売に対応していますか？ はい。1つの販売者アカウントで両国をカバーし、オファーは国の可用性を持ち、bol_com_get_offer_not_for_sale_reasonsは国ごとにオファーが販売されていない理由を説明します。

次のステップ

• コネクタのランディングページ
• ChatGPTに接続する
• Cursorに接続する
• Geminiに接続する
• Meta Museに接続する
• Microsoft Copilotに接続する