概要
販売者向けのSpartooマーケットプレイスWebサービス:顧客および配送詳細を含む注文、追跡番号付きの注文の受け入れと発送、返品、サイト上の商品の状態およびサイズごとの在庫更新。パートナーコードはフォームフィールドとして、XMLの回答はJSONとして読み取られます。
ガイド付きセットアップ
Spartoo Marketplace を Meta Muse に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Spartoo Marketplace を接続して、MCP URL を Meta Muse に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Spartoo Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Spartoo Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Spartoo Marketplace + Meta Muse
販売者向けの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 — 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 のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
Spartoo 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 は使えません。
利用可能なツール
| ツール | 何をするか |
|---|---|
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が使用する必要がある場合のみ、コネクタページでオンにしてください。
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?