Dati / MCP e agenti AI
Il traffico aereo nella tua chat
Collega il server MCP di FlyItalyADSB a Claude o ChatGPT e chiedi come parli: che aerei ci sono sopra Fiumicino, se c’è traffico militare, cosa è passato sopra casa tua ieri sera. La risposta arriva con una mappa interattiva dentro la conversazione.
Gratis, con la stessa chiave della REST API. Funziona in Claude, ChatGPT, Claude Code e negli altri client MCP.
Che aerei ci sono adesso vicino a Fiumicino?
Ci sono 40 aerei entro 50 km. Uno ha lo squawk 7700, emergenza generale: RYR4KP, un Boeing 737-800 a 7.800 piedi in discesa, 25 km a sud-est dell’aeroporto.
Collegalo
Ti servono un’email e un paio di minuti. Non devi copiare chiavi: entri con un codice di 6 cifre che ti mandiamo per email e, se non hai ancora una chiave API, la creiamo gratis in quel momento.
claude.ai
- Su claude.ai apri Connettori e premi Aggiungi connettore personalizzato.
- Come nome scrivi FlyItalyADSB, come URL:
- Premi Connetti: si apre la pagina di FlyItalyADSB. Scrivi la tua email, poi il codice che ti arriva, e premi Consenti.
- Torna in chat e chiedi: Che aerei ci sono ora vicino a Fiumicino?
Una volta aggiunto, il connettore c’è anche in Claude desktop e nell’app per il telefono.
ChatGPT
- In ChatGPT apri Impostazioni → App e connettori → Impostazioni avanzate e attiva la modalità sviluppatore.
- Torna in App e connettori e premi Crea: nome FlyItalyADSB, autenticazione OAuth, URL:
- Accedi con la tua email e il codice di 6 cifre, poi premi Consenti.
- In una chat nuova aggiungi FlyItalyADSB dal menu + e chiedi: C’è traffico militare in volo adesso?
Le voci dei menu di ChatGPT cambiano spesso e la modalità sviluppatore non c’è in tutti i piani: se non le trovi, cerca «connettori» nelle impostazioni.
Claude Code e altri
In Claude Code, con la tua chiave nell’header:
claude mcp add --transport http flyitalyadsb https://flyitalyadsb.com/mcp \
--header "X-Api-Key: LA_TUA_CHIAVE"- Gli altri client MCP con OAuth si collegano come Claude: aggiungi l’URL e premi Connetti.
- Dal tuo codice o da un client senza OAuth, manda la chiave nell’header
X-Api-Key. È gratuita: chiedila qui. - Un agente che conosce solo la tua email può registrarsi con auth.md: confermi tu, con il codice che ti mandiamo.
Una chiamata a mano, in JSON-RPC
POST https://flyitalyadsb.com/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
X-Api-Key: <la-tua-chiave>
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aircraft_near","arguments":{"airport":"FCO","radiusKm":25}}}
Cosa puoi chiedere
Nove strumenti. Non devi nominarli: l’assistente sceglie da solo quale usare, anche più di uno per domanda. Le domande qui sotto sono esempi da provare.
Adesso
-
aircraft_nearmappa in chatTutti gli aerei in un raggio da un punto qualsiasi del mondo, o da un aeroporto italiano per nome.
Che aerei ci sono adesso vicino a Fiumicino?
-
find_aircraftmappa in chatUn aereo per hex ICAO, nominativo o immatricolazione, se la rete lo vede ora.
Dov’è adesso EI-DWL?
-
special_trafficmappa in chatIl traffico militare, PIA o LADD che la rete vede in questo momento.
C’è traffico militare in volo adesso?
Un aereo
-
aircraft_profileQuello che sappiamo di un aereo: identità, se e dove lo vediamo ora, primo e ultimo giorno nello storico, link alla mappa e alle foto.
Cosa sai dell’aereo D-AIUK?
-
aircraft_historyLe date con una traccia per un aereo, o la traccia di un giorno: posizione, quota e velocità, dal 2022.
Che voli ha fatto ieri EI-DWL?
Cosa è passato
-
overflightsGli aerei passati sopra un luogo tra due istanti, con l’ora e la distanza del punto più vicino. Dal 17/08/2026.
Quali aerei sono passati sopra Brescia ieri tra le 22 e le 23?
-
notable_trafficEmergenze (7500, 7600, 7700), militari e altri aerei notevoli visti in una zona, fino a 7 giorni fa.
Ci sono state emergenze vicino a Malpensa oggi?
Vicino a me
-
set_my_locationSalva la tua posizione sull’account, arrotondata a circa 1 km, per le domande «vicino a me».
La mia posizione è Brescia.
-
clear_my_locationCancella la posizione salvata.
Dimentica la mia posizione.
La mappa in chat
Su Claude (web, desktop e app) e su ChatGPT, aircraft_near, find_aircraft e special_traffic mostrano il risultato anche su una mappa, dentro la conversazione. Gli altri client ricevono gli stessi dati come testo.
Come si legge
- Colore
- la quota, da 0 a oltre 40.000 piedi
- Pieno
- posizione inviata dall’aereo (ADS-B)
- Contorno
- posizione calcolata dalla rete (MLAT)
- Sbiadito
- posizione di oltre un minuto fa
- Grigio
- a terra, o quota sconosciuta
- Rombo, anello
- militare; PIA o LADD
- Anello rosso
- squawk di emergenza
I pulsanti
- Aggiorna
- ripete la ricerca: conta come una richiesta
- Live
- ripete la ricerca ogni 30 s per al massimo 10 minuti, mentre la mappa è sullo schermo: 2 richieste al minuto
- Schermo intero
- dove l’assistente lo permette
- Chiedi di più
- scrive in chat una domanda sull’aereo
- Apri la mappa live
- lo stesso aereo su mappa.flyitalyadsb.com
Vicino a me
Nessun assistente ci passa la posizione del tuo telefono o del computer. Per chiedere «che aerei ci sono vicino a me?» senza dire ogni volta dove sei, salva una posizione una volta:
- dilla all’assistente: La mia posizione è Pisa.
- oppure da La mia API, con Usa la mia posizione.
Poi basta chiedere:
Che aerei ci sono vicino a me?
Su ChatGPT, se non ne hai salvata una, usiamo la città che ChatGPT allega alla richiesta. Valgono anche overflights e notable_traffic: «cosa è passato sopra di me ieri sera?».
Limiti e richieste
Ogni volta che l’assistente chiama uno strumento fa una richiesta all’API, e conta sul piano della tua chiave come una chiamata diretta. Una domanda può costarne più di una, se l’assistente usa più strumenti. Anche il raggio massimo è quello del piano.
| Piano | Al minuto | Al mese | Raggio massimo |
|---|---|---|---|
| Free gratis | 30 | 300.000 | 500 km |
| Starter 9 €/mese | 60 | 1.000.000 | 1000 km |
| Pro 49 €/mese | 300 | 10.000.000 | mondiale |
| Business 249 €/mese | 1000 | 50.000.000 | mondiale |
I limiti del piano Free valgono dal 27 ottobre 2026; fino ad allora una chiave Free resta a 100 richieste/minuto per IP.
Privacy
| La tua posizione | Non riceviamo la posizione del tuo dispositivo. Se ne salvi una, la arrotondiamo a circa 1 km prima di salvarla: una sola per account, e la cancelli quando vuoi. |
| Aerei, non persone | Nessuna risposta contiene i nomi di proprietari o operatori, e non sappiamo chi c’è a bordo. |
| La mappa | Carica solo le tessere di OpenStreetMap: non chiede permessi e non usa la tua posizione. |
| PIA e LADD | Gli aerei con indirizzo privacy o nel programma FAA LADD sono segnalati, non nascosti, come su tutta la rete. Per loro niente link alle foto. |
| Il collegamento | Lo scolleghi da La mia API, sotto «Assistenti collegati». La chiave non cambia. |
Domande frequenti
Come uso il server MCP con Claude o ChatGPT?
Aggiungi https://flyitalyadsb.com/mcp come connettore personalizzato (su claude.ai: Connettori → Aggiungi connettore personalizzato; su ChatGPT: un'app creata in modalità sviluppatore) e premi Connetti: accedi con la tua email e un codice di 6 cifre, senza copiare chiavi. Nei client senza OAuth passa la tua chiave nell'header X-Api-Key. Poi puoi chiedere in chat cose come "che aerei ci sono ora su Fiumicino?" o "c'è traffico militare sopra Roma?" e l'agente chiamerà i tool automaticamente. I passi uno per uno sono nella pagina MCP.
Cosa può fare il server MCP che la mappa non fa?
Risponde in chat con dati strutturati: un aereo per hex ICAO, nominativo o immatricolazione, tutti gli aerei in un raggio da un punto qualsiasi, il traffico militare, PIA o LADD, il profilo di un aereo, cosa è passato sopra un luogo in una finestra di tempo, le emergenze recenti in una zona e lo storico di un aereo. Su Claude e ChatGPT mostra anche gli aerei su una mappa dentro la conversazione.
Le domande all’assistente consumano richieste?
Sì: ogni chiamata a uno strumento MCP è una richiesta all’API e conta sul piano della tua chiave, come una chiamata diretta.
Posso chiedere «che aerei ci sono vicino a me?»
Sì, dopo aver salvato una posizione: da La mia API con «Usa la mia posizione», oppure dicendo all’assistente «la mia posizione è Brescia». Nessun assistente passa la posizione del tuo dispositivo al server. La salviamo arrotondata a circa 1 km e la cancelli quando vuoi. Su ChatGPT, senza una posizione salvata, usiamo la città che ChatGPT allega alla richiesta.
Posso avere il profilo di un aereo, con la foto?
Sì: chiedi all’assistente di un aereo e userà aircraft_profile, o chiama /v2/profile/{icao}: identità, se lo vediamo adesso e dove, primo e ultimo giorno nello storico. La foto non è nella risposta, perché le condizioni di Planespotters.net non lo permettono: ricevi il link alla loro pagina, con il nome del fotografo, e quello della mappa. Per gli aerei PIA e LADD niente link alle foto. Mai nomi di proprietari.
Perché in chat vedo una mappa?
Su Claude e ChatGPT gli strumenti che restituiscono aerei li mostrano anche su una mappa interattiva nella conversazione, colorati per quota. Carica solo le tessere di OpenStreetMap, non chiede permessi e non usa la tua posizione. Tra un aggiornamento e l’altro gli aerei in volo si muovono secondo rotta e velocità: è una stima. Aggiorna ripete la ricerca; Live la ripete ogni 30 secondi per al massimo 10 minuti, mentre la mappa è sullo schermo. Ogni aggiornamento conta come una richiesta.
Come scollego un assistente?
In La mia API, sotto «Assistenti collegati», premi Scollega. La chiave non cambia.
Un agente AI può registrarsi da solo?
Sì, con auth.md, ma serve sempre la tua conferma: l’agente ti dà un link e un codice, tu entri con il codice che ti mandiamo per email e scrivi quello dell’agente.