インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Mirakl Seller API をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
Mirakl を基盤とするあらゆるマーケットプレイス（Leroy Merlin、Conforama、BUT、home24、Maisons du Monde、Vente-unique、ePrice、Decathlon、Carrefour など多数）のショップを AI エージェントで運営します。注文、受注の承認、追跡と出荷、インシデント、価格と在庫を含むオファー、オファーと商品のインポート、顧客やオペレーターとのメッセージ、返品、注文書類、請求書、取引を扱います。マーケットプレイスごとに 1 つインストールします。
こう聞いてみよう
Mirakl Seller API のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Mirakl Seller API をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Mirakl
Mirakl を基盤とするあらゆるマーケットプレイス（Leroy Merlin、Conforama、BUT、home24、Maisons du Monde、Vente-unique、ePrice、Decathlon、Carrefour など多数）のショップを AI エージェントで運営します。注文、受注の承認、追跡と出荷、インシデント、価格と在庫を含むオファー、オファーと商品のインポート、顧客やオペレーターとのメッセージ、返品、注文書類、請求書、取引を扱います。マーケットプレイスごとに 1 つインストールします。
セットアップ
- マーケットプレイスのセラー用バックオフィス（運営者から案内された Mirakl ポータル）にサインインします。運営者ごとに独自の Mirakl インスタンスがあるため、コネクターはマーケットプレイスごとに 1 つインストールし（例: Leroy Merlin と Conforama）、それぞれにマーケットプレイス名を付けます。
- ポータルのアドレスをパスなしで
MIRAKL_URLにコピーします（主なマーケットプレイスのアドレスは下記のとおりです）。/apiは付けないでください。コネクターが自動で付けます。 - 右上のユーザー名をクリックし、My user settings の API Key タブを開いてキーを生成（または既存のキーをコピー）し、
Bearerを付けずにMIRAKL_API_KEYに貼り付けます。新しいキーを生成すると古いキーは無効になり、古いキーを使っている他のツールはすべて動かなくなります。 - ユーザーがこのマーケットプレイスで複数のショップを管理している場合のみ（home24 や Vente-unique でよくあります）、使うショップの数値 ID を
MIRAKL_SHOP_IDに設定します。空のままにするとデフォルトのショップを使います。 - コネクターをインストールし、
mirakl_get_accountを実行します。キーが属するショップが表示されます。
Mirakl で動いているマーケットプレイス: どこでもコネクターは同じで、変わるのはアドレスとキーだけです。
- Leroy Merlin (ADEO):
https://adeo-marketplace.mirakl.net - Conforama:
https://conforama-prod.mirakl.net - BUT:
https://but-prod.mirakl.net - home24:
https://home24.mirakl.net - Maisons du Monde:
https://maisonsdumonde-prod.mirakl.net - Vente-unique:
https://venteunique-prod.mirakl.net - ePrice:
https://marketplace.eprice.it
独自ドメインを使う運営者も含め、ほかの運営者でも同じように使えます。サインインしているセラー用バックオフィスのアドレスを指定してください。
注文とインシデント: AI は承認待ちの注文を一覧にし、明細ごとに承認または拒否し、配送業者と追跡番号を登録して出荷を確定します。インシデントが未解決の注文も探し、顧客の問題が解決したら mirakl_resolve_incident でその注文明細のインシデントをクローズします。注文に添付された書類（納品書、配送ラベル、顧客向け請求書）は名前、種類、アップロード日付きで一覧表示されます。ファイル自体はバックオフィスで開きます。
返品: AI は理由、RMA、追跡情報、関連する注文とともに返品リクエストを一覧にします。Mirakl の返品機能を使い、判断をショップに任せているマーケットプレイスでは、リクエストの承認または拒否と、商品が倉庫に届いたことの確認もできます。返金はバックオフィスで行います。
先に確認します: 受注の承認、追跡番号、出荷、インシデントのクローズ、返品の判断、オファーの更新、メッセージ、商品のインポートは本番のマーケットプレイスに反映されます。AI は変更内容（注文明細、追跡番号、変更前と変更後の価格または在庫、メッセージ本文）を示し、あなたの承認を待ちます。拒否した注文明細は完全にキャンセルされ、送信したメッセージは取り消せません。
価格と在庫: mirakl_update_offers はオファー全体を置き換え、省略した項目はリセットされます（数量がなければ 0 になります）。そのため AI はまずオファーを読み取り、変更点だけを反映した完全な内容で送り返します。mirakl_import_offers はインストール時に無効です。REPLACE モードではファイルにないオファーがすべて削除されるためです。
読み取れるデータ: 顧客、住所、インシデントを含む注文、自分のオファーと同じ商品に対する他ショップのオファー、メッセージ、返品、注文書類、運営者の請求書、取引明細（売上、手数料、返金、支払い）に加え、マーケットプレイスのチャネル（国別サイト）、配送業者、配送ゾーン、配送方法、物流クラスです。Enhanced Seller Invoicing を使うマーケットプレイスでは請求書一覧に新しい書類が表示されないため、AI は会計書類のリクエストと取引明細を読み取ります。
制限: Mirakl は API ごとに個別の制限を設けており、運営者はそれをさらに厳しくできます。商品とオファーのインポートは最短でも 15 分に 1 回、競合オファーとの比較は 1 分あたり約 5 回までです。429 の応答には待つべき秒数が示されます。
よくあるエラー: 401: キーが間違っている、新しいキーに置き換えられた、または別のマーケットプレイスのキーです。403: ユーザーにこの操作の権限がありません。404: 注文、オファー、スレッドがこのショップに存在しないか、MIRAKL_URL がセラー用バックオフィスのアドレスではありません。400: パラメーターが間違っているか、注文のステータスが対象外です。
このコネクターは返金、注文のキャンセル、資金の移動は行いません。また、1 つのインストールで扱うのは 1 つのマーケットプレイスと 1 つのショップです。
前提条件: MIRAKL_URL, MIRAKL_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 を開き、 Mirakl Seller API を選択し、前提条件に記載された環境変数を入力します。
利用可能なツール
| Tool | What it does |
|---|---|
mirakl_get_account | Read the shop behind the API key on this marketplace (A01): shop id and name, state, channels, currency, grade and approval rate, contact… |
mirakl_list_orders | List orders (OR11) with their lines, customer, shipping address, prices, state and incidents |
mirakl_list_offers | List the shop's offers (OF21): SKU, product, price and discount, all channel prices, quantity in stock, condition, lead time and whether… |
mirakl_get_offer | Read one offer in full by its Mirakl offer id (OF22): every price field, discount, quantity, condition, logistic class, lead time and… |
mirakl_list_offer_conditions | List the offer conditions (OF61) the marketplace accepts, e.g. new or used, with the code to put in state_code when updating offers |
mirakl_list_offer_imports | List offer imports and updates (OF04), from files and from mirakl_update_offers: status (WAITING, RUNNING, COMPLETE, FAILED), lines read… |
mirakl_get_offer_import | Read the status of one offer import or offer update (OF02) by its import_id, as returned by mirakl_update_offers or mirakl_import_offers… |
mirakl_list_product_imports | List product imports (P51) with their status (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), the transformation counts and the… |
mirakl_get_product_import | Read the status of one product import (P42) by its import_id: import status, reason, transformation counts and the integration details… |
mirakl_get_products | Look up products in the marketplace catalog by their identifiers (P31), e.g |
mirakl_list_product_offers | List the offers of every shop for given products (P11), sorted by best price, to compare your price with the competition |
mirakl_list_threads | List message threads (M11) with customers and the operator: topic, linked order or offer, participants, last message date and since when a… |
mirakl_get_thread | Read one message thread (M10) with all its messages, senders, recipients, attachments and the linked order or offer |
mirakl_list_returns | List return requests (RT11) with their state, return lines, reason, RMA, tracking and the linked order |
mirakl_list_reasons | List the marketplace's reason codes (RE01): incident, cancellation, refund and message reasons, with their labels and whether the shop may… |
mirakl_list_carriers | List the carriers the marketplace knows (SH21) with their code, label and tracking URL |
mirakl_list_invoices | List the operator's accounting documents for the shop (IV01): invoices and credit notes with period, totals with and without tax… |
mirakl_list_transactions | List the shop's transaction lines (TL02): order amounts, shipping, commissions, refunds, manual credits and payouts, with amount, type… |
mirakl_list_document_requests | List accounting document requests (DR11), used on marketplaces with Enhanced Seller Invoicing: invoices and credit notes the operator or… |
mirakl_list_order_documents | List the documents attached to one or more orders (OR72): delivery notes, shipping labels, customer invoices and other files, with id, file… |
mirakl_list_channels | List the marketplace's sales channels (CH11), usually one per country site, with code and label |
mirakl_list_shipping_zones | List the active shipping zones of the marketplace (SH11) with code and label, e.g. mainland France or Corsica |
mirakl_list_shipping_methods | List the active shipping methods of the marketplace (SH12), e.g. standard, express or pick-up, with code, label, whether a tracking number… |
mirakl_list_logistic_classes | List the marketplace's logistic classes (SH31), the size or weight bands that decide shipping prices, with code and label |
mirakl_accept_order | Accept or refuse the lines of an order waiting for acceptance (OR21) |
mirakl_update_tracking | Set the carrier and tracking number of an order (OR23) |
mirakl_ship_order | Confirm that an order in SHIPPING has been shipped (OR24); it moves to SHIPPED and the customer is notified |
mirakl_update_offers | Create or update offers, including price and stock (OF24) |
mirakl_reply_thread | Reply in a message thread (M12) to the customer or the operator |
mirakl_create_order_thread | Start a new message thread on an order (OR43) with the customer, the operator or both |
mirakl_resolve_incident | Mark the open incident on one order line as resolved (OR64), once the customer's problem is solved. reason_code must be an INCIDENT_CLOSE… |
mirakl_accept_return | Accept or refuse a return request in WAITING_ACCEPTANCE (RT21) |
mirakl_receive_return | Confirm that the goods of an accepted return arrived at your warehouse (RT25) |
mirakl_import_products | Send a product file to the marketplace (P41) to create or enrich products in its catalog. file_url is the address of a CSV, XLSX or XML… |
mirakl_import_offers | Import an offer file (OF01) to create, update or delete offers in bulk |
プロンプトの例
- 「今、承認待ちの注文はどれですか。また、インシデントが未解決の注文はどれですか。」
- 「EAN 3700123456789 の当社の価格を、このマーケットプレイスの他ショップのオファーと比較してください。」
- 「SKU LAMP-042 の在庫を 25 にしてください。ただし変更前に、現在のオファーと新しい値を見せてください。」
- 「注文 20481937-A に関する顧客のメッセージへの返信を下書きし、送信前に見せてください。」
- 「Leroy Merlin で当社の判断を待っている返品リクエストはどれですか。顧客ごとの返品理由も教えてください。」
- 「注文 20481937-A の顧客には代替品を送りました。その注文明細のインシデントをクローズしてください。ただし先に理由コードを見せてください。」
次のステップ
このガイドは役に立ちましたか?
