MediaMarkt MCPサーバー：注文・出品・発送

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

MediaMarkt Marketplace

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

セットアップ

国: ドイツ、オーストリア、スペイン、オランダ、イタリア、ベルギー、スイス、ポーランド、ハンガリー。イタリアではMediaWorldとして取引されています。すべての国は1つのセラープラットフォームを共有しています。

誰が販売できるか: MediaMarktは国ごとにフォームを通じて申請を受け付け、その後ビジネスの確認（KYC）を行います。コネクタには、MediaMarktがすでに開設したセラーアカウントが必要です。

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

1. MediaMarktセラーバックオフィスにサインインします: https://mediamarktsaturn.mirakl.net/login。
2. バックオフィスでログイン名（右上）を開き、My user settings > API keyを選択し、Generate a new keyをクリックします（または既存のキーをコピーします）。それをMEDIAMARKT_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になるため、それを使用している他のツールは動作しなくなります。
3. MediaMarktは通常、国ごとに1つのショップを開設するため、ほとんどのセラーは1つのユーザーの下に複数のショップを持っています。ユーザーが複数のショップを持っている場合、このコネクタが動作するショップの数値IDをMEDIAMARKT_SHOP_IDに設定します（バックオフィスのダッシュボードでIdentifierまたはShop IDの隣に表示され、mediamarkt_get_accountによってshop_idとして返されます）。複数のショップで動作させるには、ショップごとにコネクタを1回インストールします。これがないと、デフォルトのショップが使用されます。
4. mediamarkt_get_accountをインストールして実行します: それはキーに属するショップを返します。

どこから始めるか: mediamarkt_get_accountはキーの背後にあるショップ（ID、名前、状態、通貨、チャネル）を表示します。日常業務には、mediamarkt_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、価格と在庫にはmediamarkt_list_offers、返信を待っているメッセージにはmediamarkt_list_threadsを使用します。

製品と競合オファー: mediamarkt_get_productsは、EANまたは他の参照によってMediaMarktカタログで製品を検索し、マーケットプレイス製品SKUを返します。mediamarkt_list_product_offersは、指定された製品の各ショップのオファーをリストし、最安値を最初に表示します（約5回の呼び出しが可能です）。

注文ワークフロー: 新しい注文はWAITING_ACCEPTANCEで待機します。mediamarkt_accept_orderは各行を受け入れ（または拒否）します。顧客が引き落とされると、注文はSHIPPINGに移動します。その後、mediamarkt_update_trackingは運送業者と追跡番号を保存し（運送業者コードはmediamarkt_list_carriersから取得）、mediamarkt_ship_orderは出荷を確認します（SHIPPED）。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のやるべきリストには、mediamarkt_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、オープンインシデントにはhas_incident=trueを使用します。mediamarkt_resolve_incidentは、問題が解決された後に1つの注文行のインシデントを閉じます。注文に添付された文書（納品書、ラベル、顧客請求書）はmediamarkt_list_order_documentsでリストされます。

書き込み: まず確認してください。 mediamarkt_accept_order、mediamarkt_update_tracking、mediamarkt_ship_order、mediamarkt_resolve_incident、mediamarkt_accept_return、mediamarkt_receive_return、mediamarkt_update_offers、mediamarkt_reply_thread、mediamarkt_create_order_thread、mediamarkt_import_productsは、ライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変更されるか（注文IDと行、追跡番号、古いおよび新しい価格または在庫のオファーSKU、メッセージテキストと受取人）を示し、はいを待ちます。注文行を拒否すると、それは永久にキャンセルされます。ここでは、どのツールも返金、注文のキャンセル、またはお金の移動を行いません。それはバックオフィスで行ってください。mediamarkt_import_offersはオファーを削除することができるため（REPLACEモードはファイルに存在しないすべてのオファーを削除します）、オフにスイッチを入れてインストールされます。

オファーの更新（価格と在庫）: mediamarkt_update_offers（OF24）は、オファー全体を置き換えます。省略したすべてのフィールドはリセットされます: quantityが欠けると0になり、discountまたはdescriptionが欠けると削除されます。常に最初にオファーを読み込み（mediamarkt_get_offerまたはmediamarkt_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を返し、変更は非同期で適用されるため、再度オファーを読み取る前にmediamarkt_get_offer_importで確認してください。state_codeの条件コードはmediamarkt_list_offer_conditionsから、物流クラスコードはmediamarkt_list_logistic_classesから取得します。

ファイルインポート: mediamarkt_import_products（P41）およびmediamarkt_import_offers（OF01）は、MediaMarktが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタはそれをダウンロードしてMediaMarktにアップロードします。それらをmediamarkt_list_product_imports / mediamarkt_get_product_importおよびmediamarkt_list_offer_imports / mediamarkt_get_offer_importで追跡します。

返品: mediamarkt_list_returns（RT11）は返品リクエストをリストします。MediaMarktがショップに決定を任せる場合、mediamarkt_accept_returnはWAITING_ACCEPTANCEのリクエストを受け入れるか拒否し、mediamarkt_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。

メッセージ: mediamarkt_list_threadsは会話をリストします（1つの注文についてはentity_type=MMP_ORDERおよびentity_id=<order id>でフィルタリング; entity_typeなしのentity_idは拒否されます）、mediamarkt_get_threadはそのメッセージを読み、mediamarkt_reply_threadは回答します（受取人はCUSTOMERまたはOPERATOR、MediaMarkt）およびmediamarkt_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはmediamarkt_list_reasonsから取得します; マーケットプレイスがその言語を持っていることを知らない限り、そのlocaleは空にしてください（非アクティブなロケールは400で応答します）。

お金: mediamarkt_list_invoices（IV01）はMediaMarktがショップに発行する会計文書をリストし、mediamarkt_list_transactions（TL02）は取引行（販売、手数料、返金、支払い）をリストします。MediaMarktがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません; その場合はmediamarkt_list_document_requests（DR11）およびその後の取引を使用してください。

参照リスト: mediamarkt_list_channels（国サイト）、mediamarkt_list_carriers、mediamarkt_list_shipping_zones、mediamarkt_list_shipping_methodsおよびmediamarkt_list_logistic_classesはあまり変更されません; 会話ごとに1回読み取ってください。

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

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

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

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

前提条件: MEDIAMARKT_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を開き、MediaMarkt Marketplaceを選択し、前提条件の下にリストされている環境変数を貼り付けます。

利用可能なツール

例のプロンプト

• "出荷中で追跡番号がまだない私のMediaMarktの注文をリストしてください。"
• "MediaMarktでEAN 4548736132610のヘッドフォンの最安値は誰で、私の価格はどのようにランクされていますか？"
• "私のMediaMarktのオファーで残りが3ユニット未満のものはどれですか？"
• "私のMediaMarktの注文にオープンインシデントがあり、顧客が何を書いたかを表示してください。"
• "注文4501234-Aのスレッドで顧客に、交換品が明日発送されると返信してください。"

次のステップ

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