概要
AIエージェントからSarenzaマーケットプレイスでショップを運営: 注文、受け入れ、追跡と発送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはフランスで販売されており、あなたのSarenza販売者バックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
Sarenza Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Sarenza Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Sarenza Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセス。 サインインして、Connectors → Sarenza Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Sarenzaマーケットプレイス
AIエージェントからSarenzaマーケットプレイスでショップを運営: 注文、受け入れ、追跡と発送、インシデント、価格と在庫のオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはフランスで販売されており、あなたのSarenza販売者バックオフィスからショップAPIキーでサインインします。
セットアップ
国: フランス。
誰が販売できるか: Sarenzaは販売者を選定します。メールで連絡してください([email protected])。他のマーケットプレイスでの経験と、販売するブランドのフランスにおける公式ディストリビューターの地位を求められます。このコネクタには、Sarenzaがすでに開設した販売者アカウントが必要です。
このコネクタの販売者アドレスは、プラットフォームがこの小売業者に割り当てたものです。まだ販売者ガイドには名前が付けられていません。もしあなたの販売者バックオフィスが異なるアドレスで開設されている場合は、チャットでお知らせください。修正します。
セットアップには約5分かかります。
- Sarenza販売者バックオフィスにサインインします:
https://sarenza-prod.mirakl.net/login。 - バックオフィスでユーザー名(右上)を開き、マイユーザー設定 > APIキーを選択し、新しいキーを生成をクリックします(または既存のキーをコピーします)。それを
SARENZA_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になりますので、他のツールで使用している場合は動作しなくなります。 SARENZA_SHOP_IDは空のままにします。あなたのユーザーがSarenzaで複数のショップを管理している場合のみ、このコネクタが機能するショップの数値IDをSARENZA_SHOP_IDに設定します(バックオフィスのダッシュボードでIdentifierまたはShop IDの横に表示され、sarenza_get_accountによって返されます)。これがない場合はデフォルトのショップが使用されます。sarenza_get_accountをインストールして実行します: それはキーに属するショップを返します。
どこから始めるか: sarenza_get_accountはキーの背後にあるショップ(ID、名前、状態、通貨、チャネル)を表示します。日常業務には、sarenza_list_ordersを使用してorder_state_codes=WAITING_ACCEPTANCEの注文を、sarenza_list_offersを使用して価格と在庫を、sarenza_list_threadsを使用して返信を待っているメッセージを確認します。
商品と競合オファー: sarenza_get_productsは、EANまたは他の参照でSarenzaカタログ内の商品を検索し、マーケットプレイス商品SKUを返します。sarenza_list_product_offersは、指定された商品の各ショップのオファーをリストし、最安値を最初に表示します。1分あたり約5回の呼び出しが可能です。
注文ワークフロー: 新しい注文はWAITING_ACCEPTANCEで待機します。sarenza_accept_orderは各行を受け入れる(または拒否する)ことができます。顧客が請求された後、注文はSHIPPINGに移動します。その後、sarenza_update_trackingは運送業者と追跡番号を保存し(運送業者コードはsarenza_list_carriersから取得)、sarenza_ship_orderは出荷を確認します(SHIPPED)。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストには、sarenza_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、has_incident=trueでオープンインシデントを確認します。sarenza_resolve_incidentは、問題が解決された後、1つの注文行のインシデントを閉じます。注文に添付されたドキュメント(納品書、ラベル、顧客請求書)は、sarenza_list_order_documentsでリストされます。
書き込み: まず確認。 sarenza_accept_order、sarenza_update_tracking、sarenza_ship_order、sarenza_resolve_incident、sarenza_accept_return、sarenza_receive_return、sarenza_update_offers、sarenza_reply_thread、sarenza_create_order_thread、sarenza_import_productsは、ライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変更されるか(注文IDと行、追跡番号、古い価格と新しい価格のオファーSKU、メッセージテキストと受取人)を示し、はいを待ちます。注文行を拒否すると、その行は完全にキャンセルされます。ここでは、ツールが返金、注文のキャンセル、または資金の移動を行うことはありません。それはバックオフィスで行ってください。sarenza_import_offersはオファーを削除することができるため(REPLACEモードはファイルに存在しないすべてのオファーを削除します)、オフに切り替えられた状態でインストールされます。
オファーの更新(価格と在庫): sarenza_update_offers(OF24)は、オファー全体を置き換えます。省略したすべてのフィールドはリセットされます: quantityが欠けていると0になり、discountやdescriptionが欠けていると削除されます。常にオファーを最初に読み取り(sarenza_get_offerまたはsarenza_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を返します; 変更は非同期で適用されるため、再度オファーを読み取る前にsarenza_get_offer_importで確認してください。state_codeの条件コードはsarenza_list_offer_conditionsから、ロジスティッククラスコードはsarenza_list_logistic_classesから取得します。
ファイルインポート: sarenza_import_products(P41)およびsarenza_import_offers(OF01)は、Sarenzaが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタはそれをダウンロードしてSarenzaにアップロードします。sarenza_list_product_imports / sarenza_get_product_importおよびsarenza_list_offer_imports / sarenza_get_offer_importで追跡します。
返品: sarenza_list_returns(RT11)は返品リクエストをリストします。Sarenzaがショップに決定を任せる場合、sarenza_accept_returnはWAITING_ACCEPTANCEのリクエストを受け入れるか拒否し、sarenza_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。
メッセージ: sarenza_list_threadsは会話をリストします(特定の注文についてはentity_type=MMP_ORDERおよびentity_id=<order id>でフィルタリング; entity_typeなしのentity_idは拒否されます)、sarenza_get_threadはそのメッセージを読み取り、sarenza_reply_threadは応答します(受取人はCUSTOMERまたはOPERATOR、これはSarenzaです)、sarenza_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはsarenza_list_reasonsから取得します; マーケットプレイスがその言語を持っていることを知らない限り、localeは空のままにします(非アクティブなロケールは400で応答します)。
お金: sarenza_list_invoices(IV01)はSarenzaがショップに発行する会計文書をリストし、sarenza_list_transactions(TL02)は取引行(売上、手数料、返金、支払い)をリストします。SarenzaがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません; その場合はsarenza_list_document_requests(DR11)を使用し、その後取引を確認します。
参照リスト: sarenza_list_channels(国別サイト)、sarenza_list_carriers、sarenza_list_shipping_zones、sarenza_list_shipping_methodsおよびsarenza_list_logistic_classesはあまり変更されません; 会話ごとに一度読み取ります。
ページネーション: 注文、オファー、請求書および商品インポートはmax(最大100)およびoffsetでページングします。スレッド、返品、取引、文書リクエストおよびオファーインポートはnext_page_tokenを返します; 次のページを取得するためにpage_tokenとして渡します(他のフィルタは無視されます)まで、トークンがなくなるまで続けます。
日付はISO 8601形式、例: 2026-10-01T00:00:00Z; 応答はUTCで行われます。
レート制限: 各APIには独自の制限があり、Sarenzaはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、商品およびオファーのインポートは最大15分ごと、sarenza_get_accountおよび参照リストは約1日ごとに行います。429はRetry-Afterヘッダーを持ち、待機する秒数が示されます; ループで再試行しないでください。
エラー: 401はキーが間違っているか、新しいキーに置き換えられたことを意味し、403はこのアクションに対する権限が不足していることを示し、404はこのショップに対して注文、オファー、またはスレッドが存在しないことを示します。400は不正なパラメータまたは間違った状態の注文を示します(メッセージが名前を示します、例: ORDER_INVALID_STATE)。
前提条件: SARENZA_API_KEY
コネクタをローカルにインストールする
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
http://localhost:3000/connectors/storeを開き、Sarenza Marketplaceを選択し、前提条件の下にリストされた環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
sarenza_get_account | このマーケットプレイスでAPIキーの背後にあるショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレード、承認率、連絡先… |
sarenza_list_orders | 注文をリストします(OR11):その行、顧客、配送先住所、価格、状態、インシデント。状態でフィルタリング(例: WAITING_ACCEPTANCE… |
sarenza_list_offers | ショップのオファーをリストします(OF21):SKU、商品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
sarenza_get_offer | オファーID(OF22)によって1つのオファーを完全に読み取ります:すべての価格フィールド、割引、数量、状態、ロジスティッククラス、リードタイム、カスタム… |
sarenza_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新しいまたは中古のように、オファーを更新する際にstate_codeに入れるコードとともに |
sarenza_list_offer_imports | オファーのインポートと更新をリストします(OF04):ファイルからおよびsarenza_update_offersからのステータス(WAITING、RUNNING、COMPLETE、FAILED)、読み取られた行… |
sarenza_get_offer_import | 1つのオファーインポートまたはオファー更新(OF02)のステータスをそのimport_idによって読み取ります; sarenza_update_offersまたはsarenza_import_offersによって返されます… |
sarenza_export_offers | ショップの全オファーをファイルとしてエクスポートします(OF52)。sarenza_list_offers をページ送りする代わりに、カタログ全体(全SKUの価格と在庫)を読み取る方法です |
sarenza_get_offer_export_status | sarenza_export_offers で開始したオファーエクスポートのステータス(OF53):PENDING、COMPLETED、FAILED。完了後はファイルのURLを返します |
sarenza_get_offer_export_file | 完了したオファーエクスポートのファイルを1つ読み取ります(OF54):SKU、商品、数量、価格などのエクスポート項目を含むオファーを JSON または CSV で返します |
sarenza_list_product_imports | 商品インポートをリストします(P51):そのステータス(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、変換カウントと… |
sarenza_get_product_import | 1つの商品のインポートのステータスをそのimport_idによって読み取ります: インポートステータス、理由、変換カウントと統合の詳細… |
sarenza_get_products | マーケットプレイスカタログでその識別子(P31)によって商品を検索し、マーケットプレイス商品SKU、タイトル、カテゴリを取得します… |
sarenza_list_product_offers | 指定された商品の各ショップのオファーをリストします(P11):最安値でソートし、競合と価格を比較します。product_idsを指定します… |
sarenza_list_threads | 顧客とSarenzaとのメッセージスレッドをリストします(M11):トピック、リンクされた注文またはオファー、参加者、最終メッセージの日付、ショップがいつから… |
sarenza_get_thread | 1つのメッセージスレッド(M10)をすべてのメッセージ、送信者、受取人、添付ファイル、リンクされた注文またはオファーとともに読み取ります |
sarenza_list_returns | 返品リクエストをリストします(RT11):その状態、返品行、理由、RMA、追跡、リンクされた注文。状態、注文または日付でフィルタリング… |
sarenza_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金、メッセージの理由、そのラベルとショップが… |
sarenza_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):そのコード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
sarenza_list_invoices | Sarenzaがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金あり・なしの合計… |
sarenza_list_transactions | ショップの取引行をリストします(TL02):注文金額、配送、手数料、返金、手動クレジットと支払い、金額、タイプ… |
sarenza_list_document_requests | 会計文書リクエストをリストします(DR11):SarenzaがEnhanced Seller Invoicingを実行する際に使用される: 請求書とクレジットノート、Sarenzaまたは… |
sarenza_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書、その他のファイル、ID、ファイル… |
sarenza_list_channels | マーケットプレイスの販売チャネルをリストします(CH11):通常は国別サイトごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
sarenza_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例: 本土フランスまたはコルシカ。変更はあまりありません: 呼び出します… |
sarenza_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12):例: 標準、エクスプレスまたはピックアップ、コード、ラベル、追跡番号の有無… |
sarenza_list_logistic_classes | マーケットプレイスのロジスティッククラスをリストします(SH31):配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
sarenza_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します(OR21)。注文の各行をリストする必要があります。行を拒否するとキャンセルされます… |
sarenza_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。sarenza_list_carriersからcarrier_codeを指定するか、運送業者のURLを持つcarrier_nameを指定します… |
sarenza_ship_order | SHIPPINGの注文が発送されたことを確認します(OR24);それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
sarenza_update_offers | オファーを作成または更新します。価格と在庫を含みます(OF24)。各オファーを完全に置き換えます: 省略されたすべてのフィールドはリセットされます(欠けている… |
sarenza_reply_thread | メッセージスレッド(M12)で顧客またはSarenzaに返信します。メッセージは即座に配信され、取り消すことはできません: ユーザーに… |
sarenza_create_order_thread | 顧客、Sarenza、またはその両方との注文に関する新しいメッセージスレッドを開始します(OR43)。メッセージは即座に配信されます: ユーザーに… |
sarenza_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64)、顧客の問題が解決されたとき。reason_codeはINCIDENT_CLOSEである必要があります… |
sarenza_accept_return | WAITING_ACCEPTANCEの返品リクエストを受け入れるか拒否します(RT21)。Sarenzaが販売者バックオフィスで返品を処理し、… |
sarenza_receive_return | 受け入れられた返品の商品の到着を確認します(RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで動作します… |
sarenza_import_products | マーケットプレイスに商品ファイルを送信して(P41)、カタログ内の商品を作成または強化します。file_urlはCSV、XLSX、またはXMLのアドレスです… |
sarenza_import_offers | オファーファイルをインポートして(OF01)、オファーを一括で作成、更新、または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除し、… |
例のプロンプト
- "昨日以来受け入れ待ちのSarenzaの注文はどれですか?"
- "私の革ブーツSKU BT-CAMEL-39の在庫を4に設定します。"
- "私の決定を待っている返品リクエストはどれで、顧客はどんな理由を挙げていますか?"
- "注文3309182-Aの顧客にサイズ40が再入荷したことを返信します。"
- "私のオファーの中で非アクティブなものはどれで、なぜですか?"
次のステップ
このガイドは役に立ちましたか?