Collegare MediaMarkt a Gemini CLI via MCP

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Marketplace MediaMarkt, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Marketplace MediaMarkt + Gemini

Gestisci il tuo negozio sul marketplace MediaMarkt tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e disponibilità, importazioni, messaggi, resi, fatture e transazioni. Il marketplace opera in Germania, Austria, Spagna, Paesi Bassi, Italia, Belgio, Svizzera, Polonia e Ungheria; accedi con la chiave API del negozio dal tuo back office venditore MediaMarkt.

Prerequisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:

MEDIAMARKT_API_KEY

Passo 1 — Ottieni le credenziali

Paesi: Germania, Austria, Spagna, Paesi Bassi, Italia, Belgio, Svizzera, Polonia e Ungheria. In Italia il marketplace opera come MediaWorld. Tutti i paesi condividono una piattaforma venditore unica.

Chi può vendere: MediaMarkt accetta domande tramite un modulo per paese, seguito da una verifica aziendale (KYC). Il connettore ha bisogno di un account venditore già aperto da MediaMarkt.

La configurazione richiede circa 5 minuti.

1. Accedi al back office venditore MediaMarkt: https://mediamarktsaturn.mirakl.net/login.
2. Nel back office apri il tuo nome utente (in alto a destra) > Le mie impostazioni utente > Chiave API e clicca su Genera una nuova chiave (o copia la chiave esistente). Incollala in MEDIAMARKT_API_KEY. La chiave viene inviata così com'è nell'intestazione Authorization, senza Bearer. Generare una nuova chiave invalida quella vecchia, quindi qualsiasi altro strumento che la utilizza smette di funzionare.
3. MediaMarkt di solito apre un negozio per paese, quindi la maggior parte dei venditori ha diversi negozi sotto un unico utente. Se il tuo utente ha più di un negozio, imposta MEDIAMARKT_SHOP_ID sull'id numerico del negozio su cui questo connettore deve funzionare (mostrato nel dashboard del back office accanto a Identificatore o ID Negozio, e restituito come shop_id da mediamarkt_get_account); per lavorare su più negozi, installa il connettore una volta per negozio. Senza di esso, viene utilizzato il tuo negozio predefinito.
4. Installa ed esegui mediamarkt_get_account: restituisce il negozio a cui appartiene la chiave.

Da dove iniziare: mediamarkt_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano utilizza mediamarkt_list_orders con order_state_codes=WAITING_ACCEPTANCE, mediamarkt_list_offers per prezzi e disponibilità e mediamarkt_list_threads per messaggi in attesa di risposta.

Prodotti e offerte concorrenti: mediamarkt_get_products cerca i prodotti nel catalogo MediaMarkt tramite EAN o un altro riferimento e restituisce lo SKU del prodotto del marketplace; mediamarkt_list_product_offers elenca le offerte di ogni negozio per i prodotti dati, con il miglior prezzo per primo, a circa 5 chiamate al minuto.

Flusso di lavoro degli ordini: un nuovo ordine attende in WAITING_ACCEPTANCE. mediamarkt_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi mediamarkt_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da mediamarkt_list_carriers) e mediamarkt_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa mediamarkt_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiane e has_incident=true per incidenti aperti; mediamarkt_resolve_incident chiude un incidente su una riga d'ordine una volta risolto. I documenti allegati agli ordini (note di consegna, etichette, fatture clienti) sono elencati da mediamarkt_list_order_documents.

Scritture: conferma prima. 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 e mediamarkt_import_products agiscono sul marketplace attivo. Prima di ogni chiamata, mostra all'utente cosa cambierà (id e righe dell'ordine, numero di tracciamento, SKU dell'offerta con il vecchio e il nuovo prezzo o disponibilità, il testo del messaggio e i destinatari) e attendi un sì. Rifiutare una riga d'ordine la annulla definitivamente. Nessuno strumento qui rimborsa, annulla ordini o sposta denaro; fallo nel back office. mediamarkt_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato disattivato.

Aggiornamento delle offerte (prezzi e disponibilità): mediamarkt_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, uno discount o description mancante viene eliminato. Leggi sempre prima l'offerta (mediamarkt_get_offer o mediamarkt_list_offers con sku) e rimandala completa con solo la modifica prevista: shop_sku, product_id e product_id_type (da product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (il suo codice), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leggi come available_start_date / available_end_date) e qualsiasi offer_additional_fields. Lascia update_delete vuoto o update. La chiamata restituisce un import_id; la modifica viene applicata in modo asincrono, quindi controllala con mediamarkt_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da mediamarkt_list_offer_conditions, i codici di classe logistica da mediamarkt_list_logistic_classes.

Importazioni di file: mediamarkt_import_products (P41) e mediamarkt_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato richiesto da MediaMarkt; il connettore lo scarica e lo carica su MediaMarkt. Tracciali con mediamarkt_list_product_imports / mediamarkt_get_product_import e mediamarkt_list_offer_imports / mediamarkt_get_offer_import.

Resi: mediamarkt_list_returns (RT11) elenca le richieste di reso. Dove MediaMarkt lascia decidere al negozio, mediamarkt_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e mediamarkt_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.

Messaggi: mediamarkt_list_threads elenca le conversazioni (filtra con entity_type=MMP_ORDER e entity_id=<order id> per un ordine; entity_id senza entity_type viene rifiutato), mediamarkt_get_thread legge una con i suoi messaggi, mediamarkt_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è MediaMarkt) e mediamarkt_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da mediamarkt_list_reasons; lascia il suo locale vuoto a meno che tu non sappia che il marketplace ha quella lingua (un locale inattivo risponde 400).

Denaro: mediamarkt_list_invoices (IV01) elenca i documenti contabili che MediaMarkt emette al negozio e mediamarkt_list_transactions (TL02) le righe di transazione (vendite, commissioni, rimborsi, pagamenti). Se MediaMarkt utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; usa mediamarkt_list_document_requests (DR11) e poi le transazioni.

Liste di riferimento: mediamarkt_list_channels (siti per paese), mediamarkt_list_carriers, mediamarkt_list_shipping_zones, mediamarkt_list_shipping_methods e mediamarkt_list_logistic_classes cambiano raramente; leggili una volta per conversazione.

Paginazione: ordini, offerte, fatture e importazioni di prodotti paginano con max (al massimo 100) e offset. Thread, resi, transazioni, richieste di documenti e importazioni di offerte restituiscono un next_page_token; passalo come page_token per ottenere la pagina successiva (tutti gli altri filtri vengono quindi ignorati) fino a quando non è mancante.

Date sono ISO 8601, ad esempio 2026-10-01T00:00:00Z; le risposte sono in UTC.

Limiti di frequenza: Ogni API ha il proprio limite e MediaMarkt può inasprirli. L'elenco di offerte e ordini è destinato all'uso interattivo, le importazioni di prodotti e offerte al massimo ogni 15 minuti, mediamarkt_get_account e le liste di riferimento circa una volta al giorno. Un 429 porta un'intestazione Retry-After con i secondi da attendere; non riprovare in un ciclo.

Errori: 401 significa che la chiave è errata o è stata sostituita da una più recente, 403 che il tuo utente non ha il diritto per questa azione, 404 che l'ordine, l'offerta o il thread non esistono per questo negozio, 400 un parametro errato o un ordine in uno stato errato (il messaggio lo indica, ad esempio ORDER_INVALID_STATE).

Passo 2 — Installa l'adattatore

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

Passo 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Marketplace MediaMarkt.

Strumenti disponibili

Esempi di prompt

• "Elenca i miei ordini MediaMarkt che sono in SPEDIZIONE e non hanno ancora un numero di tracciamento."
• "Chi ha il miglior prezzo per le cuffie con EAN 4548736132610 su MediaMarkt, e dove si colloca il mio?"
• "Quali delle mie offerte MediaMarkt hanno meno di 3 unità rimaste?"
• "Mostra gli incidenti aperti sui miei ordini MediaMarkt e cosa hanno scritto i clienti."
• "Rispondi al cliente nel thread sull'ordine 4501234-A che la sostituzione verrà spedita domani."

FAQ

Dove posso ottenere la chiave API MediaMarkt? Nel back office venditore MediaMarkt: il tuo nome utente (in alto a destra), Le mie impostazioni utente, Chiave API, poi Genera una nuova chiave (o copia la chiave esistente). Generare una nuova chiave invalida quella vecchia. MediaMarkt di solito apre un negozio per paese, quindi la maggior parte dei venditori ha diversi negozi sotto un unico utente. Con più di un negozio, imposta MEDIAMARKT_SHOP_ID sul negozio su cui questo connettore deve funzionare.

Chi può vendere su MediaMarkt e quali paesi copre? MediaMarkt accetta domande tramite un modulo per paese, seguito da una verifica aziendale (KYC). Il connettore copre Germania, Austria, Spagna, Paesi Bassi, Italia, Belgio, Svizzera, Polonia e Ungheria. In Italia il marketplace opera come MediaWorld. Tutti i paesi condividono una piattaforma venditore unica.

Può annullare ordini, rimborsare o eliminare offerte? Nessuno strumento rimborsa o annulla un ordine; fallo nel back office di MediaMarkt. Rifiutare una riga durante l'accettazione di un ordine la annulla definitivamente, quindi l'AI ti mostra ogni scrittura e attende un sì. mediamarkt_import_offers è installato disattivato, perché la sua modalità REPLACE elimina ogni offerta mancante dal file; attivalo nella pagina del connettore solo se l'AI deve usarlo.

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude