Scrivere codice PyQGIS per automatizzare un geoprocesso, cercare l’algoritmo corretto nella Casella degli strumenti di Processing o ricordare la sintassi esatta di un’espressione sono attività che fanno parte della quotidianità di molti professionisti GIS. Funzionano, ma richiedono tempo e concentrazione che potrebbero essere dedicati direttamente all’analisi.
Per questo motivo, quando compare un’integrazione che consente di descrivere ciò che si desidera fare direttamente in linguaggio naturale e vedere QGIS eseguire automaticamente le operazioni richieste, vale la pena approfondirla. In questo articolo vedremo che cos’è QGIS MCP, come collega Claude a QGIS e quali opportunità offre per il lavoro geospaziale professionale.

Che cos’è il Model Context Protocol (MCP)
MCP, acronimo di Model Context Protocol, è uno standard aperto sviluppato da Anthropic che definisce il modo in cui i modelli linguistici possono comunicare con applicazioni esterne in modo strutturato. Non si tratta semplicemente di un’API, ma di un protocollo bidirezionale che consente all’intelligenza artificiale di ricevere informazioni da strumenti esterni e di interagire con essi in tempo reale.
La differenza rispetto all’utilizzo tradizionale di un assistente come Claude è sostanziale. Fino ad oggi il flusso di lavoro tipico consisteva nell’uscire da QGIS, aprire il browser o l’applicazione, descrivere il problema, copiare il codice generato, tornare in QGIS ed eseguirlo. Con MCP questo ciclo viene eliminato. Claude opera direttamente nell’ambiente di lavoro, con accesso al progetto attivo e la possibilità di eseguire azioni su di esso.
QGIS MCP rappresenta l’implementazione di questo protocollo per QGIS.
La sua architettura è la seguente:
Claude ↔ Server MCP ↔ Socket TCP ↔ Plugin QGIS ↔ API PyQGIS
Claude comunica con un server MCP locale, che a sua volta si collega tramite un socket TCP a un plugin installato in QGIS. Il plugin traduce le istruzioni del modello in chiamate dirette all’API PyQGIS. Di conseguenza, ciò che viene descritto in linguaggio naturale si trasforma in operazioni reali sul progetto.
Quali sono i requisiti?
Per attivare l’integrazione sono necessari alcuni componenti. La configurazione non è particolarmente complessa, ma è importante verificarne preventivamente la disponibilità:
- QGIS 3.28 o superiore (compatibile anche con QGIS 4.x)
- Python 3.12 o superiore
- uv, il gestore di pacchetti Python utilizzato per avviare il server MCP
- Claude Desktop (o Claude Code), che consente di configurare nativamente le connessioni MCP

Con questi quattro elementi installati, la configurazione risulta piuttosto semplice.
Come si installa
L’installazione si articola in quattro passaggi principali. In questo articolo ci limitiamo a una panoramica generale, mentre la procedura dettagliata, le opzioni di configurazione e i casi pratici sono trattati nel nostro corso di IA Generativa per applicazioni geografiche.

Cosa si può fare con QGIS MCP
Una volta stabilita la connessione, Claude può eseguire numerose operazioni direttamente all’interno di QGIS. Tra le più interessanti per l’ambito professionale troviamo:
- Creare e salvare progetti tramite istruzioni testuali.
- Caricare layer vettoriali e raster specificandone il percorso o il nome.
- Eseguire algoritmi della Casella degli strumenti di Processing, dalle riproiezioni all’analisi di rete o all’algebra delle mappe.
- Applicare simbologie categorizzate, graduate o basate su regole specificando campi e parametri di classificazione.
- Modificare entità e campi, aggiungere geometrie o aggiornare attributi.
- Esportare mappe in formato immagine o PDF.
- Eseguire codice PyQGIS per operazioni più avanzate o personalizzate.
L’aspetto realmente interessante è che Claude non lavora con dati astratti: interagisce direttamente con il progetto aperto, conosce i layer caricati e può ragionare sul loro contenuto prima di eseguire qualsiasi operazione.

Casi d’uso per professionisti GIS
Pianificazione territoriale e urbanistica
Dalla generazione di layer di aree edificabili filtrate secondo diversi criteri normativi al calcolo degli indici urbanistici o all’individuazione di incompatibilità tra usi del suolo e vincoli territoriali. Claude può concatenare i geoprocessi necessari nell’ordine corretto e restituire risultati pronti per la verifica tecnica.
Ambiente e biodiversità
Calcolo delle superfici di habitat interessate da un progetto, individuazione di sovrapposizioni tra aree protette, generazione di buffer attorno a zone sensibili o estrazione di statistiche sulla copertura del suolo. Flussi che possono essere descritti in linguaggio naturale ed eseguiti direttamente sui layer del progetto.
Rischi naturali
Dalla delimitazione delle aree allagabili alla valutazione dell’esposizione di elementi vulnerabili, fino alla costruzione di indici di rischio compositi attraverso l’incrocio di molteplici variabili territoriali.
Automazione di attività ripetitive
Riproiezioni massive, ritagli territoriali, esportazioni in differenti formati e generazione automatica di serie cartografiche possono essere eseguiti tramite semplici istruzioni testuali, senza scrivere script dedicati.
Apprendimento assistito
Un utilizzo particolarmente interessante per chi sta studiando PyQGIS. Claude può eseguire un algoritmo e contemporaneamente spiegare il funzionamento dello strumento, i parametri utilizzati e le motivazioni delle scelte effettuate.
Un esempio pratico
Immaginiamo di inviare a Claude il seguente prompt:
Agisci come se avessi accesso agli strumenti di QGIS.
Fai quanto segue: verifica la connessione con ping.
Cerca il layer vettoriale comuni_toscana_conteggio_collegi.shp con il nome “comuni_toscana_conteggio_collegi” presente nel progetto. Crea una simbologia graduata con la rampa di colore Reds sul campo “N_COLLEGI” con 5 classi.
Claude eseguirà ciascuna operazione in sequenza direttamente in QGIS, senza la necessità di aprire menu, cercare algoritmi o scrivere codice.

Una raccomandazione importante
QGIS MCP include uno strumento chiamato execute_code, che consente a Claude di eseguire codice Python arbitrario all’interno di QGIS. È proprio questa caratteristica a renderlo così potente, ma richiede anche particolare attenzione.
È consigliabile verificare sempre il codice o le operazioni che Claude intende eseguire prima di confermarle, soprattutto in progetti di produzione con dati reali. Nelle prime fasi è preferibile lavorare su copie o progetti di prova per familiarizzare con il comportamento del modello.
Risorse del progetto
- Repository ufficiale: https://github.com/nkarasiak/qgis-mcp
- Plugin ufficiale QGIS: disponibile dal Gestore Plugin cercando QGIS MCP
Conclusioni
QGIS MCP non è un semplice esperimento o una dimostrazione tecnologica. Si tratta di un’integrazione pienamente funzionale che modifica il modo di interagire con QGIS: il linguaggio naturale diventa l’interfaccia principale e Claude agisce come un assistente capace di comprendere il progetto, interpretare il contesto ed eseguire le operazioni richieste.

Non sostituisce il professionista GIS, ma ne amplifica le capacità: meno tempo dedicato alla ricerca di strumenti e alla scrittura di codice, più tempo per l’analisi, l’interpretazione e il processo decisionale.
Se desideri imparare a configurare questa integrazione da zero, lavorare con prompt ottimizzati per contesti geospaziali reali e applicarla a progetti di pianificazione territoriale, ambiente, analisi del rischio e molti altri ambiti, nel nostro corso di IA Generativa per applicazioni geografiche troverai il percorso più diretto per iniziare con solide basi tecniche.





Lascia un commento