概要
AIエージェントからRETIFマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはフランス、ベルギー、ドイツ、スペイン、イタリア、ルクセンブルク、オランダで販売されており、RETIFの販売者バックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
RETIF Marketplace を Gemini に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで RETIF Marketplace を接続して、MCP URL を Gemini に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
RETIF Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → RETIF Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
RETIFマーケットプレイス + Gemini
AIエージェントからRETIFマーケットプレイスでショップを運営する: 注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはフランス、ベルギー、ドイツ、スペイン、イタリア、ルクセンブルク、オランダで販売されており、RETIFの販売者バックオフィスからショップAPIキーでサインインします。
前提条件
コネクタに組み込まれている完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
RETIF_API_KEY
ステップ1 — 資格情報を取得する
国: フランス、ベルギー、ドイツ、スペイン、イタリア、ルクセンブルク、オランダ。1つの販売者アカウントがすべてのRETIF国で販売します。RETIFはビジネス専用です。
誰が販売できるか: RETIFはビジネス顧客に焦点を当てた販売者を受け入れます: 興味を登録するにはRETIFに連絡してください。販売者は顧客に直接請求書を発行し、発送します。セットアップや月額料金は不要です; RETIFは商品カテゴリに応じた販売ごとの手数料を請求します。コネクタには、RETIFがすでに開設した販売者アカウントが必要です。
RETIFは色のバリエーションのみをサポートします; 他のバリエーションタイプは別の製品としてリストされます。
セットアップには約5分かかります。
- RETIF販売者バックオフィスにサインインします:
https://marketplace.retif.eu/login。 - バックオフィスでユーザー名を開き(右上)、マイユーザー設定 > APIキーを選択し、新しいキーを生成をクリックします(または既存のキーをコピーします)。それを
RETIF_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーは無効になりますので、それを使用している他のツールは動作しなくなります。 RETIF_SHOP_IDは空のままにします。ユーザーがRETIFで複数のショップを管理している場合のみ、このコネクタが動作するショップの数値IDをRETIF_SHOP_IDに設定します(バックオフィスのダッシュボードで識別子またはショップIDの横に表示され、retif_get_accountによってshop_idとして返されます)。これがない場合は、デフォルトのショップが使用されます。retif_get_accountをインストールして実行します: それはキーに属するショップを返します。
どこから始めるか: retif_get_accountはキーの背後にあるショップ(ID、名前、状態、通貨、チャネル)を表示します。日常業務にはretif_list_ordersを使用し、order_state_codes=WAITING_ACCEPTANCE、価格と在庫にはretif_list_offers、返信を待っているメッセージにはretif_list_threadsを使用します。
製品と競合オファー: retif_get_productsはEANまたは他の参照によってRETIFカタログで製品を検索し、マーケットプレイス製品SKUを返します; retif_list_product_offersは指定された製品のすべてのショップのオファーをリストし、最良の価格を最初に表示し、約5回の呼び出しで行います。
注文ワークフロー: 新しい注文はWAITING_ACCEPTANCEで待機します。retif_accept_orderは各行を受け入れ(または拒否します); 顧客が引き落とされると、注文はSHIPPINGに移動します。その後、retif_update_trackingは運送業者と追跡番号を保存し(運送業者コードはretif_list_carriersから取得)、retif_ship_orderは出荷を確認します(SHIPPED)。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のやることリストにはretif_list_ordersをorder_state_codes=WAITING_ACCEPTANCEで使用し、オープンインシデントにはhas_incident=trueを使用します; retif_resolve_incidentは問題が解決されると1つの注文行のインシデントを閉じます。注文に添付された文書(納品書、ラベル、顧客請求書)はretif_list_order_documentsによってリストされます。
書き込み: まず確認してください。 retif_accept_order、retif_update_tracking、retif_ship_order、retif_resolve_incident、retif_accept_return、retif_receive_return、retif_update_offers、retif_reply_thread、retif_create_order_thread、retif_import_productsはライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変わるか(注文IDと行、追跡番号、古い価格または在庫と新しい価格を持つオファーSKU、メッセージテキストと受取人)を示し、はいを待ちます。注文行を拒否すると、それは完全にキャンセルされます。ここでのツールは、返金、注文のキャンセル、またはお金の移動を行いません; それはバックオフィスで行ってください。retif_import_offersはオファーを削除できます(REPLACEモードはファイルに存在しないすべてのオファーを削除します)、したがって、オフにスイッチされた状態でインストールされます。
オファーの更新(価格と在庫): retif_update_offers(OF24)はオファー全体を置き換えます。省略したフィールドはすべてリセットされます: 欠落したquantityは0になり、欠落したdiscountまたはdescriptionは削除されます。常にオファーを最初に読み取ります(retif_get_offerまたはretif_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を返します; 変更は非同期で適用されるため、再度オファーを読み取る前にretif_get_offer_importで確認してください。state_codeの条件コードはretif_list_offer_conditionsから、物流クラスコードはretif_list_logistic_classesから取得します。
ファイルインポート: retif_import_products(P41)およびretif_import_offers(OF01)は、RETIFが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取り、コネクタはそれをダウンロードしてRETIFにアップロードします。retif_list_product_imports / retif_get_product_importおよびretif_list_offer_imports / retif_get_offer_importで追跡します。
返品: retif_list_returns(RT11)は返品リクエストをリストします。RETIFがショップに決定を任せる場合、retif_accept_returnはWAITING_ACCEPTANCEで1つを受け入れるか拒否し、retif_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。
メッセージ: retif_list_threadsは顧客とRETIFとの会話をリストします(1つの注文のためにentity_type=MMP_ORDERおよびentity_id=<order id>でフィルタリング; entity_typeなしのentity_idは拒否されます)、retif_get_threadはそのメッセージを読み取り、retif_reply_threadは応答します(受取人はCUSTOMERまたはOPERATOR、これはRETIFです)およびretif_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはretif_list_reasonsから取得します; マーケットプレイスがその言語を持っていることを知っている場合を除き、そのlocaleは空のままにします(非アクティブなロケールは400で応答します)。
お金: retif_list_invoices(IV01)はRETIFがショップに発行する会計文書をリストし、retif_list_transactions(TL02)は取引行(販売、手数料、返金、支払い)をリストします。RETIFがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません; その場合はretif_list_document_requests(DR11)を使用し、その後取引を行います。
全カタログ: すべてのオファーを読み取るには(カタログ全体の在庫または価格チェック、オファーのカウント)、retif_export_offersでエクスポートを開始し、retif_get_offer_export_statusがCOMPLETEDと報告するまで約1分ごとにポーリングし、retif_get_offer_export_fileでファイルを1つずつ読み取ります; include_fieldsは必要な列のみを保持します。完全なエクスポートは1日に1回許可されます; それ以降の変更については、last_request_dateを渡します(差分エクスポート、最大1分ごと)。すべてのオファーをretif_list_offersでページングしないでください: これは一度に数件のオファー用に設計されており、大規模なカタログをページングすると429で応答します。
複数のショップ: すべてのツールはオプションのshop_idを受け取ります。このマーケットプレイスで複数のショップを管理しているユーザー(代理店、または国ごとの1つのショップ)は、1つのインストールでそれらすべてで作業できます: 各呼び出しでショップのIDを渡し、retif_get_accountと同じshop_idでどのショップかを確認します。shop_idがない場合、呼び出しはRETIF_SHOP_IDを使用するか、空の場合はユーザーのデフォルトショップを使用します。ユーザーにショップのIDを尋ねてください; バックオフィスに表示されます。
参照リスト: retif_list_channels(国サイト)、retif_list_carriers、retif_list_shipping_zones、retif_list_shipping_methodsおよびretif_list_logistic_classesはあまり変更されません; 会話ごとに1回読み取ります。
ページネーション: 注文、オファー、請求書および製品インポートはmax(最大100)およびoffsetでページングします。スレッド、返品、取引、文書リクエストおよびオファーインポートはnext_page_tokenを返します; 次のページを取得するにはそれをpage_tokenとして渡します(他のすべてのフィルターはその後無視されます)までそれが欠落するまで。
日付はISO 8601形式です、例: 2026-10-01T00:00:00Z; 応答はUTCで行われます。
レート制限: 各APIには独自の制限があり、RETIFはそれを厳しくすることがあります。オファーと注文のリストはインタラクティブな使用を目的としており、製品とオファーのインポートは最大15分ごと、retif_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 — Geminiにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Gemini CLI は ~/.gemini/settings.json(Windows では %USERPROFILE%\.gemini\settings.json)から MCP サーバーを読み込みます。次を追加してください:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します(またはシェルでgemini mcp list)。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう — Gemini CLI が
RETIFマーケットプレイスのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 何をするか |
|---|---|
retif_get_account | このマーケットプレイスでAPIキーの背後にあるショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレードと承認率、連絡先… |
retif_list_orders | 注文をリストします(OR11): その行、顧客、配送先住所、価格、状態、インシデント。状態でフィルタリングします(例: WAITING_ACCEPTANCE… |
retif_list_offers | ショップのオファーをリストします(OF21): SKU、製品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
retif_get_offer | オファーIDによって1つのオファーを完全に読み取ります(OF22):すべての価格フィールド、割引、数量、状態、物流クラス、リードタイム、カスタム… |
retif_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新規または中古、オファーを更新する際にstate_codeに入れるコード |
retif_list_offer_imports | オファーのインポートと更新をリストします(OF04)、ファイルからおよびretif_update_offersから: ステータス(WAITING、RUNNING、COMPLETE、FAILED)、読み取られた行、… |
retif_get_offer_import | 1つのオファーインポートまたはオファー更新のステータスを読み取ります(OF02): import_idによって、retif_update_offersまたはretif_import_offersによって返されます… |
retif_export_offers | ショップのすべてのオファーをファイルとしてエクスポートを開始します(OF52)、カタログ全体を読み取る方法(すべてのSKUと価格と在庫)… |
retif_get_offer_export_status | retif_export_offersで開始されたオファーエクスポートのステータス(OF53):PENDING、COMPLETEDまたはFAILED(エラーコードとエラー詳細付き)、… |
retif_get_offer_export_file | 完了したオファーエクスポートの1つのファイルを読み取ります(OF54):SKU、製品、数量、価格と他のエクスポートされたフィールドを持つオファー… |
retif_list_product_imports | 製品インポートをリストします(P51): ステータス(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、変換カウントと… |
retif_get_product_import | 1つの製品インポートのステータスを読み取ります(P42): インポートステータス、理由、変換カウントと統合の詳細… |
retif_get_products | マーケットプレイスカタログで製品をその識別子(P31)によって検索し、EANなどを使用してマーケットプレイス製品SKU、タイトル、カテゴリを取得します… |
retif_list_product_offers | 指定された製品のすべてのショップのオファーをリストします(P11)、最良の価格でソートし、競合と価格を比較します。product_idsを与えます… |
retif_list_threads | 顧客とRETIFとのメッセージスレッドをリストします(M11):トピック、リンクされた注文またはオファー、参加者、最終メッセージの日付とショップがいつから… |
retif_get_thread | 1つのメッセージスレッドを読み取ります(M10): すべてのメッセージ、送信者、受信者、添付ファイルとリンクされた注文またはオファー |
retif_list_returns | 返品リクエストをリストします(RT11): ステータス、返品行、理由、RMA、追跡とリンクされた注文。状態、注文または日付でフィルタリング… |
retif_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金およびメッセージの理由、ラベルとショップが… |
retif_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):コード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
retif_list_invoices | RETIFがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金ありとなしの合計… |
retif_list_transactions | ショップの取引行をリストします(TL02):注文金額、送料、手数料、返金、手動クレジットと支払い、金額、タイプ… |
retif_list_document_requests | 会計文書リクエストをリストします(DR11)、RETIFがEnhanced Seller Invoicingを実行する際に使用されます: 請求書とクレジットノート… |
retif_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書および他のファイル、ID、ファイル… |
retif_list_channels | マーケットプレイスの販売チャネルをリストします(CH11)、通常は国サイトごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
retif_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例: 本土フランスまたはコルシカ。変更はまれです: 呼び出します… |
retif_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12)、例: 標準、エクスプレスまたはピックアップ、コード、ラベル、追跡番号の有無… |
retif_list_logistic_classes | マーケットプレイスの物流クラスをリストします(SH31)、配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
retif_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します(OR21)。注文の各行をリストする必要があります。行を拒否するとそれはキャンセルされます… |
retif_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。retif_list_carriersからcarrier_codeを与えるか、運送業者のURLを持つcarrier_nameを使用します… |
retif_ship_order | SHIPPINGの注文が出荷されたことを確認します(OR24);それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
retif_update_offers | オファーを作成または更新します、価格と在庫を含む(OF24)。各オファーを完全に置き換えます: 省略されたすべてのフィールドはリセットされます(欠落した… |
retif_reply_thread | メッセージスレッド(M12)で顧客またはRETIFに返信します。メッセージは即座に配信され、取り消すことはできません: ユーザーにテキストを示します… |
retif_create_order_thread | 注文に関する新しいメッセージスレッドを開始します(OR43)、顧客、RETIF、またはその両方と。メッセージは即座に配信されます: ユーザーにテキストを示します… |
retif_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64)、顧客の問題が解決されたとき。reason_codeはINCIDENT_CLOSEでなければなりません… |
retif_accept_return | WAITING_ACCEPTANCEの返品リクエストを受け入れるか拒否します(RT21)。RETIFが販売者バックオフィスで返品を処理し、… |
retif_receive_return | 受け入れられた返品の商品の到着を倉庫で確認します(RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで動作します… |
retif_import_products | 製品ファイルをマーケットプレイスに送信します(P41): カタログに製品を作成または豊かにします。file_urlはCSV、XLSX、またはXMLのアドレスです… |
retif_import_offers | オファーファイルをインポートします(OF01): オファーを一括で作成、更新、または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除し、… |
例のプロンプト
- "ビジネス顧客からのRETIFの注文で、私の承認を待っているものはどれで、どの国からですか?"
- "私の黒いハンガーパックSKU RT-HNG-100の在庫を500に設定し、価格はそのままにします。"
- "注文7701234-AにDPD追跡15501234567892を追加し、出荷を確認します。"
- "私のRETIFカタログをエクスポートし、在庫が20未満のすべてのオファーをリストします。"
- "先月の取引を表示します: 売上と手数料。"
FAQ
RETIF APIキーはどこで取得し、複数のショップを運営している場合はどうなりますか? RETIF販売者バックオフィスで: ユーザー名(右上)、マイユーザー設定、APIキー、次に新しいキーを生成(または既存のキーをコピー)。新しいキーを生成すると古いキーは無効になります。キーはユーザーに属し、1つのショップに属するものではありません: RETIFで複数のショップがある場合、コネクタがデフォルトで使用すべきショップにRETIF_SHOP_IDを設定するか、AIに各呼び出しでshop_idを渡してすべてのショップで作業させます。どちらもない場合は、デフォルトのショップが使用されます。
RETIFで販売できるのは誰で、どの国をカバーしていますか? RETIFはビジネス顧客に焦点を当てた販売者を受け入れます: 興味を登録するにはRETIFに連絡してください。販売者は顧客に直接請求書を発行し、発送します。セットアップや月額料金は不要です; RETIFは商品カテゴリに応じた販売ごとの手数料を請求します。コネクタはフランス、ベルギー、ドイツ、スペイン、イタリア、ルクセンブルク、オランダをカバーします。1つの販売者アカウントがすべてのRETIF国で販売します。RETIFはビジネス専用です。RETIFは色のバリエーションのみをサポートします; 他のバリエーションタイプは別の製品としてリストされます。
カタログ全体をチェックできますか、注文をキャンセルしたり、返金したり、オファーを削除したりできますか? はい、カタログについては: すべてのオファーの在庫または価格チェックのために、AIはretif_export_offersでエクスポートを開始し、retif_get_offer_export_statusが完了と報告するまで待ち、retif_get_offer_export_fileでファイルを読み取ります(完全なエクスポートは1日に1回、日付以降の変更は最大1分ごと)。どのツールも注文を返金またはキャンセルすることはありません; それはRETIFバックオフィスで行ってください。注文を受け入れる際に行を拒否すると、それは完全にキャンセルされるため、AIはすべての書き込みを表示し、はいを待ちます。retif_import_offersはオフにスイッチされてインストールされます; そのREPLACEモードはファイルに存在しないすべてのオファーを削除します; AIが使用する必要がある場合のみ、コネクタページでオンにします。
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?