Conectar MediaMarkt MCP con Gemini CLI

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Marketplace de MediaMarkt, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Marketplace de MediaMarkt + Gemini

Gestiona tu tienda en el marketplace de MediaMarkt desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidencias, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en Alemania, Austria, España, los Países Bajos, Italia, Bélgica, Suiza, Polonia y Hungría; inicia sesión con la clave API de tienda de tu oficina de vendedor de MediaMarkt.

Requisitos previos

Consulta las instrucciones de configuración completas integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

MEDIAMARKT_API_KEY

Paso 1 — Obtener credenciales

Países: Alemania, Austria, España, los Países Bajos, Italia, Bélgica, Suiza, Polonia y Hungría. En Italia, el marketplace opera como MediaWorld. Todos los países comparten una plataforma de vendedor.

Quién puede vender: MediaMarkt acepta solicitudes a través de un formulario por país, seguido de una verificación de negocio (KYC). El conector necesita una cuenta de vendedor que MediaMarkt ya ha abierto.

La configuración tarda unos 5 minutos.

1. Inicia sesión en la oficina de vendedor de MediaMarkt: https://mediamarktsaturn.mirakl.net/login.
2. En la oficina de vendedor, abre tu nombre de usuario (arriba a la derecha) > Mis configuraciones de usuario > Clave API y haz clic en Generar una nueva clave (o copia la clave existente). Pégala en MEDIAMARKT_API_KEY. La clave se envía tal cual en el encabezado Authorization, sin Bearer. Generar una nueva clave invalida la anterior, así que cualquier otra herramienta que la use dejará de funcionar.
3. MediaMarkt generalmente abre una tienda por país, por lo que la mayoría de los vendedores tienen varias tiendas bajo un mismo usuario. Si tu usuario tiene más de una tienda, establece MEDIAMARKT_SHOP_ID al id numérico de la tienda en la que debe funcionar este conector (mostrado en el panel de control de la oficina de vendedor junto a Identificador o ID de tienda, y devuelto como shop_id por mediamarkt_get_account); para trabajar en varias tiendas, instala el conector una vez por tienda. Sin esto, se usará tu tienda predeterminada.
4. Instala y ejecuta mediamarkt_get_account: devuelve la tienda a la que pertenece la clave.

Dónde empezar: mediamarkt_get_account muestra la tienda detrás de la clave (id, nombre, estado, moneda y canales). Para el trabajo diario, usa mediamarkt_list_orders con order_state_codes=WAITING_ACCEPTANCE, mediamarkt_list_offers para precios y stock y mediamarkt_list_threads para mensajes que esperan respuesta.

Productos y ofertas competidoras: mediamarkt_get_products busca productos en el catálogo de MediaMarkt por EAN u otra referencia y devuelve el SKU del producto en el marketplace; mediamarkt_list_product_offers lista las ofertas de cada tienda para productos dados, mejor precio primero, a aproximadamente 5 llamadas por minuto.

Flujo de trabajo de pedidos: un nuevo pedido espera en WAITING_ACCEPTANCE. mediamarkt_accept_order acepta (o rechaza) cada línea; después de que se debite al cliente, el pedido pasa a SHIPPING. Luego, mediamarkt_update_tracking almacena el transportista y el número de seguimiento (los códigos de transportista provienen de mediamarkt_list_carriers) y mediamarkt_ship_order confirma el envío (SHIPPED). Los estados posteriores son TO_COLLECT, RECEIVED, CLOSED, REFUSED y CANCELED. Usa mediamarkt_list_orders con order_state_codes=WAITING_ACCEPTANCE para la lista de tareas diaria y has_incident=true para incidencias abiertas; mediamarkt_resolve_incident cierra una incidencia en una línea de pedido una vez que se resuelve. Los documentos adjuntos a los pedidos (notas de entrega, etiquetas, facturas de clientes) se listan mediante mediamarkt_list_order_documents.

Escrituras: confirma primero. 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 y mediamarkt_import_products actúan en el marketplace en vivo. Antes de cada llamada, muestra al usuario qué cambiará (id y líneas del pedido, número de seguimiento, SKU de la oferta con el precio o stock antiguo y nuevo, el texto del mensaje y los destinatarios) y espera un sí. Rechazar una línea de pedido la cancela de forma definitiva. Ninguna herramienta aquí reembolsa, cancela pedidos o mueve dinero; hazlo en la oficina de vendedor. mediamarkt_import_offers puede eliminar ofertas (el modo REPLACE elimina cada oferta que falta en el archivo), por lo que se instala apagado.

Actualización de ofertas (precios y stock): mediamarkt_update_offers (OF24) reemplaza toda la oferta. Cada campo que dejes fuera se restablece: una quantity faltante se convierte en 0, un discount o description faltante se elimina. Siempre lee la oferta primero (mediamarkt_get_offer o mediamarkt_list_offers con sku) y devuélvela completa con solo el cambio previsto: shop_sku, product_id y product_id_type (de product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (su código), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leído como available_start_date / available_end_date) y cualquier offer_additional_fields. Deja update_delete vacío o update. La llamada devuelve un import_id; el cambio se aplica de forma asíncrona, así que revísalo con mediamarkt_get_offer_import antes de leer la oferta nuevamente. Los códigos de condición para state_code provienen de mediamarkt_list_offer_conditions, los códigos de clase logística de mediamarkt_list_logistic_classes.

Importaciones de archivos: mediamarkt_import_products (P41) y mediamarkt_import_offers (OF01) toman la URL de un archivo CSV, XLSX o XML en el formato de archivo que MediaMarkt solicita; el conector lo descarga y lo sube a MediaMarkt. Rastreálos con mediamarkt_list_product_imports / mediamarkt_get_product_import y mediamarkt_list_offer_imports / mediamarkt_get_offer_import.

Devoluciones: mediamarkt_list_returns (RT11) lista las solicitudes de devolución. Donde MediaMarkt deja que la tienda decida, mediamarkt_accept_return acepta o rechaza una en WAITING_ACCEPTANCE y mediamarkt_receive_return confirma que los bienes han llegado. Los reembolsos permanecen en la oficina de vendedor.

Mensajes: mediamarkt_list_threads lista conversaciones (filtra con entity_type=MMP_ORDER y entity_id=<order id> para un pedido; entity_id sin entity_type es rechazado), mediamarkt_get_thread lee uno con sus mensajes, mediamarkt_reply_thread responde (destinatario CUSTOMER o OPERATOR, que es MediaMarkt) y mediamarkt_create_order_thread abre una nueva conversación sobre un pedido. Los códigos de razón para temas provienen de mediamarkt_list_reasons; deja su locale vacío a menos que sepas que el marketplace tiene ese idioma (un locale inactivo responde 400).

Dinero: mediamarkt_list_invoices (IV01) lista los documentos contables que MediaMarkt emite a la tienda y mediamarkt_list_transactions (TL02) las líneas de transacción (ventas, comisiones, reembolsos, pagos). Si MediaMarkt utiliza la facturación mejorada para vendedores, IV01 no devuelve nuevos documentos; usa mediamarkt_list_document_requests (DR11) y las transacciones entonces.

Listas de referencia: mediamarkt_list_channels (sitios de país), mediamarkt_list_carriers, mediamarkt_list_shipping_zones, mediamarkt_list_shipping_methods y mediamarkt_list_logistic_classes cambian raramente; léelos una vez por conversación.

Paginación: pedidos, ofertas, facturas e importaciones de productos se paginan con max (máximo 100) y offset. Hilos, devoluciones, transacciones, solicitudes de documentos e importaciones de ofertas devuelven un next_page_token; pásalo como page_token para obtener la siguiente página (todos los demás filtros se ignoran) hasta que falte.

Fechas son ISO 8601, por ejemplo, 2026-10-01T00:00:00Z; las respuestas están en UTC.

Límites de tasa: Cada API tiene su propio límite y MediaMarkt puede endurecerlos. Listar ofertas y pedidos está destinado a uso interactivo, importaciones de productos y ofertas como máximo cada 15 minutos, mediamarkt_get_account y las listas de referencia aproximadamente una vez al día. Un 429 lleva un encabezado Retry-After con los segundos a esperar; no intentes de nuevo en un bucle.

Errores: 401 significa que la clave es incorrecta o fue reemplazada por una más nueva, 403 que tu usuario no tiene el derecho para esta acción, 404 que el pedido, oferta o hilo no existe para esta tienda, 400 un parámetro incorrecto o un pedido en el estado incorrecto (el mensaje lo nombra, por ejemplo, ORDER_INVALID_STATE).

Paso 2 — Instalar el adaptador

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

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Marketplace de MediaMarkt.

Herramientas disponibles

Ejemplos de comandos

• "Lista mis pedidos de MediaMarkt que están en SHIPPING y aún no tienen número de seguimiento."
• "¿Quién tiene el mejor precio para los auriculares con EAN 4548736132610 en MediaMarkt, y dónde se encuentra el mío?"
• "¿Cuáles de mis ofertas de MediaMarkt tienen menos de 3 unidades restantes?"
• "Muestra las incidencias abiertas en mis pedidos de MediaMarkt y lo que escribieron los clientes."
• "Responde al cliente en el hilo del pedido 4501234-A que el reemplazo se envía mañana."

Preguntas frecuentes

¿Dónde obtengo la clave API de MediaMarkt? En la oficina de vendedor de MediaMarkt: tu nombre de usuario (arriba a la derecha), Mis configuraciones de usuario, Clave API, luego Generar una nueva clave (o copia la clave existente). Generar una nueva clave invalida la anterior. MediaMarkt generalmente abre una tienda por país, por lo que la mayoría de los vendedores tienen varias tiendas bajo un mismo usuario. Con más de una tienda, establece MEDIAMARKT_SHOP_ID a la tienda en la que debe funcionar este conector.

¿Quién puede vender en MediaMarkt y qué países cubre? MediaMarkt acepta solicitudes a través de un formulario por país, seguido de una verificación de negocio (KYC). El conector cubre Alemania, Austria, España, los Países Bajos, Italia, Bélgica, Suiza, Polonia y Hungría. En Italia, el marketplace opera como MediaWorld. Todos los países comparten una plataforma de vendedor.

¿Puede cancelar pedidos, reembolsar o eliminar ofertas? Ninguna herramienta reembolsa o cancela un pedido; hazlo en la oficina de MediaMarkt. Rechazar una línea al aceptar un pedido la cancela de forma definitiva, así que la IA te muestra cada escritura y espera un sí. mediamarkt_import_offers se instala apagado, porque su modo REPLACE elimina cada oferta que falta en el archivo; actívalo en la página del conector solo si la IA debe usarlo.

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Próximos pasos

• Página de inicio del conector
• Conectar a Claude