概要
販売者向けのSpartooマーケットプレイスWebサービス:顧客および配送詳細を含む注文、追跡番号付きの注文の受け入れと発送、返品、サイト上の商品の状態およびサイズごとの在庫更新。パートナーコードはフォームフィールドとして、XMLの回答はJSONとして読み取られます。
ガイド付きセットアップ
Spartoo Marketplace を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Spartoo Marketplace を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Spartoo Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Spartoo Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Spartoo Marketplace + Microsoft Copilot
販売者向けのSpartooマーケットプレイスWebサービス:顧客および配送詳細を含む注文、追跡番号付きの注文の受け入れと発送、返品、サイト上の商品の状態およびサイズごとの在庫更新。パートナーコードはフォームフィールドとして、XMLの回答はJSONとして読み取られます。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
SPARTOO_HOST, SPARTOO_PARTNER_KEY
ステップ1 — 認証情報を取得する
設定には約3分かかります。
- Spartooマーケットプレイスのバックオフィスにサインインし、Documentationを開き、次にWebservicesおよび任意のサービスページ(例:Exporting orders)を開きます。
- Webservice URLの行には、あなたのSpartooサイトのWebサービスアドレスが表示されます(例:
https://sws.spartoo.euまたはhttps://sws.spartoo.it)。/mp/の前の部分をSPARTOO_HOSTに入れます。 - 同じページの
partner行には、サインインしているときのあなたのユニークコードが表示されます。それをSPARTOO_PARTNER_KEYに入れます。ページにコードが表示されない場合は、Spartooマーケットプレイスの担当者にアカウントのWebサービスコードを尋ねてください。
開始する場所:spartoo_list_ordersを開始日と共に使用します。spartoo_get_orderは、IDによって1つの注文を読み取ります。
注文:注文はステータス11(確認済み)で到着します。spartoo_accept_orderはそれを2(準備中)に移動します:その後、名前、住所、運送業者は変更できなくなります。spartoo_ship_orderはそれを2から3(発送済み)に移動し、運送業者の追跡番号を付け、Spartooが顧客に追跡リンクをメールします。spartoo_cancel_order(ステータス41)は、オフに設定されています:顧客は返金され、元に戻すことはできません。ステータス45(荷物紛失)および47(荷物未配達)はSpartooによって設定されます。
返品:spartoo_list_returnsおよびspartoo_get_return。1つの返品は1つの製品を保持します。返品ステータス:2は受領待ち、3は拒否、4は荷物受領および返品受理、5は支払い済み、7は返金、14は商人の前払い返品ラベル待ち。このコネクタは返品を受け入れたり拒否したりしません。
製品と在庫:spartoo_check_product_statusは、製品がサイトにあるかどうかを示します(OK)、在庫切れ(OS)、作成されたがまだオンラインでない(EC)、または不明(KO)で、その理由を示します。spartoo_update_stockは1つのサイズの在庫を設定します。両方ともあなた自身の参照を使用します:reference_partenaireは1色の製品、size_referenceはその1サイズです。在庫0はそのサイズをサイトから削除します。
フィールドノート
- 注文IDおよび返品IDは、
90D813EA1A2365A8のような短いコードです。 - 注文日フィルターは
YYYY-MM-DD:hh:mm:ssと書かれ、日と時間の間にコロンがあります。返品日フィルターはUnixタイムスタンプ(秒単位)です。Spartooはタイムゾーンを文書化していません。 - 価格は注文サイトの通貨での小数点数です;
products_final_priceは割引後の単価に数量を掛けたものです。 - ピックアップポイントの注文には、配送先住所の代わりに
relay_infoがあります。 - テキスト値は文字列として到着し、数値も含まれます。リスト内の1つの注文または製品はオブジェクトとして到着し、複数は配列として到着します。
エラー:すべての回答にはコードが含まれています。1はエラーなしを意味します。-1および-2:パートナーコードが欠落または不明です。-3:日付またはIDが欠落しています。-4:日付形式が間違っています。-6および-28:注文または返品が見つかりません。-8:追跡番号が拒否されました。-9:注文はすでにそのステータスを持っています。-19:ステータスの順序が間違っています(2は11からのみ、3は2からのみ)。-14:製品が見つかりません。-16、-18および-20:在庫が変更されていません(不可能、すでにその値、またはサイズがもはや有効ではありません)。-30:注文が発送するには古すぎます。Spartooに連絡してください。-428:アカウントが無効化されました。-429:1時間にリクエストが多すぎます。コネクタは、失敗した呼び出しとして負のコードを報告します。
カバーされていないもの:製品の作成および編集、価格および割引(これらはXMLカタログファイルを通じて行われます)、梱包伝票、および返品の決定。
ステップ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 ウィンドウで試します。
Spartoo 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 は使えません。
利用可能なツール
| ツール | 何をするか |
|---|---|
spartoo_list_orders | 指定した日以降に行われた注文をリスト表示し、オプションで特定のステータスのもののみ表示します。各注文のroot.orders.orderの下に:orders_id、customers… |
spartoo_get_order | IDによって1つの注文を読み取ります:顧客および配送詳細(またはrelay_infoのピックアップポイント)、支払い方法、送料および価格、注文… |
spartoo_accept_order | 新しい注文を受け入れます:ステータス11(確認済み)から2(準備中)に移動します。その後、注文の名前、配送先住所、運送業者は… |
spartoo_ship_order | 受け入れた注文を運送業者の追跡番号で発送済みとしてマークします:ステータス2から3に移動し、Spartooが追跡リンクを顧客にメールします… |
spartoo_cancel_order | 発送されていない注文をキャンセルします(ステータス41)。顧客は注文を受け取らず、Spartooによって返金されます;元に戻すことはできません… |
spartoo_list_returns | 一定の時点以降に登録された返品をリスト表示し、オプションで特定のステータスのもののみ表示します。各返品のroot.returns.returnの下に:return_id… |
spartoo_get_return | 1つの注文の返品、またはIDによって1つの返品を読み取ります:返品IDおよび日付、ステータスIDおよび名前、理由、注文IDおよび返品された製品… |
spartoo_check_product_status | あなたの製品の1つがSpartooサイトにあるかどうかを確認します。root.products.productの下にあなたの参照、ステータス(サイト上のOK… |
spartoo_update_stock | 1つの製品の1サイズの在庫をリアルタイムで設定します。在庫0はそのサイズをサイトから削除します;すべてのサイズが0の製品はオフラインになります… |
例のプロンプト
- "月曜日以降に入ったSpartooの注文で、まだ受け入れられていないものはどれですか?"
- "注文90D813EA1A2365A8を受け入れ、Royal Mailの追跡AB123456789GBで発送します。"
- "受領待ちの返品はどれですか?"
- "私の製品REF-BOOT-221はオンラインですか?もしそうでないなら、なぜですか?"
- "REF-BOOT-221のサイズ38の在庫を6に設定します。"
FAQ
パートナーコードはどこから来るのですか? Spartooマーケットプレイスのバックオフィスで、Documentation、Webservices、任意のサービスページを開きます:partner行にはあなたのコードが表示され、Webservice URL行にはあなたのサイトのアドレスが表示されます。コードが表示されない場合は、Spartooマーケットプレイスの担当者に尋ねてください。
何をカバーし、何をカバーしないのですか? 顧客および配送詳細を含む注文、追跡番号付きの受け入れおよび発送、返品、製品の状態およびサイズごとの在庫をカバーします。返品を受け入れたり拒否したりすることはありません。ショッパーとしてSpartooカタログを検索するには、Spartoo Shopコネクタを使用してください。
どのツールがオフに設定されていますか? spartoo_cancel_order、キャンセルは顧客に返金され、元に戻すことはできません。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" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?