MediaMarkt MCP-сервер: заказы, цены и доставка

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди, кликни Connectors → MediaMarkt Marketplace, вставь свои учетные данные, создай API ключ MCP и готово. Никакого Docker, никакого git clone, никакого локального сервера.

MediaMarkt Marketplace

Управляй своим магазином на маркетплейсе MediaMarkt с помощью AI агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает в Германии, Австрии, Испании, Нидерландах, Италии, Бельгии, Швейцарии, Польше и Венгрии; войди с помощью API ключа магазина из своего личного кабинета продавца MediaMarkt.

Настройка

Страны: Германия, Австрия, Испания, Нидерланды, Италия, Бельгия, Швейцария, Польша и Венгрия. В Италии маркетплейс работает под брендом MediaWorld. Все страны используют одну платформу для продавцов.

Кто может продавать: MediaMarkt принимает заявки через форму для каждой страны, после чего проходит проверка бизнеса (KYC). Коннектор требует учетную запись продавца, которую MediaMarkt уже открыл.

Настройка занимает около 5 минут.

1. Войди в личный кабинет продавца MediaMarkt: https://mediamarktsaturn.mirakl.net/login.
2. В личном кабинете открой свое имя пользователя (в правом верхнем углу) > Мои настройки пользователя > API ключ и нажми Создать новый ключ (или скопируй существующий ключ). Вставь его в MEDIAMARKT_API_KEY. Ключ отправляется как есть в заголовке Authorization, без Bearer. Создание нового ключа делает старый недействительным, поэтому любой другой инструмент, использующий его, перестает работать.
3. MediaMarkt обычно открывает один магазин на страну, поэтому у большинства продавцов есть несколько магазинов под одной учетной записью. Если у твоей учетной записи больше одного магазина, установи MEDIAMARKT_SHOP_ID на числовой идентификатор магазина, с которым должен работать этот коннектор (показан на панели управления личного кабинета рядом с Идентификатором или ID магазина, и возвращается как shop_id с помощью mediamarkt_get_account); чтобы работать с несколькими магазинами, установи коннектор один раз для каждого магазина. Без этого используется твой магазин по умолчанию.
4. Установи и запусти mediamarkt_get_account: он возвращает магазин, к которому принадлежит ключ.

С чего начать: mediamarkt_get_account показывает магазин, связанный с ключом (идентификатор, имя, состояние, валюта и каналы). Для повседневной работы используй mediamarkt_list_orders с order_state_codes=WAITING_ACCEPTANCE, mediamarkt_list_offers для цен и наличия и mediamarkt_list_threads для сообщений, ожидающих ответа.

Продукты и конкурирующие предложения: mediamarkt_get_products ищет продукты в каталоге MediaMarkt по EAN или другому идентификатору и возвращает SKU продукта на маркетплейсе; mediamarkt_list_product_offers перечисляет предложения каждого магазина для заданных продуктов, сначала с лучшей ценой, примерно 5 вызовов в минуту.

Рабочий процесс заказов: новый заказ ожидает в WAITING_ACCEPTANCE. mediamarkt_accept_order принимает (или отказывает) каждую строку; после списания с клиента заказ переходит в SHIPPING. Затем mediamarkt_update_tracking сохраняет перевозчика и номер отслеживания (коды перевозчиков берутся из mediamarkt_list_carriers), а mediamarkt_ship_order подтверждает отправку (SHIPPED). Поздние состояния: TO_COLLECT, RECEIVED, CLOSED, REFUSED и CANCELED. Используй mediamarkt_list_orders с order_state_codes=WAITING_ACCEPTANCE для повседневного списка задач и has_incident=true для открытых инцидентов; mediamarkt_resolve_incident закрывает инцидент по одной строке заказа, как только он решен. Документы, прикрепленные к заказам (накладные, этикетки, счета клиентов), перечисляются с помощью mediamarkt_list_order_documents.

Записи: сначала подтверждай. mediamarkt_accept_order, mediamarkt_update_tracking, mediamarkt_ship_order, mediamarkt_resolve_incident, mediamarkt_accept_return, mediamarkt_receive_return, mediamarkt_update_offers, mediamarkt_reply_thread, mediamarkt_create_order_thread и mediamarkt_import_products действуют на живом маркетплейсе. Перед каждым вызовом показывай пользователю, что изменится (идентификатор заказа и строки, номер отслеживания, SKU предложения с старой и новой ценой или наличием, текст сообщения и получатели) и жди подтверждения. Отказ от строки заказа отменяет ее окончательно. Никакой инструмент здесь не возвращает деньги, не отменяет заказы и не перемещает деньги; делай это в личном кабинете. mediamarkt_import_offers может удалять предложения (режим REPLACE удаляет каждое предложение, отсутствующее в файле), поэтому он установлен выключенным.

Обновление предложений (цен и наличия): mediamarkt_update_offers (OF24) заменяет все предложение. Каждое поле, которое ты оставляешь пустым, сбрасывается: отсутствующее quantity становится 0, отсутствующая discount или description удаляется. Всегда сначала читай предложение (mediamarkt_get_offer или mediamarkt_list_offers с sku) и отправляй его обратно полностью с только предполагаемым изменением: shop_sku, product_id и product_id_type (из product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (его код), min_quantity_alert, description, discount, all_prices, available_started / available_ended (читай как available_start_date / available_end_date) и любые offer_additional_fields. Оставь update_delete пустым или update. Вызов возвращает import_id; изменение применяется асинхронно, поэтому проверь его с помощью mediamarkt_get_offer_import перед повторным чтением предложения. Код состояния для state_code берется из mediamarkt_list_offer_conditions, коды логистического класса из mediamarkt_list_logistic_classes.

Импорт файлов: mediamarkt_import_products (P41) и mediamarkt_import_offers (OF01) принимают URL CSV, XLSX или XML файла в формате, который запрашивает MediaMarkt; коннектор загружает его и загружает в MediaMarkt. Отслеживай их с помощью mediamarkt_list_product_imports / mediamarkt_get_product_import и mediamarkt_list_offer_imports / mediamarkt_get_offer_import.

Возвраты: mediamarkt_list_returns (RT11) перечисляет запросы на возврат. Где MediaMarkt позволяет магазину решать, mediamarkt_accept_return принимает или отказывает в WAITING_ACCEPTANCE, а mediamarkt_receive_return подтверждает, что товары прибыли. Возвраты остаются в личном кабинете.

Сообщения: mediamarkt_list_threads перечисляет разговоры (фильтруй с помощью entity_type=MMP_ORDER и entity_id=<order id> для одного заказа; entity_id без entity_type отклоняется), mediamarkt_get_thread читает один с его сообщениями, mediamarkt_reply_thread отвечает (получатель CUSTOMER или OPERATOR, который является MediaMarkt) и mediamarkt_create_order_thread открывает новый разговор по заказу. Код причин для тем берется из mediamarkt_list_reasons; оставь его locale пустым, если не знаешь, что маркетплейс поддерживает этот язык (неактивная локаль отвечает 400).

Деньги: mediamarkt_list_invoices (IV01) перечисляет бухгалтерские документы, которые MediaMarkt выдает магазину, а mediamarkt_list_transactions (TL02) — строки транзакций (продажи, комиссии, возвраты, выплаты). Если MediaMarkt использует расширенное выставление счетов для продавцов, IV01 не возвращает новые документы; используй mediamarkt_list_document_requests (DR11) и транзакции тогда.

Справочные списки: mediamarkt_list_channels (страницы стран), mediamarkt_list_carriers, mediamarkt_list_shipping_zones, mediamarkt_list_shipping_methods и mediamarkt_list_logistic_classes меняются редко; читай их один раз за разговор.

Пагинация: заказы, предложения, счета и импорты продуктов разбиваются на страницы с помощью max (максимум 100) и offset. Темы, возвраты, транзакции, запросы документов и импорты предложений возвращают next_page_token; передай его как page_token, чтобы получить следующую страницу (все другие фильтры тогда игнорируются), пока он не исчезнет.

Даты в формате ISO 8601, например, 2026-10-01T00:00:00Z; ответы в UTC.

Ограничения по скорости: У каждого API есть свои ограничения, и MediaMarkt может их ужесточить. Перечисление предложений и заказов предназначено для интерактивного использования, импорты продуктов и предложений — не чаще чем раз в 15 минут, mediamarkt_get_account и справочные списки примерно раз в день. Код 429 содержит заголовок Retry-After с количеством секунд для ожидания; не пытайся повторять в цикле.

Ошибки: 401 означает, что ключ неверен или был заменен на новый, 403 — что у твоего пользователя нет прав на это действие, 404 — что заказ, предложение или тема не существуют для этого магазина, 400 — неверный параметр или заказ в неверном состоянии (сообщение указывает на это, например, ORDER_INVALID_STATE).

Предварительные условия: MEDIAMARKT_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, выбери MediaMarkt Marketplace и вставь переменные окружения, указанные в предварительных условиях.

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

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

• "Перечисли мои заказы MediaMarkt, которые находятся в SHIPPING и еще не имеют номера отслеживания."
• "У кого лучшая цена на наушники с EAN 4548736132610 на MediaMarkt, и как моя цена соотносится?"
• "Какие из моих предложений MediaMarkt имеют менее 3 единиц на складе?"
• "Покажи открытые инциденты по моим заказам MediaMarkt и что написали клиенты."
• "Ответь клиенту в теме по заказу 4501234-A, что замена отправляется завтра."

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

• Подключись к Claude
• Подключись к ChatGPT