インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Mirakl Connect をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
概要
販売者向けの Mirakl Connect：接続したすべてのマーケットプレイスと販売チャネルの注文を一か所で、返品、注文書類、顧客との会話、価格と在庫を含む Connect カタログ。単一マーケットプレイス用の Mirakl Seller API とは別物です。出荷、キャンセル、受注承認はインストール時にオフです。
こう聞いてみよう
Mirakl Connect のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Mirakl Connect をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Mirakl Connect + Claude
販売者向けの Mirakl Connect：接続したすべてのマーケットプレイスと販売チャネルの注文を一か所で、返品、注文書類、顧客との会話、価格と在庫を含む Connect カタログ。単一マーケットプレイス用の Mirakl Seller API とは別物です。出荷、キャンセル、受注承認はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
MIRAKL_CONNECT_CLIENT_ID, MIRAKL_CONNECT_CLIENT_SECRET
ステップ 1 — 認証情報を取得
Mirakl Seller API ではありません: 別のコネクタ Mirakl Seller API（mirakl）は、Mirakl で動く1 つのマーケットプレイスと、そのマーケットプレイス独自の https://<marketplace>.mirakl.net/api を通じてショップ API キーでやり取りします。Mirakl Connect はその上にある販売者側のチャネルプラットフォームで、会社が運営するすべてのマーケットプレイスと販売チャネルに対して 1 つのログインと 1 つの API（https://miraklconnect.com/api）を提供し、独自の注文 ID、OAuth2 認証情報、エンドポイントを持ちます。会社で Mirakl Connect を使っている場合はこちらをインストールしてください。
設定は約 5 分です。
- Mirakl のガイド Integrating with Connect APIs（販売者向け Mirakl Connect ヘルプ）に従い、Mirakl Connect で会社用の OAuth2 API 認証情報を作成します。client ID と client secret が発行され、secret は一度しか表示されません。
- それらを
MIRAKL_CONNECT_CLIENT_IDとMIRAKL_CONNECT_CLIENT_SECRETに貼り付けます。AnythingMCP は Mirakl Authentication System（https://auth.mirakl.net/oauth/token、クライアントクレデンシャルグラント）でそれらを約 1 時間有効なベアラートークンに交換し、自動で更新します。 - コネクタをインストールし、
mirakl_connect_list_ordersを実行します。最新の注文が一覧表示され、認証情報が確認できます。
注文 ID とチャネル: 各注文には、mirakl_connect_get_order と書き込みツールが受け取る Connect の注文 ID（id）と、channel_order_id にあるチャネル独自の注文番号があります。販売チャネルとストアは origin（channel_name、channel_store_name）にあります。Mirakl Connect API には接続済みチャネルを一覧するエンドポイントがないため、AI は注文の origin からチャネルを読み取ります。
読み取れるデータ: 接続したすべてのチャネルの注文（更新の新しい順）。ステータス、流入元、注文明細（商品、数量、価格、税、明細ステータス）、配送と請求の情報、フルフィルメント種別（FULFILLED_BY_SELLER または FULFILLED_BY_PARTNER）を含みます。updated_from や ID を指定しない場合、Mirakl は直近 30 日分を返します。タイトル、ブランド、カテゴリ、GTIN、画像、通常価格と割引価格、在庫数量、属性を含む Connect の商品カタログ。全チャネルの返品と、そのステータス（REQUEST_INITIATED、REQUEST_DECLINED、OPENED、RECEIVED、CLOSED）、返品明細、方法、RMA ID、ラベル URL、追跡、却下理由。顧客向け請求書、納品書、返品ラベルなどの注文書類。注文に関する顧客との会話と、作成者、本文、添付ファイルを含む 1 つの会話のメッセージ。非同期の注文アクションの結果。
フィルター: 注文は statuses、updated_from、fulfillment_type、注文 ID で絞り込めます。返品には updated_from が必要です。書類には注文 ID か updated_from、会話には updated_from か会話 ID が必要です。
インストール時はオフ: mirakl_connect_ship_order（明細を出荷済みにし、配送業者と追跡番号をチャネルに渡します。通常チャネルが顧客に通知します）、mirakl_connect_cancel_order_lines（顧客はチャネル上で返金と通知を受けます。取り消せません）、mirakl_connect_accept_order_lines（AWAITING_ACCEPTANCE の明細を承認または拒否します。拒否すると明細はキャンセルされ、取り消せません）です。本番の販売チャネルに作用するため、管理者が意図的にオンにします。オンにした後も、AI は注文、明細、値を示してあなたの同意を待ち、明細 ID は注文の order_lines[].id から取ります。これらの呼び出しは非同期で action_id を返します。チャネルがまだアクションを拒否する可能性があるため、AI は mirakl_connect_get_action_status で結果を確認します。
ページングと制限: どの一覧も、続きがある間は next_page_token を返し、AI はそれを page_token として渡します。注文と返品は既定で 1 ページ 10 件（最大 100 件）、書類と会話は 50 件（最大 100 件）です。商品は 1 ページ最大 1000 件で、カタログ全体が必要でない限り AI は小さなページサイズを使います。Mirakl は同期の際、注文、返品、商品の一覧の呼び出しを 1 分に 1 回までにするよう求めています。日付はタイムゾーン付きの ISO 8601 です。
よくあるエラー: 401 は client ID または secret の誤り、あるいはトークンの期限切れを意味します。403 は API クライアントにその呼び出しのスコープ（例 connect:order:read、connect:shipment:create）がないことを意味します。402 はその機能（例：会話）がアカウントの Mirakl Connect プランに含まれていないことを意味します。404 は不明な注文 ID または会話 ID です。429 は呼び出しが多すぎることを意味します。Retry-After を待ってください。
このコネクタは価格や在庫の変更、会話への返信、返品の作成、新しいチャネルの接続は行いません。Mirakl Connect を使わずに 1 つの Mirakl マーケットプレイスを扱う場合は、Mirakl Seller API コネクタを使ってください。
ステップ 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 で Customize → Connectors を開きます。
- + をクリックし、Add custom connector を選びます。
- 名前（例:
Mirakl Connect）とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Add をクリックします。 - Connect をクリックし、AnythingMCP にサインイン（OAuth）してアクセスを許可します。
下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。
利用可能なツール
| Tool | What it does |
|---|---|
mirakl_connect_list_orders | List orders from every sales channel connected to Mirakl Connect, most recently updated first: Connect order id, channel order id, status… |
mirakl_connect_get_order | Get one order by its Mirakl Connect order id (the id field of mirakl_connect_list_orders, not the channel's order number): status, channel… |
mirakl_connect_list_products | List the products of your Mirakl Connect catalog, sorted by product id: id, titles, brand, category, GTINs, images, standard and discount… |
mirakl_connect_list_returns | List returns updated since a time, across channels: return id, channel return id, order id, channel (origin), status (REQUEST_INITIATED… |
mirakl_connect_list_order_documents | List the documents of orders (customer invoices, delivery slips, return labels, channel-specific documents) with order id, name, type, size… |
mirakl_connect_list_conversations | List customer conversations about orders, most recently updated first: id, linked order (entity), channel (origin), topic, participants… |
mirakl_connect_get_conversation | Read the messages of one conversation, newest first, with their author, text, attachments and dates |
mirakl_connect_get_action_status | Check the result of an asynchronous order action (shipment, cancellation, acceptance): status and any errors from the sales channel |
mirakl_connect_ship_order | Ship items of one order in one package with the same tracking: Mirakl Connect marks the lines shipped and passes carrier and tracking to… |
mirakl_connect_cancel_order_lines | Cancel all or part of order lines: Connect cancels them on the sales channel and the customer is refunded and notified there |
mirakl_connect_accept_order_lines | Accept or refuse order lines in AWAITING_ACCEPTANCE; Connect passes the decision to the sales channel |
プロンプトの例
- 「昨日以降に全チャネルで入った注文を、チャネルごとにまとめて教えてください。」
- 「チャネル注文番号 405-1234567-1234567 の注文を探して、明細とそのステータスを表示してください。」
- 「今週開始された返品を、チャネル、理由、追跡情報付きで一覧にしてください。」
- 「今日更新された顧客との会話を表示して、それぞれの顧客の要望を要約してください。」
- 「この注文の明細 1 を DHL の追跡番号 00340434161234567890 で出荷してください。先に注文と明細を見せてください。」
FAQ
Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。
次のステップ
このガイドは役に立ちましたか?