Salta al contenuto

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.

Come collegarlo

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?

La mappa di FlyItalyADSB dentro una conversazione: tutti gli aerei nell’area della mappa intorno a Roma Fiumicino, colorati per quota, con il cerchio della ricerca, Live acceso e l’elenco degli aerei sotto; il primo, RYR4KP, ha lo squawk 7700.

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.

La mappa è quella del server MCP, qui con dati di esempio. Claude e ChatGPT la mostrano dentro la loro conversazione.

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

  1. Su claude.ai apri Connettori e premi Aggiungi connettore personalizzato.
  2. Come nome scrivi FlyItalyADSB, come URL:
  3. Premi Connetti: si apre la pagina di FlyItalyADSB. Scrivi la tua email, poi il codice che ti arriva, e premi Consenti.
  4. 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

  1. In ChatGPT apri Impostazioni → App e connettori → Impostazioni avanzate e attiva la modalità sviluppatore.
  2. Torna in App e connettori e premi Crea: nome FlyItalyADSB, autenticazione OAuth, URL:
  3. Accedi con la tua email e il codice di 6 cifre, poi premi Consenti.
  4. 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

Dodici 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_near mappa in chat

    Tutti 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_aircraft mappa in chat

    Un aereo per hex ICAO, nominativo (anche il numero di volo) o immatricolazione, se la rete lo vede ora; se non vola, il suo ultimo volo osservato.

    Dov’è adesso EI-DWL?

  • special_traffic mappa in chat

    Il traffico militare, PIA o LADD che la rete vede in questo momento.

    C’è traffico militare in volo adesso?

Un aereo

  • aircraft_profile

    Quello che sappiamo di un aereo: identità, se e dove lo vediamo ora, primo e ultimo giorno con una traccia, link alla mappa e alle foto.

    Cosa sai dell’aereo D-AIUK?

  • observed_flights

    Lo storico voli, i voli che la rete ha visto: il registro dei voli di un aereo, con partenza, arrivo e minuti; le rotte abituali di un nominativo; partenze e arrivi di un aeroporto in un giorno. Da ieri indietro; su Fleet anche i voli di oggi.

    Che voli ha fatto EI-DWL questa settimana?

  • aircraft_history

    Le tracce: le date con una traccia per un aereo, o il percorso di un giorno punto per punto: posizione, quota e velocità, dal 2022.

    Mostrami la traccia di EI-DWL di ieri.

Cosa è passato

  • overflights

    Gli 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_traffic

    Emergenze (7500, 7600, 7700), militari e altri aerei particolari visti in una zona, fino a 7 giorni fa.

    Ci sono state emergenze vicino a Malpensa oggi?

I tuoi aerei (Fleet)

  • watched_aircraft

    Gli aerei seguiti dal tuo account, la lista per gli avvisi di decollo e atterraggio: elencali, aggiungine (fino a 25 su Fleet), toglili.

    Segui EI-DAC, chiamalo Ops 1.

  • fleet_status

    I voli di oggi di ogni aereo seguito, dai decolli e atterraggi rilevati in tempo reale: ultimo volo, ultimo aeroporto e, se è in volo, un arrivo stimato (una stima, non un orario). Una richiesta per aereo.

    Dov’è la mia flotta adesso?

Vicino a me

  • set_my_location

    Salva la tua posizione sull’account, arrotondata a circa 1 km, per le domande «vicino a me».

    La mia posizione è Brescia.

  • clear_my_location

    Cancella 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, aggiornata ogni 3 secondi. Intorno a un luogo o a un aereo mostra tutto il traffico dell’area che inquadri: spostala o ingrandisci e carica la nuova area. Gli altri client ricevono gli stessi dati come testo.

La mappa a schermo intero, tema chiaro: tutto il traffico del Nord Italia e della Svizzera nell’area della mappa, con il cerchio di 250 km intorno a Milano e l’elenco ordinato a destra.
A schermo intero la mappa prende tutta la finestra e l’elenco passa di lato. Il tema segue quello dell’assistente.
Il dettaglio di un aereo sulla mappa: RYR4KP, Boeing 737-800, squawk 7700, con quota, velocità, rotta, fonte della posizione e i pulsanti «Chiedi di più» e «Apri la mappa live».
Tocca un aereo: quota, velocità, rotta, squawk e da dove viene la posizione. «Chiedi di più» scrive la domanda in chat.
La mappa su un telefono, tema chiaro: gli aerei intorno a Fiumicino e l’elenco che scorre sotto.
Sul telefono l’elenco scorre sotto la mappa.
La mappa a schermo intero su un telefono, tema scuro: il traffico militare in Europa e il dettaglio del KC-135R LAGR221.
Schermo intero sul telefono, qui con il traffico militare.

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
carica subito i dati nuovi: conta come una richiesta
Live
acceso da subito: aggiorna la mappa ogni 3 s mentre è sullo schermo (una richiesta per aggiornamento, 20 al minuto); in pausa dopo 10 minuti senza toccarla
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 map.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?».

La mappa intorno alla posizione salvata, a Pisa: il cerchio di 30 km e tutti gli aerei nell’area della mappa.

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; fleet_status ne fa una per ogni aereo che controlla, mentre la lista degli aerei seguiti non si conta. Anche il raggio massimo è quello del piano.

Richieste per chiave e raggio massimo di ogni piano
PianoAl minutoAl meseRaggio 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
Fleet 149 €/mese 300 10.000.000 mondiale

Il piano Free ha anche un limite di 100 richieste/minuto per IP.

Piani, prezzi e uso commerciale

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.

Informativa privacy completa

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. Intorno a un luogo o a un aereo mostra tutto il traffico dell’area che inquadri, e Live, acceso da subito, la aggiorna ogni 3 secondi mentre è sullo schermo; si mette in pausa dopo 10 minuti senza toccarla. Ogni aggiornamento conta come una richiesta: 20 al minuto con Live acceso.

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.

Tutte le domande frequenti

Documentazione