概要
AIエージェントからWortenマーケットプレイスでショップを運営します:注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはポルトガルで販売されており、Wortenの販売者バックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
Worten Marketplace を Claude に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Worten Marketplace を接続して、MCP URL を Claude に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
こう聞いてみよう
Worten Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comを直接使用してください。 サインインし、Connectors → Worten Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Wortenマーケットプレイス + Claude
AIエージェントからWortenマーケットプレイスでショップを運営します:注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはポルトガルで販売されており、Wortenの販売者バックオフィスからショップAPIキーでサインインします。
前提条件
コネクタに組み込まれている完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
WORTEN_API_KEY
ステップ 1 — 認証情報を取得する
国:ポルトガル。Wortenは2026年8月1日にスペイン市場から撤退したため、マーケットプレイスはポルトガルでのみ販売されます。
誰が販売できるか:Wortenは販売者ページのフォームを通じて申請を受け付けています。コネクタには、Wortenがすでに開設した販売者アカウントが必要です。
設定には約5分かかります。
- Wortenの販売者バックオフィスにサインインします:
https://marketplace.worten.pt/login。 - バックオフィスでユーザー名(右上)を開き、My user settings > API keyを選択し、Generate a new keyをクリックします(または既存のキーをコピーします)。それを
WORTEN_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になり、それを使用している他のツールは動作しなくなります。 WORTEN_SHOP_IDは空のままにします。ユーザーがWortenで複数のショップを管理している場合のみ、コネクタが動作するショップの数値IDをWORTEN_SHOP_IDに設定します(バックオフィスのダッシュボードでIdentifierまたはShop IDの隣に表示され、worten_get_accountによってshop_idとして返されます)。これがない場合はデフォルトのショップが使用されます。worten_get_accountをインストールして実行します:キーが属するショップを返します。
どこから始めるか:worten_get_accountはキーの背後にあるショップを表示します(ID、名前、状態、通貨、チャネル)。日常業務には、worten_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、価格と在庫にはworten_list_offers、返信を待っているメッセージにはworten_list_threadsを使用します。
製品と競合オファー:worten_get_productsはEANまたは他の参照によってWortenカタログ内の製品を検索し、マーケットプレイス製品SKUを返します;worten_list_product_offersは指定された製品の各ショップのオファーをリストし、最安値を最初に表示します(約5回の呼び出しが可能です)。
注文ワークフロー:新しい注文はWAITING_ACCEPTANCEで待機します。worten_accept_orderは各行を受け入れ(または拒否)します;顧客が請求されると、注文はSHIPPINGに移動します。その後、worten_update_trackingは運送業者と追跡番号を保存し(運送業者コードはworten_list_carriersから取得)、worten_ship_orderは出荷を確認します(SHIPPED)。後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストにはworten_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、オープンインシデントにはhas_incident=trueを使用します;worten_resolve_incidentは解決された後に1つの注文行のインシデントを閉じます。注文に添付されたドキュメント(納品書、ラベル、顧客請求書)はworten_list_order_documentsでリストされます。
書き込み:最初に確認してください。 worten_accept_order、worten_update_tracking、worten_ship_order、worten_resolve_incident、worten_accept_return、worten_receive_return、worten_update_offers、worten_reply_thread、worten_create_order_thread、worten_import_productsはライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変わるか(注文IDと行、追跡番号、古い価格と新しい価格のオファーSKU、メッセージテキストと受取人)を示し、はいを待ちます。注文行を拒否すると、それは完全にキャンセルされます。ここではどのツールも返金、注文のキャンセル、または資金の移動は行いません;それはバックオフィスで行ってください。worten_import_offersはオファーを削除することができます(REPLACEモードはファイルに存在しないすべてのオファーを削除します)、そのため、インストール時はオフに設定されています。
オファーの更新(価格と在庫):worten_update_offers(OF24)はオファー全体を置き換えます。省略したすべてのフィールドはリセットされます:省略したquantityは0になり、discountやdescriptionが省略されると削除されます。常にオファーを最初に読み取り(worten_get_offerまたはworten_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を返し、変更は非同期で適用されるため、再度オファーを読み取る前にworten_get_offer_importで確認してください。state_codeの条件コードはworten_list_offer_conditionsから、ロジスティッククラスコードはworten_list_logistic_classesから取得します。
ファイルインポート:worten_import_products(P41)およびworten_import_offers(OF01)は、Wortenが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタがそれをダウンロードしてWortenにアップロードします。worten_list_product_imports / worten_get_product_importおよびworten_list_offer_imports / worten_get_offer_importで追跡します。
返品:worten_list_returns(RT11)は返品リクエストをリストします。Wortenがショップに決定を任せる場合、worten_accept_returnはWAITING_ACCEPTANCEのものを受け入れるか拒否し、worten_receive_returnは商品が到着したことを確認します。返金はバックオフィスに留まります。
メッセージ:worten_list_threadsは顧客とWortenとの会話をリストします(1つの注文についてはentity_type=MMP_ORDERとentity_id=<order id>でフィルタリング;entity_typeなしのentity_idは拒否されます)、worten_get_threadはそのメッセージを読み取り、worten_reply_threadは回答します(受取人はCUSTOMERまたはOPERATOR、つまりWorten)およびworten_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはworten_list_reasonsから取得します;マーケットプレイスがその言語を持っていることを知っている場合を除き、そのlocaleは空のままにします(非アクティブなロケールは400で応答します)。
お金:worten_list_invoices(IV01)はWortenがショップに発行する会計文書をリストし、worten_list_transactions(TL02)は取引行(売上、手数料、返金、支払い)をリストします。WortenがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません;その場合はworten_list_document_requests(DR11)を使用し、その後取引を確認します。
参照リスト:worten_list_channels(国別サイト)、worten_list_carriers、worten_list_shipping_zones、worten_list_shipping_methodsおよびworten_list_logistic_classesはめったに変更されません;会話ごとに一度読み取ります。
ページネーション:注文、オファー、請求書および製品インポートはmax(最大100)およびoffsetでページ分けされます。スレッド、返品、取引、文書リクエストおよびオファーインポートはnext_page_tokenを返します;次のページを取得するためにpage_tokenとして渡します(他のすべてのフィルターはその後無視されます)までそれが欠落するまで続けます。
日付はISO 8601形式、例:2026-10-01T00:00:00Z;回答はUTCで行われます。
レート制限:各APIには独自の制限があり、Wortenはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、製品とオファーのインポートは最大でも15分ごと、worten_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 — Claudeにコネクタを追加する
あなたのサーバーURL:AnythingMCPで、MCP Servers → このコネクタがあるサーバーを開き、そのURLをコピーします(
https://cloud.anythingmcp.com/mcp/…)。このガイドでYOUR_SERVER_IDと表示される場所で使用します。
推奨パス:claude.ai webで動作し、設定ファイルを編集する必要はありません。
- Claudeで、Plugins(一部のプランではまだ Customize)→ Connectorsを開きます。
- + Addをクリックし、次にAdd custom connectorを選択します。
- 名前を入力します(例:
Worten Marketplace)とリモートMCPサーバーのURLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、次にContinue をクリックし、検出された設定のまま、もう一度 Continue をクリックします。 - Sign in now を選んで Add をクリックし、AnythingMCPにサインインしてアクセスを許可します。
以下のすべてのツールがチャットに表示されます:プロンプトの入力を開始してください。
利用可能なツール
| ツール | 機能 |
|---|---|
worten_get_account | このマーケットプレイスでのAPIキーの背後にあるショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレードと承認率、連絡先… |
worten_list_orders | 注文をリストします(OR11):その行、顧客、配送先住所、価格、状態、インシデントでフィルタリングします。状態でフィルタリング(例:WAITING_ACCEPTANCE… |
worten_list_offers | ショップのオファーをリストします(OF21):SKU、製品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
worten_get_offer | オファーIDによって1つのオファーを完全に読み取ります(OF22):すべての価格フィールド、割引、数量、状態、ロジスティッククラス、リードタイム、カスタム… |
worten_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新しいまたは中古の条件、オファーを更新する際にstate_codeに入れるコード |
worten_list_offer_imports | オファーのインポートと更新をリストします(OF04):ファイルからおよびworten_update_offersから:ステータス(WAITING、RUNNING、COMPLETE、FAILED)、読み取られた行… |
worten_get_offer_import | 1つのオファーインポートまたはオファー更新のステータスを読み取ります(OF02):worten_update_offersまたはworten_import_offersによって返されたimport_idによって… |
worten_export_offers | ショップの全オファーをファイルとしてエクスポートします(OF52)。worten_list_offers をページ送りする代わりに、カタログ全体(全SKUの価格と在庫)を読み取る方法です |
worten_get_offer_export_status | worten_export_offers で開始したオファーエクスポートのステータス(OF53):PENDING、COMPLETED、FAILED。完了後はファイルのURLを返します |
worten_get_offer_export_file | 完了したオファーエクスポートのファイルを1つ読み取ります(OF54):SKU、商品、数量、価格などのエクスポート項目を含むオファーを JSON または CSV で返します |
worten_list_product_imports | 製品インポートをリストします(P51):そのステータス(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、変換カウントと… |
worten_get_product_import | 1つの製品インポートのステータスを読み取ります(P42):インポートステータス、理由、変換カウントと統合の詳細… |
worten_get_products | その識別子(P31)によってマーケットプレイスカタログ内の製品を検索します:例:EAN、マーケットプレイス製品SKU、タイトル、カテゴリを取得します… |
worten_list_product_offers | 指定された製品の各ショップのオファーをリストします(P11):最安値でソートし、競合と価格を比較します。product_idsを指定します… |
worten_list_threads | 顧客とWortenとのメッセージスレッドをリストします(M11):トピック、リンクされた注文またはオファー、参加者、最後のメッセージ日付、ショップがいつから… |
worten_get_thread | 1つのメッセージスレッドを読み取ります(M10):すべてのメッセージ、送信者、受取人、添付ファイル、リンクされた注文またはオファー |
worten_list_returns | 返品リクエストをリストします(RT11):その状態、返品行、理由、RMA、追跡およびリンクされた注文。状態、注文または日付でフィルタリング… |
worten_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金およびメッセージの理由、ラベルとショップが… |
worten_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):そのコード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
worten_list_invoices | Wortenがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金あり・なしの合計… |
worten_list_transactions | ショップの取引行をリストします(TL02):注文金額、配送、手数料、返金、手動クレジットおよび支払い、金額、タイプ… |
worten_list_document_requests | 会計文書リクエストをリストします(DR11):WortenがEnhanced Seller Invoicingを実行する際に使用されます:Wortenまたは… |
worten_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書および他のファイル、ID、ファイル… |
worten_list_channels | マーケットプレイスの販売チャネルをリストします(CH11):通常は国別サイトごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
worten_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例:フランス本土またはコルシカ。変更はめったにありません:呼び出します… |
worten_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12):例:標準、エクスプレスまたはピックアップ、コード、ラベル、追跡番号の有無… |
worten_list_logistic_classes | マーケットプレイスのロジスティッククラスをリストします(SH31):配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
worten_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します(OR21)。注文のすべての行をリストする必要があります。行を拒否すると、それはキャンセルされます… |
worten_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。worten_list_carriersからcarrier_codeを指定するか、運送業者のURLを持つcarrier_nameを指定します… |
worten_ship_order | SHIPPINGの注文が出荷されたことを確認します(OR24);それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
worten_update_offers | オファーを作成または更新します。価格と在庫を含みます(OF24)。各オファーを完全に置き換えます:省略されたすべてのフィールドはリセットされます(省略された… |
worten_reply_thread | メッセージスレッド(M12)で顧客またはWortenに返信します。メッセージはすぐに配信され、取り消すことはできません:ユーザーに… |
worten_create_order_thread | 注文に関する新しいメッセージスレッドを開始します(OR43):顧客、Worten、またはその両方に。メッセージはすぐに配信されます:ユーザーに… |
worten_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64)、顧客の問題が解決された後。reason_codeはINCIDENT_CLOSEである必要があります… |
worten_accept_return | WAITING_ACCEPTANCEの返品リクエストを受け入れるか拒否します(RT21)。Wortenが販売者バックオフィスで返品を処理し、… |
worten_receive_return | 受け入れられた返品の商品の到着を確認します(RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで動作します… |
worten_import_products | 製品ファイルをマーケットプレイスに送信します(P41):カタログ内の製品を作成または強化します。file_urlはCSV、XLSX、またはXMLのアドレスです… |
worten_import_offers | オファーファイルをインポートします(OF01):オファーを一括で作成、更新、または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除し、… |
例のプロンプト
- "どのWortenの注文が私の受け入れを待っていますか?"
- "EAN 8806095299846のスマートフォンをWortenで私より安く販売しているのは誰ですか?"
- "注文3304512-AにCTT追跡番号DA123456789PTを設定し、出荷を確認します。"
- "私のWortenオファーの中で非アクティブなものはどれで、なぜですか?"
- "私の最後の支払いの取引を表示してください。"
FAQ
Claude CodeとClaude Desktopの両方で動作しますか? はい、両方をhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDにポイントしてください。
Worten APIキーはどこで取得できますか? Wortenの販売者バックオフィスで:ユーザー名(右上)、My user settings、API key、次にGenerate a new key(または既存のキーをコピーします)。新しいキーを生成すると古いキーは無効になります。ユーザーが複数のショップを持っている場合はWORTEN_SHOP_IDを設定します;そうでない場合はデフォルトのショップが使用されます。
Wortenで誰が販売でき、どの国をカバーしていますか? Wortenは販売者ページのフォームを通じて申請を受け付けています。コネクタはポルトガルをカバーしています。Wortenは2026年8月1日にスペイン市場から撤退したため、マーケットプレイスはポルトガルでのみ販売されます。
注文をキャンセルしたり、返金したり、オファーを削除したりできますか? どのツールも返金や注文のキャンセルは行いません;それはWortenのバックオフィスで行ってください。注文を受け入れる際に行を拒否すると、それは完全にキャンセルされます。そのため、AIはすべての書き込みを表示し、はいを待ちます。worten_import_offersはオフに設定されており、そのREPLACEモードはファイルに存在しないすべてのオファーを削除します;AIが使用する必要がある場合のみ、コネクタページでオンにしてください。
次のステップ
このガイドは役に立ちましたか?