Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Mirakl Seller API одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Ведите свой магазин на любом маркетплейсе на базе Mirakl (Leroy Merlin, Conforama, BUT, home24, Maisons du Monde, Vente-unique, ePrice, Decathlon, Carrefour и многих других) с помощью ИИ-агента: заказы, подтверждение, трекинг и отгрузка, инциденты, предложения с ценами и остатками, импорт предложений и товаров, переписка с покупателями и оператором, возвраты, документы заказов, счета и транзакции. Одна установка на маркетплейс.
Попробуй спросить
Примеры промптов для Mirakl Seller API
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Mirakl Seller API, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Mirakl + ChatGPT
Ведите свой магазин на любом маркетплейсе на базе Mirakl (Leroy Merlin, Conforama, BUT, home24, Maisons du Monde, Vente-unique, ePrice, Decathlon, Carrefour и многих других) с помощью ИИ-агента: заказы, подтверждение, трекинг и отгрузка, инциденты, предложения с ценами и остатками, импорт предложений и товаров, переписка с покупателями и оператором, возвраты, документы заказов, счета и транзакции. Одна установка на маркетплейс.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
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 — Добавьте коннектор в ChatGPT
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.
- Перейди на chatgpt.com/plugins, нажми +, затем Add custom MCP server.
- Введи название, например Name:
Mirakl. - В разделе Connection укажи в поле Server URL адрес
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDи оставь Authentication на OAuth. - Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
- Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.
Доступные инструменты
| 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
Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?
