概要
AIエージェントからMediaMarktマーケットプレイスでショップを運営する:注文、受け入れ、追跡と発送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはドイツ、オーストリア、スペイン、オランダ、イタリア、ベルギー、スイス、ポーランド、ハンガリーで販売されています。MediaMarktの販売者バックオフィスからショップAPIキーでサインインしてください。
ガイド付きセットアップ
MediaMarkt Marketplace を Meta Muse に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで MediaMarkt Marketplace を接続して、MCP URL を Meta Muse に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
MediaMarkt Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインして、Connectors → MediaMarkt Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
MediaMarkt Marketplace + Meta Muse
AIエージェントからMediaMarktマーケットプレイスでショップを運営する:注文、受け入れ、追跡と発送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはドイツ、オーストリア、スペイン、オランダ、イタリア、ベルギー、スイス、ポーランド、ハンガリーで販売されています。MediaMarktの販売者バックオフィスからショップAPIキーでサインインしてください。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
MEDIAMARKT_API_KEY
ステップ1 — 認証情報を取得する
国:ドイツ、オーストリア、スペイン、オランダ、イタリア、ベルギー、スイス、ポーランド、ハンガリー。イタリアではマーケットプレイスはMediaWorldとして取引されます。すべての国は1つの販売者プラットフォームを共有しています。
誰が販売できるか:MediaMarktは国ごとにフォームを通じて申請を受け付け、その後ビジネスの確認(KYC)が行われます。コネクタには、MediaMarktがすでに開設した販売者アカウントが必要です。
設定には約5分かかります。
- MediaMarktの販売者バックオフィスにサインインします:
https://mediamarktsaturn.mirakl.net/login。 - バックオフィスでログイン名を開き(右上)、My user settings > API keyを選択し、Generate a new keyをクリックします(または既存のキーをコピーします)。それを
MEDIAMARKT_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になりますので、他のツールで使用している場合は動作しなくなります。 - MediaMarktは通常、国ごとに1つのショップを開設するため、ほとんどの販売者は1つのユーザーの下に複数のショップを持っています。ユーザーが複数のショップを持っている場合は、このコネクタが動作するショップの数値IDを
MEDIAMARKT_SHOP_IDに設定します(バックオフィスのダッシュボードでIdentifierまたはShop IDの隣に表示され、mediamarkt_get_accountによってshop_idとして返されます)。複数のショップで動作させるには、ショップごとにコネクタを1回インストールします。これがないとデフォルトのショップが使用されます。 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回の呼び出しが1分間に可能です。
注文ワークフロー:新しい注文はWAITING_ACCEPTANCEで待機します。mediamarkt_accept_orderは各行を受け入れ(または拒否)します。顧客が請求された後、注文はSHIPPINGに移動します。その後、mediamarkt_update_trackingは運送業者と追跡番号を保存し(運送業者コードはmediamarkt_list_carriersから取得)、mediamarkt_ship_orderは発送を確認します(SHIPPED)。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストには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は顧客とMediaMarktとの会話をリストします(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)。
ステップ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 — Museにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。
- Muse で Settings → Connectors を開き、Add custom connector を選びます。
- MCP サーバーの URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを貼り付けます。 - Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
MediaMarkt Marketplaceのツールが必要になる依頼を Muse にしてみましょう。
チャットから設定することもできます(Web、iOS・Android アプリ、WhatsApp)。Muse に次のメッセージを送ってください:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 何をするか |
|---|---|
mediamarkt_get_account | このマーケットプレイスでのAPIキーの背後にあるショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレードと承認率、連絡先… |
mediamarkt_list_orders | 注文をリストします(OR11):その行、顧客、配送先住所、価格、状態、インシデント。状態でフィルタリング(例:WAITING_ACCEPTANCE… |
mediamarkt_list_offers | ショップのオファーをリストします(OF21):SKU、製品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
mediamarkt_get_offer | オファーID(OF22)によって1つのオファーを完全に読み取ります:すべての価格フィールド、割引、数量、状態、物流クラス、リードタイム、カスタム… |
mediamarkt_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新しいまたは中古のように、オファーを更新する際にstate_codeに入れるコード |
mediamarkt_list_offer_imports | オファーのインポートと更新をリストします(OF04):ファイルからとmediamarkt_update_offersから:状態(WAITING、RUNNING、COMPLETE、FAILED)、行… |
mediamarkt_get_offer_import | 1つのオファーインポートまたはオファー更新の状態を読み取ります(OF02):mediamarkt_update_offersまたは…から返されたimport_idによって |
mediamarkt_list_product_imports | 製品インポートをリストします(P51):その状態(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、変換カウントと… |
mediamarkt_get_product_import | 1つの製品インポートの状態を読み取ります(P42):インポート状態、理由、変換カウントと統合の詳細… |
mediamarkt_get_products | マーケットプレイスカタログ内の製品をその識別子(P31)によって検索し、マーケットプレイス製品SKU、タイトル、カテゴリを取得します… |
mediamarkt_list_product_offers | 指定された製品の各ショップのオファーをリストします(P11):最安値でソートし、競合と価格を比較します。product_idsを提供します… |
mediamarkt_list_threads | 顧客とMediaMarktとのメッセージスレッドをリストします(M11):トピック、関連する注文またはオファー、参加者、最終メッセージの日付、いつから… |
mediamarkt_get_thread | すべてのメッセージ、送信者、受取人、添付ファイル、関連する注文またはオファーを含む1つのメッセージスレッドを読み取ります(M10) |
mediamarkt_list_returns | 返品リクエストをリストします(RT11):その状態、返品行、理由、RMA、追跡、関連する注文。状態、注文または日付でフィルタリング… |
mediamarkt_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金およびメッセージの理由、そのラベルとショップが… |
mediamarkt_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):そのコード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
mediamarkt_list_invoices | MediaMarktがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金ありとなしの合計… |
mediamarkt_list_transactions | ショップの取引行をリストします(TL02):注文金額、配送、手数料、返金、手動クレジットと支払い、金額、タイプ… |
mediamarkt_list_document_requests | 会計文書リクエストをリストします(DR11):MediaMarktがEnhanced Seller Invoicingを実行する際に使用されます:MediaMarktまたは…からの請求書とクレジットノート… |
mediamarkt_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書および他のファイル、ID、ファイル… |
mediamarkt_list_channels | マーケットプレイスの販売チャネルをリストします(CH11):通常は国別サイトごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
mediamarkt_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例:フランス本土またはコルシカ。変更はあまりありません:呼び出します… |
mediamarkt_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12):例:標準、エクスプレスまたはピックアップ、コード、ラベル、追跡番号の有無… |
mediamarkt_list_logistic_classes | マーケットプレイスの物流クラスをリストします(SH31):配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
mediamarkt_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します(OR21)。注文の各行をリストする必要があります。行を拒否すると、それはキャンセルされます… |
mediamarkt_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。mediamarkt_list_carriersからcarrier_codeを提供するか、carrier_nameとcarrier_urlを使用します… |
mediamarkt_ship_order | SHIPPINGにある注文が発送されたことを確認します(OR24);それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
mediamarkt_update_offers | オファーを作成または更新します。価格と在庫を含む(OF24)。各オファーを完全に置き換えます:省略されたすべてのフィールドはリセットされます(省略された… |
mediamarkt_reply_thread | メッセージスレッド(M12)で顧客またはMediaMarktに返信します。メッセージはすぐに配信され、取り消すことはできません:ユーザーに… |
mediamarkt_create_order_thread | 注文に関する新しいメッセージスレッドを顧客、MediaMarktまたは両方で開始します(OR43)。メッセージはすぐに配信されます:ユーザーに… |
mediamarkt_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64)、顧客の問題が解決された後。reason_codeはINCIDENT_CLOSEである必要があります… |
mediamarkt_accept_return | WAITING_ACCEPTANCEの返品リクエストを受け入れるか拒否します(RT21)。MediaMarktが販売者バックオフィスで返品を処理し、… |
mediamarkt_receive_return | 受け入れられた返品の商品の到着を確認します(RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで操作します… |
mediamarkt_import_products | マーケットプレイスに製品ファイルを送信します(P41):カタログ内の製品を作成または強化します。file_urlはCSV、XLSXまたはXMLのアドレスです… |
mediamarkt_import_offers | オファーファイルをインポートします(OF01):オファーを一括で作成、更新または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除し、… |
例のプロンプト
- "私のMediaMarktの注文で、SHIPPING中でまだ追跡番号がないものをリストしてください。"
- "MediaMarktでEAN 4548736132610のヘッドフォンの最安値は誰で、私の価格はどの位置にありますか?"
- "私のMediaMarktのオファーで、残りが3ユニット未満のものはどれですか?"
- "私のMediaMarktの注文にオープンインシデントがあり、顧客が何を書いたかを表示してください。"
- "注文4501234-Aのスレッドで顧客に、交換品が明日発送されると返信してください。"
よくある質問
MediaMarkt APIキーはどこで取得できますか? MediaMarktの販売者バックオフィスで:ログイン名(右上)、My user settings、API key、次にGenerate a new key(または既存のキーをコピーします)。新しいキーを生成すると古いキーは無効になります。MediaMarktは通常、国ごとに1つのショップを開設するため、ほとんどの販売者は1つのユーザーの下に複数のショップを持っています。複数のショップがある場合は、このコネクタが動作するショップにMEDIAMARKT_SHOP_IDを設定します。
MediaMarktで誰が販売でき、どの国をカバーしていますか? MediaMarktは国ごとにフォームを通じて申請を受け付け、その後ビジネスの確認(KYC)が行われます。コネクタはドイツ、オーストリア、スペイン、オランダ、イタリア、ベルギー、スイス、ポーランド、ハンガリーをカバーしています。イタリアではマーケットプレイスはMediaWorldとして取引されます。すべての国は1つの販売者プラットフォームを共有しています。
注文をキャンセルしたり、返金したり、オファーを削除したりできますか? どのツールも注文を返金またはキャンセルすることはできません;それはMediaMarktのバックオフィスで行ってください。注文を受け入れる際に行を拒否すると、それは永久にキャンセルされるため、AIはすべての書き込みを表示し、はいを待ちます。mediamarkt_import_offersはオフにしてインストールされます。REPLACEモードはファイルに存在しないすべてのオファーを削除するため、AIが使用する必要がある場合のみコネクタページでオンにしてください。
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?