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

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

Mirakl + Cursor

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

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

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

MIRAKL_URL, MIRAKL_API_KEY

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

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

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Mirakl.

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

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

• «Какие заказы сейчас ждут подтверждения и по каким заказам открыт инцидент?»
• «Сравните нашу цену для EAN 3700123456789 с предложениями других магазинов на этом маркетплейсе.»
• «Установите остаток для SKU LAMP-042 на 25, но сначала покажите мне текущее предложение и новые значения.»
• «Подготовьте ответ на сообщение покупателя по заказу 20481937-A и покажите его мне перед отправкой.»
• «Какие заявки на возврат на Leroy Merlin ждут нашего решения и какую причину указал каждый покупатель?»
• «Покупатель по заказу 20481937-A получил замену. Закрой инцидент по этой строке заказа, но сначала покажи мне код причины.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT