Come collegare idealo a Claude via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → idealo, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

idealo + Claude

Gestisci le offerte del tuo shop nel comparatore di prezzi idealo da un agente AI tramite il Partner Web Service di idealo: leggi un'offerta per SKU e, con la tua approvazione, crea o sostituisci offerte, cambia prezzi, tempi di consegna e titoli, o rimuovi offerte. Per gli shop presenti su idealo.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti serve uno shop presente su idealo (un contratto da commerciante con idealo) e l'accesso a idealo Business.

1. Accedi a idealo Business e apri Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients).
2. Crea un client API con accesso al Partner Web Service e copia il suo client ID e il suo client secret. Il secret viene mostrato una sola volta; se non lo hai più, crea un nuovo client.
3. Incolla il client ID (un UUID) in IDEALO_CLIENT_ID, il secret in IDEALO_CLIENT_SECRET e il tuo shop ID numerico, mostrato in idealo Business, in IDEALO_SHOP_ID. AnythingMCP scambia le credenziali del client con un access token valido un'ora e lo rinnova da solo.
4. Installa il connettore ed esegui idealo_get_offer con lo SKU di un'offerta che sai essere online: vedi l'offerta così come idealo la memorizza.

Cosa legge: un'offerta alla volta tramite SKU, così come idealo la memorizza: titolo, prezzo e prezzo precedente, URL, EAN e codici produttore, marca, costi di spedizione e di pagamento, tempi di consegna, etichette energetiche, condizione e gli altri campi dell'offerta. Il Partner Web Service non ha una chiamata di elenco, quindi l'AI ti chiede lo SKU.

Solo offerte, niente ordini: il Partner Web Service 2.0 è l'interfaccia con cui gli shop presenti su idealo gestiscono le offerte una per una, al posto del feed prodotti o accanto ad esso, per idealo.de, .at, .fr, .it, .es e .co.uk. idealo ha chiuso nel 2023 il servizio di checkout (Direktkauf) e la sua API ordini, quindi gli ordini continuano ad arrivare dal tuo shop.

Come si scrivono le offerte: i prezzi sono stringhe con esattamente due decimali e il punto, come "177.99"; il prezzo precedente è quello prima di uno sconto. Una nuova offerta richiede almeno SKU, titolo, prezzo, URL, un costo di spedizione (per esempio "DHL": "4.90") e un costo di pagamento (per esempio "PAYPAL": "0.00"); EAN, codici produttore e marca aiutano idealo ad abbinare il prodotto. idealo_upsert_offer sostituisce l'intera offerta, quindi ogni campo non inviato viene rimosso; idealo_update_offer cambia solo i campi inviati, ma non può modificare costi di spedizione e pagamento, taglia, colore, genere, materiale e attributi dinamici del prodotto, e i campi elenco come EAN o immagini vanno inviati completi. Gli SKU possono contenere solo lettere, cifre, trattini bassi, punti e trattini.

Chiede prima di ogni modifica: all'installazione nessuno strumento di scrittura è attivo. Quando un amministratore ne attiva uno, l'AI ti mostra l'offerta con il valore vecchio e quello nuovo, o ti indica lo SKU che rimuoverebbe, e aspetta il tuo sì prima che qualcosa vada online.

Disattivati all'installazione: idealo_upsert_offer, idealo_update_offer e idealo_delete_offer. idealo non ha un ambiente di test, quindi ogni scrittura cambia subito le tue offerte live nel comparatore, e un'offerta rimossa sparisce da idealo. Attiva solo quelli che l'AI può usare. Eliminare tutte le offerte in una volta non è previsto, di proposito.

Limiti: idealo limita il numero di chiamate; il limite attuale è nell'header X-RateLimit-Limit. Dopo un 429 l'AI aspetta prima di riprovare, e modifica le offerte una alla volta.

Errori comuni: 401 significa che client ID o secret sono sbagliati o che il token è stato rifiutato: controllali in Shop settings → API clients. 403 significa che al client API manca il diritto per il Partner Web Service o che lo shop ID non è tuo. 404 significa che l'offerta non esiste in questo shop (SKU o shop ID sbagliati). 400 elenca i fieldErrors con il campo e il motivo, per esempio un prezzo senza due decimali.

Il connettore non legge né gestisce ordini, non elenca tutte le tue offerte, non modifica il tuo feed prodotti e non elimina tutte le offerte in una volta.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Claude

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.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio idealo, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Com'è pubblicata adesso su idealo la mia offerta con SKU KS-4711: prezzo, tempi di consegna e spese di spedizione?"
• "Abbassa il prezzo dello SKU TV-55-OLED a 899,00 euro e mostra 999,00 euro come prezzo precedente."
• "Cambia i tempi di consegna dello SKU BOSCH-GSR18 in 1-3 giorni lavorativi."
• "Crea una nuova offerta idealo per lo SKU LAMPADA-200 con EAN 4006381333931: 49,90 euro, spedizione DHL a 4,90 euro e PayPal senza costi aggiuntivi."
• "Togli da idealo l'offerta con SKU KS-4711, l'articolo è esaurito."

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse