MediaMarkt MCP для Gemini CLI

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

MediaMarkt Marketplace + Gemini

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

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

Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

MEDIAMARKT_API_KEY

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

Страны: Германия, Австрия, Испания, Нидерланды, Италия, Бельгия, Швейцария, Польша и Венгрия. В Италии маркетплейс работает под брендом 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=<идентификатор заказа> для одного заказа; 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).

Шаг 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 — Добавь коннектор в Gemini

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

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты MediaMarkt Marketplace.

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

Примеры подсказок

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

Часто задаваемые вопросы

Где я могу получить API-ключ MediaMarkt? В личном кабинете продавца MediaMarkt: твое имя пользователя (в правом верхнем углу), Мои настройки пользователя, API-ключ, затем Сгенерировать новый ключ (или скопировать существующий ключ). Генерация нового ключа делает старый недействительным. MediaMarkt обычно открывает один магазин на страну, поэтому у большинства продавцов несколько магазинов под одной учетной записью. Если у тебя больше одного магазина, установи MEDIAMARKT_SHOP_ID на магазин, с которым должен работать этот коннектор.

Кто может продавать на MediaMarkt и какие страны он охватывает? MediaMarkt принимает заявки через форму для каждой страны, после чего следует проверка бизнеса (KYC). Коннектор охватывает Германию, Австрию, Испанию, Нидерланды, Италию, Бельгию, Швейцарию, Польшу и Венгрию. В Италии маркетплейс работает под брендом MediaWorld. Все страны используют одну платформу для продавцов.

Может ли он отменять заказы, возвращать деньги или удалять предложения? Ни один инструмент не возвращает деньги или не отменяет заказ; делай это в личном кабинете MediaMarkt. Отказ от позиции при принятии заказа отменяет её навсегда, поэтому AI показывает тебе каждую запись и ждет согласия. mediamarkt_import_offers установлен выключенным, потому что его режим REPLACE удаляет каждое предложение, отсутствующее в файле; включай его на странице коннектора только если AI должен его использовать.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

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