Come collegare idealo a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di idealo.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

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