Руководство по коннектору9 мин чтенияMCP-инструментов: 357 языков

Как подключить Mirakl к Claude через MCP

Ведите свой магазин на любом маркетплейсе на базе Mirakl (Leroy Merlin, Conforama, BUT, home24, Maisons du Monde, Vente-unique, ePrice, Decathlon, Carrefour и многих других) с помощью ИИ-агента: заказы, подтверждение, трекинг и отгрузка, инциденты, предложения с ценами и остатками, импорт предложений и товаров, переписка с покупателями и оператором, возвраты, документы заказов, счета и транзакции. Одна установка на маркетплейс.

HCАвтор: команда HelpCodeОбновлено 19 окт. 2026 г.9 мин чтения Открытый код на GitHub

Установить Mirakl Seller API в Cloud — бесплатно на пробу Читать пошаговое руководство

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Mirakl Seller API

Run your shop on any Mirakl-powered marketplace (Leroy Merlin, Conforama, BUT, home24, Maisons du Monde, Vente-unique, ePrice, Decathlon, Carrefour and many more) from an AI agent: orders, acceptance, tracking and shipping, incidents, offers with prices and stock, offer and product imports, customer and operator messages, returns, order documents, invoices and transactions. One install per marketplace.

инструментов

Регион

INTL

Категория

Электронная коммерция

Аутентификация

API Key

Требуемые env-vars

MIRAKL_URLMIRAKL_API_KEY

Установить в Cloud одним кликом

7 дней бесплатно · Без карты

7 дней бесплатно
Без банковской карты
GDPR и готовность к SOC 2
Данные в ЕС, журналы аудита
Открытый код на GitHub
Open source · AGPL-3.0
Работает с ChatGPT, Claude, Gemini
Любой MCP-совместимый клиент

Пропустите установку. Заработает меньше чем за 2 минуты.

Начните бесплатный период на cloud.anythingmcp.com, добавьте Mirakl Seller API одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.

Начать бесплатный период

AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.

Кратко

Попробуй спросить

Примеры промптов для Mirakl Seller API

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Mirakl Seller API · live via MCP

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Mirakl Seller API, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Mirakl + Claude

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

MIRAKL_URL, MIRAKL_API_KEY

Шаг 1 — Получите учётные данные

Войдите в бэк-офис продавца на маркетплейсе (портал Mirakl, который вам выдал оператор). У каждого оператора свой экземпляр Mirakl, поэтому коннектор устанавливается отдельно для каждого маркетплейса (например, для Leroy Merlin и для Conforama), а каждую установку стоит назвать по её маркетплейсу.
Скопируйте адрес портала без пути в MIRAKL_URL (адреса популярных маркетплейсов приведены ниже). Не добавляйте /api: коннектор добавляет его сам.
Нажмите на имя пользователя в правом верхнем углу, откройте My user settings и вкладку API Key, создайте ключ (или скопируйте существующий) и вставьте его в MIRAKL_API_KEY без Bearer. Новый ключ делает старый недействительным, поэтому любой другой инструмент, который его использует, перестанет работать.
Только если ваш пользователь управляет несколькими магазинами на этом маркетплейсе (так часто бывает на home24 и Vente-unique): укажите в MIRAKL_SHOP_ID числовой 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

Другие операторы работают так же, в том числе со своим доменом: укажите адрес бэк-офиса продавца, в который вы входите.

Заказы и инциденты: ИИ выводит заказы, ожидающие подтверждения, подтверждает или отклоняет каждую строку, сохраняет перевозчика и трек-номер и подтверждает отгрузку. Он также находит заказы с открытым инцидентом и, когда проблема покупателя решена, закрывает инцидент по этой строке заказа через mirakl_resolve_incident. Документы, прикреплённые к заказу (накладные, транспортные этикетки, счета покупателю), выводятся с названием, типом и датой загрузки; сам файл открывается в бэк-офисе.

Возвраты: ИИ выводит заявки на возврат с причиной, RMA, трекингом и связанным заказом. На маркетплейсах, которые используют возвраты Mirakl и оставляют решение магазину, он может принять или отклонить заявку и подтвердить, что товар пришёл на ваш склад. Возмещения остаются в бэк-офисе.

Сначала подтверждение: подтверждение заказов, трекинг, отгрузка, закрытие инцидентов, решения по возвратам, изменения предложений, сообщения и импорт товаров действуют на живом маркетплейсе. ИИ показывает, что изменится (строки заказа, трек-номер, старая и новая цена или остаток, текст сообщения), и ждёт вашего согласия. Отклонённая строка заказа отменяется навсегда, а отправленное сообщение нельзя отозвать.

Цены и остатки: mirakl_update_offers заменяет предложение целиком, и каждое пропущенное поле сбрасывается (отсутствующее количество становится 0), поэтому ИИ сначала читает предложение и отправляет его обратно полностью, только с вашим изменением. mirakl_import_offers при установке отключён, потому что его режим REPLACE удаляет все предложения, которых нет в файле.

Что он читает: заказы с покупателем, адресом и инцидентами, ваши предложения и предложения других магазинов на те же товары, сообщения, возвраты, документы заказов, счета оператора и строки транзакций (продажи, комиссии, возмещения, выплаты), а также каналы продаж (сайты по странам), перевозчиков, зоны доставки, способы доставки и логистические классы маркетплейса. При Enhanced Seller Invoicing в списке счетов не появляются новые документы, и тогда ИИ читает запросы бухгалтерских документов и транзакции.

Ограничения: Mirakl ограничивает каждый API отдельно, и операторы могут ужесточить лимиты. Импорт товаров и предложений возможен не чаще раза в 15 минут, а сравнение с предложениями конкурентов допускает около 5 вызовов в минуту. Ответ 429 сообщает, сколько секунд нужно подождать.

Частые ошибки: 401: ключ неверный, заменён более новым или принадлежит другому маркетплейсу. 403: у вашего пользователя нет прав на это действие. 404: заказ, предложение или переписка не существует для этого магазина, либо MIRAKL_URL не является адресом бэк-офиса продавца. 400: неверный параметр или заказ в неподходящем статусе.

Коннектор не оформляет возмещения, не отменяет заказы и не переводит деньги, а каждая установка работает с одним маркетплейсом и одним магазином.

Шаг 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, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

Доступные инструменты

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 получил замену. Закрой инцидент по этой строке заказа, но сначала покажи мне код причины.»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Следующие шаги

Это руководство помогло?

Ваш агент для Mirakl Seller API в одном клике.

Установите коннектор, вставьте ключ, спросите Claude. 7 дней бесплатно, без банковской карты.

Начать бесплатно в облаке Self-host с Docker Связаться с отделом продаж

Как подключить Mirakl к Claude через MCP

Примеры промптов для Mirakl Seller API

Mirakl + Claude

Предварительные требования

Шаг 1 — Получите учётные данные

Шаг 2 — Установите адаптер

Шаг 3 — Добавьте коннектор в Claude

Доступные инструменты

Примеры запросов

FAQ

Следующие шаги

Ваш агент для Mirakl Seller API в одном клике.

Похожие руководства

Как подключить Mirakl к ChatGPT через MCP

Как подключить Mirakl к Cursor через MCP

Как подключить Mirakl к Gemini через MCP

Как подключить Mirakl к Meta Muse через MCP

Mirakl в MCP: управляйте Mirakl из любого AI-агента

Как подключить Avito к Claude через MCP