Come collegare openrouteservice a Microsoft Copilot via MCP

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

openrouteservice + Microsoft Copilot

Routing di openrouteservice (HeiGIT) su OpenStreetMap: geocoding e geocoding inverso, percorsi con indicazioni svolta per svolta per auto, camion, bici, a piedi e in sedia a rotelle, matrici dei tempi di viaggio, isocrone (aree raggiungibili), ottimizzazione dei percorsi per più veicoli e punti di interesse. Chiave API gratuita.

Prerequisiti

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

OPENROUTESERVICE_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti servono un account HeiGIT gratuito e una chiave API. Il piano gratuito basta per i test e per un uso in produzione contenuto.

1. Registrati gratis su account.heigit.org e crea una chiave API nella dashboard, alla voce tokens.
2. Incolla solo la chiave in OPENROUTESERVICE_API_KEY, senza la parola Bearer, spazi o virgolette. Il connettore la invia nell'header Authorization.
3. Installa il connettore ed esegui openrouteservice_geocode con un luogo come Berlino: restituisce il luogo con le sue coordinate, segno che la chiave funziona.

Indirizzo attuale: il connettore usa https://api.heigit.org, l'indirizzo attuale di openrouteservice. HeiGIT spegne il vecchio api.openrouteservice.org a novembre 2026; le chiavi create lì funzionano anche qui, quindi puoi tenere quella che hai.

Cosa fa: tutto si basa sui dati OpenStreetMap. Trasforma indirizzi in coordinate e viceversa (geocoding, completamento automatico mentre scrivi, geocoding inverso); calcola percorsi con distanza, durata e indicazioni svolta per svolta per auto, camion (driving-hgv), bici, a piedi e in sedia a rotelle, evitando se vuoi autostrade, pedaggi o traghetti; costruisce matrici dei tempi di viaggio tra molti punti; disegna isocrone, cioè l'area raggiungibile entro un certo tempo o una certa distanza; risolve giri per più veicoli (VROOM) con finestre orarie, capacità e competenze; e trova punti di interesse come negozi, distributori, farmacie o colonnine di ricarica intorno a un punto.

Prima la longitudine: ogni strumento di routing vuole le coordinate come [longitudine, latitudine], per esempio [7.8421, 47.9990] per Friburgo. Invertirle è la causa tipica di un punto non trovato o di un percorso che finisce in mare, per questo l'AI geocodifica prima gli indirizzi e passa le coordinate così come sono.

Unità: le durate arrivano in secondi e l'AI le converte per te in ore e minuti. Le distanze sono in chilometri di default. Le isocrone ricevono l'intervallo in secondi, o in metri per un intervallo di distanza.

Solo lettura: il connettore si limita a calcolare. Alcuni strumenti inviano la richiesta come POST, ma nessuno cambia qualcosa nel tuo account HeiGIT: non c'è nulla da confermare e nessuno strumento è disattivato all'installazione.

Limiti: il piano gratuito consente circa 2.000 richieste di percorso al giorno e 40 al minuto, con quote giornaliere più basse per matrici, isocrone, ottimizzazione e punti di interesse. Ogni risposta riporta x-ratelimit-remaining e l'AI preferisce una matrice a tanti percorsi singoli.

Errori comuni: 401 significa che non è arrivata alcuna chiave: controlla OPENROUTESERVICE_API_KEY. 403 significa che la chiave è stata rifiutata o che la quota giornaliera è esaurita; verifica entrambe le cose su account.heigit.org. 429 significa limite al minuto raggiunto: aspetta un minuto. L'errore 2004 indica che la richiesta supera un limite (troppi punti o un percorso troppo lungo); l'errore 2010 indica un punto lontano da qualsiasi strada, spesso perché longitudine e latitudine sono invertite.

Il connettore calcola soltanto sui dati OpenStreetMap: non disegna immagini di mappe, non offre percorsi con i mezzi pubblici e non cambia nulla nel tuo account HeiGIT.

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 openrouteservice.
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

• "Quanto ci metto in auto da Milano Centrale all'aeroporto di Malpensa, e quali sono le indicazioni passo passo?"
• "Quale dei nostri tecnici di Bologna, Modena e Parma è più vicino in auto a ciascuno di questi 12 clienti?"
• "Mostrami l'area raggiungibile in 15 minuti di auto dal nostro negozio in via Roma 10 a Torino."
• "Pianifica le consegne di domani: 25 fermate, 2 furgoni dalle 8 alle 17 e la fascia oraria di ogni cliente. Quale furgone fa quali fermate, e in che ordine?"
• "Trova farmacie e colonnine di ricarica entro 500 metri da Piazza Navona a Roma."

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