MediaMarkt MCPをMicrosoft Copilotに接続

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

MediaMarkt Marketplace + Microsoft Copilot

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

前提条件

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

MEDIAMARKT_API_KEY

ステップ1 — 認証情報を取得する

国：ドイツ、オーストリア、スペイン、オランダ、イタリア、ベルギー、スイス、ポーランド、ハンガリー。イタリアではマーケットプレイスは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回の呼び出しが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 — Microsoft Copilotにコネクタを追加する

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

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。MediaMarkt Marketplace のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

例のプロンプト

• "私の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が使用する必要がある場合のみコネクタページでオンにしてください。

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

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