概要
AIエージェントからShop Apothekeマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはドイツ、オーストリア、イタリア、ベルギーで販売されており、Shop Apothekeの販売者バックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
Shop Apotheke Marketplace を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Shop Apotheke Marketplace を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Shop Apotheke Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Shop Apotheke Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを発行すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Shop Apotheke Marketplace + Microsoft Copilot
AIエージェントからShop Apothekeマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはドイツ、オーストリア、イタリア、ベルギーで販売されており、Shop Apothekeの販売者バックオフィスからショップAPIキーでサインインします。
前提条件
コネクタに組み込まれている完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
SHOP_APOTHEKE_API_KEY
ステップ1 — 資格情報を取得する
国: ドイツ、オーストリア、イタリア、ベルギー。マーケットプレイスはドイツとオーストリアで稼働中です;イタリア(redcare.it)とベルギー(farmaline.be)は独自の契約でパートナープログラムを運営しています。
誰が販売できるか: Shop Apothekeは各パートナーを承認し、最初に商品フィードを確認する場合があり、国ごとに契約を締結します;パートナーページから申し込んでください。コネクタには、Shop Apothekeがすでに開設した販売者アカウントが必要です。
このアドレスで確認されているのはドイツとオーストリアのショップのみです;イタリアとベルギーのショップも使用していると想定されます。
セットアップには約5分かかります。
- Shop Apothekeの販売者バックオフィスにサインインします:
https://shopapotheke.mirakl.net/login。 - バックオフィスでユーザー名(右上)を開き、My user settings > API keyを選択し、Generate a new keyをクリックします(または既存のキーをコピーします)。これを
SHOP_APOTHEKE_API_KEYに貼り付けます。キーはAuthorizationヘッダーにそのまま送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になりますので、他のツールで使用している場合は動作しなくなります。 - Shop Apothekeは各国ごとに別々の契約を締結するため、複数の国で販売する販売者は複数のショップを持ちます。ユーザーが複数のショップを持っている場合、このコネクタが動作するショップの数値IDを
SHOP_APOTHEKE_SHOP_IDに設定します(バックオフィスのダッシュボードでIdentifierまたはShop IDの隣に表示され、shop_apotheke_get_accountによってshop_idとして返されます);複数のショップで動作させるには、ショップごとにコネクタを1回インストールします。これがない場合はデフォルトのショップが使用されます。 shop_apotheke_get_accountをインストールして実行します:キーに属するショップが返されます。
どこから始めるか: shop_apotheke_get_accountはキーに関連付けられたショップ(ID、名前、状態、通貨、チャネル)を表示します。日常業務では、shop_apotheke_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、価格と在庫にはshop_apotheke_list_offers、返信を待つメッセージにはshop_apotheke_list_threadsを使用します。
商品と競合オファー: shop_apotheke_get_productsはEANまたは他の参照によってShop Apothekeカタログ内の商品を検索し、マーケットプレイスの商品SKUを返します;shop_apotheke_list_product_offersは指定された商品の各ショップのオファーをリストし、最良価格を最初に表示します(約5回の呼び出しが可能です)。
注文ワークフロー: 新しい注文はWAITING_ACCEPTANCEで待機します。shop_apotheke_accept_orderは各行を受け入れ(または拒否)します;顧客が引き落とされると、注文はSHIPPINGに移動します。その後、shop_apotheke_update_trackingは運送業者と追跡番号を保存し(運送業者コードはshop_apotheke_list_carriersから取得)、shop_apotheke_ship_orderは出荷を確認します(SHIPPED)。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストにはshop_apotheke_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、オープンインシデントにはhas_incident=trueを使用します;shop_apotheke_resolve_incidentは問題が解決された後、1つの注文行のインシデントを閉じます。注文に添付された文書(納品書、ラベル、顧客請求書)はshop_apotheke_list_order_documentsでリストされます。
書き込み: まず確認してください。 shop_apotheke_accept_order、shop_apotheke_update_tracking、shop_apotheke_ship_order、shop_apotheke_resolve_incident、shop_apotheke_accept_return、shop_apotheke_receive_return、shop_apotheke_update_offers、shop_apotheke_reply_thread、shop_apotheke_create_order_thread、shop_apotheke_import_productsはライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変更されるか(注文IDと行、追跡番号、古い価格と新しい価格のオファーSKU、メッセージテキストと受取人)を示し、承諾を待ちます。注文行を拒否すると、それは永久にキャンセルされます。ここではどのツールも返金、注文のキャンセル、または資金の移動を行いません;それはバックオフィスで行ってください。shop_apotheke_import_offersはオファーを削除することができるため(REPLACEモードはファイルに存在しないすべてのオファーを削除します)、オフに切り替えられた状態でインストールされます。
オファーの更新(価格と在庫): shop_apotheke_update_offers(OF24)はオファー全体を置き換えます。省略したすべてのフィールドはリセットされます:quantityが欠けていると0になり、discountまたはdescriptionが欠けていると削除されます。常に最初にオファーを読み取ります(shop_apotheke_get_offerまたはshop_apotheke_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を返します;変更は非同期で適用されるため、再度オファーを読み取る前にshop_apotheke_get_offer_importで確認してください。state_codeの条件コードはshop_apotheke_list_offer_conditionsから、物流クラスコードはshop_apotheke_list_logistic_classesから取得します。
ファイルインポート: shop_apotheke_import_products(P41)およびshop_apotheke_import_offers(OF01)は、Shop Apothekeが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタがそれをダウンロードしてShop Apothekeにアップロードします。これらはshop_apotheke_list_product_imports / shop_apotheke_get_product_importおよびshop_apotheke_list_offer_imports / shop_apotheke_get_offer_importで追跡します。
返品: shop_apotheke_list_returns(RT11)は返品リクエストをリストします。Shop Apothekeがショップに決定を任せる場合、shop_apotheke_accept_returnはWAITING_ACCEPTANCEのリクエストを受け入れるか拒否し、shop_apotheke_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。
メッセージ: shop_apotheke_list_threadsは顧客とShop Apothekeとの会話をリストします(特定の注文のためにentity_type=MMP_ORDERおよびentity_id=<order id>でフィルタリング;entity_typeなしのentity_idは拒否されます)、shop_apotheke_get_threadはそのメッセージを読み取り、shop_apotheke_reply_threadは(受取人CUSTOMERまたはOPERATOR、つまりShop Apotheke)に返信し、shop_apotheke_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはshop_apotheke_list_reasonsから取得します;マーケットプレイスがその言語を持っていることがわからない限り、localeは空のままにしてください(非アクティブなロケールは400で応答します)。
お金: shop_apotheke_list_invoices(IV01)はShop Apothekeがショップに発行する会計文書をリストし、shop_apotheke_list_transactions(TL02)は取引行(売上、手数料、返金、支払い)をリストします。Shop ApothekeがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません;その場合はshop_apotheke_list_document_requests(DR11)を使用し、取引を確認してください。
参照リスト: shop_apotheke_list_channels(国のサイト)、shop_apotheke_list_carriers、shop_apotheke_list_shipping_zones、shop_apotheke_list_shipping_methodsおよびshop_apotheke_list_logistic_classesはあまり変更されません;会話ごとに1回読み取ってください。
ページネーション: 注文、オファー、請求書、商品インポートはmax(最大100)およびoffsetでページ分けされます。スレッド、返品、取引、文書リクエストおよびオファーインポートはnext_page_tokenを返します;次のページを取得するためにpage_tokenとして渡してください(他のフィルタは無視されます)まで、トークンが存在しなくなるまで続けます。
日付はISO 8601形式で、例:2026-10-01T00:00:00Z;回答はUTCで行われます。
レート制限: 各APIには独自の制限があり、Shop Apothekeはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、商品とオファーのインポートは最大15分ごと、shop_apotheke_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 はこれに対応しています。
- Copilot Studio でエージェントを開き(または新規作成し)、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name(例:
AnythingMCP)、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー(MCP Servers → 対象のサーバー → API keys)を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Shop Apotheke Marketplaceのツールが必要になる依頼をしてみましょう。 - 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 は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
shop_apotheke_get_account | このマーケットプレイスでのAPIキーに関連付けられたショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレード、承認率、連絡先… |
shop_apotheke_list_orders | 注文をリストします(OR11):その行、顧客、配送先住所、価格、状態、インシデント。状態でフィルタリング(例:WAITING_ACCEPTANCE… |
shop_apotheke_list_offers | ショップのオファーをリストします(OF21):SKU、商品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
shop_apotheke_get_offer | オファーID(OF22)によって1つのオファーを完全に読み取ります:すべての価格フィールド、割引、数量、状態、物流クラス、リードタイム、カスタム… |
shop_apotheke_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新しいまたは中古のように、オファーを更新する際にstate_codeに入れるコード |
shop_apotheke_list_offer_imports | オファーのインポートと更新をリストします(OF04):ファイルからとshop_apotheke_update_offersから:ステータス(WAITING、RUNNING、COMPLETE、FAILED)、行… |
shop_apotheke_get_offer_import | 1つのオファーインポートまたはオファー更新のステータスを読み取ります(OF02):shop_apotheke_update_offersまたは… |
shop_apotheke_export_offers | ショップの全オファーをファイルとしてエクスポートします(OF52)。shop_apotheke_list_offers をページ送りする代わりに、カタログ全体(全SKUの価格と在庫)を読み取る方法です |
shop_apotheke_get_offer_export_status | shop_apotheke_export_offers で開始したオファーエクスポートのステータス(OF53):PENDING、COMPLETED、FAILED。完了後はファイルのURLを返します |
shop_apotheke_get_offer_export_file | 完了したオファーエクスポートのファイルを1つ読み取ります(OF54):SKU、商品、数量、価格などのエクスポート項目を含むオファーを JSON または CSV で返します |
shop_apotheke_list_product_imports | 商品インポートをリストします(P51):そのステータス(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、変換カウントと… |
shop_apotheke_get_product_import | 1つの商品のインポートのステータスを読み取ります(P42):インポートステータス、理由、変換カウントと統合の詳細… |
shop_apotheke_get_products | マーケットプレイスカタログ内の商品をその識別子(P31)によって検索し、マーケットプレイスの商品SKU、タイトル、カテゴリを取得します… |
shop_apotheke_list_product_offers | 指定された商品の各ショップのオファーをリストします(P11):最良価格でソートし、競合と価格を比較します。product_idsを指定してください… |
shop_apotheke_list_threads | 顧客とShop Apothekeとのメッセージスレッドをリストします(M11):トピック、関連する注文またはオファー、参加者、最終メッセージの日付、いつから… |
shop_apotheke_get_thread | 1つのメッセージスレッド(M10)をすべてのメッセージ、送信者、受信者、添付ファイル、関連する注文またはオファーと共に読み取ります |
shop_apotheke_list_returns | 返品リクエストをリストします(RT11):その状態、返品行、理由、RMA、追跡、関連する注文。状態、注文、または日付でフィルタリング… |
shop_apotheke_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金、メッセージの理由、そのラベルとショップが… |
shop_apotheke_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):そのコード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
shop_apotheke_list_invoices | Shop Apothekeがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金ありとなしの合計… |
shop_apotheke_list_transactions | ショップの取引行をリストします(TL02):注文金額、配送、手数料、返金、手動クレジットと支払い、金額、タイプ… |
shop_apotheke_list_document_requests | 会計文書リクエストをリストします(DR11):Shop ApothekeがEnhanced Seller Invoicingを実行する際に使用される:請求書とクレジットノート… |
shop_apotheke_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書、その他のファイル、ID、ファイル… |
shop_apotheke_list_channels | マーケットプレイスの販売チャネルをリストします(CH11):通常は国ごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
shop_apotheke_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例:フランス本土またはコルシカ。変更はまれです:呼び出してください… |
shop_apotheke_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12):例:標準、エクスプレス、またはピックアップ、コード、ラベル、追跡番号の有無… |
shop_apotheke_list_logistic_classes | マーケットプレイスの物流クラスをリストします(SH31):送料を決定するサイズまたは重量帯、コードとラベル。コードを… |
shop_apotheke_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します(OR21)。注文のすべての行をリストする必要があります。行を拒否すると、それは… |
shop_apotheke_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。shop_apotheke_list_carriersからcarrier_codeを指定するか、… |
shop_apotheke_ship_order | 配送中の注文が出荷されたことを確認します(OR24);それは出荷済みに移動し、顧客に通知されます。最初に追跡を設定します… |
shop_apotheke_update_offers | オファーを作成または更新します(OF24):価格と在庫を含む。各オファーを完全に置き換えます:省略したすべてのフィールドはリセットされます(欠けている… |
shop_apotheke_reply_thread | メッセージスレッド(M12)で顧客またはShop Apothekeに返信します。メッセージは即座に配信され、取り消すことはできません:ユーザーに… |
shop_apotheke_create_order_thread | 注文に関する新しいメッセージスレッドを開始します(OR43):顧客、Shop Apotheke、またはその両方に。メッセージは即座に配信されます:ユーザーに… |
shop_apotheke_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64):顧客の問題が解決された後。reason_codeはINCIDENT_CLOSE… |
shop_apotheke_accept_return | 受け入れ待ちの返品リクエストを受け入れるか拒否します(RT21)。Shop Apothekeが販売者バックオフィスで返品を処理する場合のみ… |
shop_apotheke_receive_return | 受け入れた返品の商品の到着を確認します(RT25)。返品は受領済みに移動します。ライブマーケットプレイスで動作します… |
shop_apotheke_import_products | 商品ファイルをマーケットプレイスに送信します(P41):カタログ内の商品を作成または強化します。file_urlはCSV、XLSX、またはXMLのアドレスです… |
shop_apotheke_import_offers | オファーファイルをインポートします(OF01):オファーを一括で作成、更新、または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除します… |
例のプロンプト
- "どのShop Apothekeの注文が私の承認を待っていますか?"
- "私のマグネシウムカプセルSKU MG-400-90の在庫を120に設定してください。"
- "どの返品リクエストが私の決定を待っていますか?"
- "注文6604412-AにDHL追跡00340434161234567891を追加し、出荷を確認してください。"
- "10月にShop Apothekeが発行した請求書を表示してください。"
FAQ
Shop Apotheke APIキーはどこで取得できますか? Shop Apothekeの販売者バックオフィスで:ユーザー名(右上)、My user settings、API key、次にGenerate a new key(または既存のキーをコピーします)。新しいキーを生成すると古いキーは無効になります。Shop Apothekeは各国ごとに別々の契約を締結するため、複数の国で販売する販売者は複数のショップを持ちます。複数のショップがある場合は、SHOP_APOTHEKE_SHOP_IDをこのコネクタが動作するショップに設定してください。
Shop Apothekeで誰が販売でき、どの国をカバーしていますか? Shop Apothekeは各パートナーを承認し、最初に商品フィードを確認する場合があり、国ごとに契約を締結します;パートナーページから申し込んでください。コネクタはドイツ、オーストリア、イタリア、ベルギーをカバーしています。マーケットプレイスはドイツとオーストリアで稼働中です;イタリア(redcare.it)とベルギー(farmaline.be)は独自の契約でパートナープログラムを運営しています。このアドレスで確認されているのはドイツとオーストリアのショップのみです;イタリアとベルギーのショップも使用していると想定されます。
注文をキャンセルしたり、返金したり、オファーを削除したりできますか? どのツールも返金や注文のキャンセルは行いません;それはShop Apothekeのバックオフィスで行ってください。注文を受け入れる際に行を拒否すると、それは永久にキャンセルされますので、AIはすべての書き込みを表示し、承諾を待ちます。shop_apotheke_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" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?