QGIS MCP: installazione, limiti e alternativa semplice
Pubblicato il Aggiornato il
QGIS MCP è un plugin gratuito di QGIS più un piccolo programma sul tuo computer che permettono a un'app AI esterna a QGIS, di solito Claude Desktop o Claude Code, di controllarlo. Scrivi nell'app AI, lei invia i comandi a QGIS tramite una connessione locale e QGIS li esegue: carica layer, lancia gli strumenti di Processing, applica uno stile alla mappa o esegue codice Python.

L'idea è buona e il plugin è fatto bene. Nicolas Karasiak mantiene la versione presente nel repository ufficiale di QGIS, che il 26 settembre 2026 contava 52.575 download. Quello che i tutorial non dicono è quanto serva per farlo funzionare e dove si ferma. L'ho configurato da zero, poi ho dato lo stesso compito a lui e a un agente che vive dentro QGIS. Il secondo lo sviluppiamo noi, AI Agent, quindi leggi le mie conclusioni tenendone conto.
Cos'è MCP, in un paragrafo
MCP, il Model Context Protocol, è uno standard aperto nato da Anthropic che permette alle app AI di usare strumenti esterni. L'introduzione ufficiale lo definisce "a USB-C port for AI applications". L'app AI si chiama client. Un server le mette a disposizione degli strumenti. QGIS MCP è un server i cui strumenti sono azioni di QGIS. Il protocollo dichiara il rischio senza giri di parole: "Tools represent arbitrary code execution and must be treated with appropriate caution."
Come funziona QGIS MCP
Quattro componenti devono essere installati e in esecuzione nello stesso momento:
- Un client MCP: l'app AI in cui scrivi, come Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI o Gemini CLI.
- Il server MCP: un piccolo programma Python che il client avvia in background tramite
uv, uno strumento che installa ed esegue programmi Python. Prima devi installareuv. - Il plugin QGIS MCP: dentro QGIS, ascolta i comandi su una porta di rete locale, la 9876. Per avviarlo fai clic su Run MCP nel pulsante della sua barra degli strumenti.
- QGIS stesso, con il tuo progetto aperto.
Quando scrivi una richiesta, il modello AI sceglie uno strumento di QGIS, il server passa la chiamata al plugin, e il plugin la esegue in QGIS e restituisce il risultato. Il modello non vede il tuo schermo. Vede la mappa solo quando chiede a QGIS un'immagine.
Cosa serve prima di iniziare
| Requisito | Perché | Costo |
|---|---|---|
| QGIS 3.28 o successivo | Il minimo richiesto dal plugin | Gratis |
| Un'app client MCP | Dove chatti con il modello | Piano gratuito con limiti giornalieri, o piano a pagamento |
uv (esecutore di pacchetti Python) | Avvia il server MCP | Gratis, si installa con un comando da terminale |
| Un comando da terminale o una voce in un file di configurazione | Indica al client dove trovare il server | Gratis, ma a mano |
| Il plugin QGIS MCP | Il lato QGIS del ponte | Gratis |
Una guida all'installazione molto letta dice che serve un account Claude Pro a pagamento. Non è vero. La documentazione di Anthropic sui server MCP locali non cita nessun piano, e un blogger GIS ha usato QGIS MCP con il piano gratuito di Claude ad agosto 2026, scontrandosi solo con il limite giornaliero di messaggi. ChatGPT è più complicato. Il centro assistenza di OpenAI dice che si collega solo a server MCP su internet, non a uno sul tuo computer, e che la modalità sviluppatore necessaria è riservata ai piani a pagamento.
Installare QGIS MCP, con i tempi
Ho installato QGIS MCP 0.15.0 su QGIS 3.44 il 26 settembre 2026 e ho annotato ogni passaggio. La pagina del plugin è esplicita: "This plugin is only one half of the setup. You also need the qgis-mcp MCP server, which your MCP client runs to talk to QGIS."
Installa il plugin
Plugins > Gestisci ed Installa Plugin..., cerca QGIS MCP, poi Installa Plugin. Questa parte è rapida: si è caricato in 2,7 secondi, senza riavvio.Installa uv
Il server funziona tramite
uv, che Windows e macOS non includono. Lo installi con un solo comando da terminale.Procurati un client MCP
Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI o un'altra app che parla MCP, con il suo account e il suo piano.
Collega il client a QGIS
Il Configurator del plugin mostra un comando da incollare nel terminale, come
claude mcp add -s user qgis -- uvx ... qgis-mcp-server. Alcuni client richiedono invece di aggiungere una riga a un file di impostazioni.Avvia il server in QGIS
Fai clic su Run MCP nel pulsante del plugin sulla barra degli strumenti. All'avvio QGIS scrive nel log "Token authentication disabled (open)".
Invia il primo messaggio
La prima chiamata scarica il server, circa 90 MB, poi si connette. Nel mio test ci sono voluti 16 secondi e il client ha visto 125 strumenti di QGIS.
Il Configurator nello screenshot qui sotto è dove scegli il tuo client e copi il comando da terminale.

La mia prova è durata circa tre minuti, ma uv e un client erano già installati e uno script faceva i clic al posto mio. La prima volta, una persona deve anche leggere la documentazione, installare uv e un client e digitare il comando.
Una parte si ripresenta ogni giorno. Dopo un riavvio di QGIS, il server resta spento a meno che tu non attivi l'avvio automatico nel Configurator. L'app AI dice solo "Error executing tool ping", e devi indovinare che la soluzione è fare di nuovo clic su Run MCP.
Lo stesso compito, in due modi
Ho dato a entrambi gli strumenti la stessa richiesta, nello stesso momento sullo stesso computer, ciascuno in un progetto QGIS nuovo: "A Lione, in Francia, trova le scuole a meno di 300 metri da una fermata del tram, mostrale su una mappa con le linee del tram e dimmi quante sono."
| QGIS MCP, con Claude Code | AI Agent | |
|---|---|---|
| Tempo per arrivare alla risposta | 9 min 28 s | 5 min 35 s |
| Passaggi | 10, di cui 6 erano codice Python | 40, di cui 2 erano codice Python |
| Dati usati | OpenStreetMap, scaricati con Python scritto da lui | I layer ufficiali di scuole, scuole medie e licei della Métropole de Lyon, più fermate e binari del tram di OpenStreetMap |
| Scuole contate | 87 | 80 (52 primarie, 14 scuole medie, 14 licei) |
I conteggi differiscono perché i due strumenti hanno usato dati diversi. QGIS MCP ha contato le scuole di OpenStreetMap vicine a fermate del tram prese da un rettangolo attorno a Lione, quindi contano anche alcune fermate appena fuori città, e ha detto lui stesso che le 87 non erano deduplicate. AI Agent ha usato i registri ufficiali delle scuole della città e il confine del comune di Lione.
La differenza più grande è come ci sono arrivati. QGIS MCP non ha uno strumento per i dati, quindi il modello ha scritto codice Python per interrogare i server Overpass di OpenStreetMap. Hanno risposto con errori (406, 504, poi 502 due volte), e ha riprovato. Quel Python girava sul thread principale di QGIS, quindi QGIS è rimasto bloccato per circa sette minuti, e la mappa è rimasta vuota fino a 7 min 22 s.

AI Agent ha cercato prima nel suo catalogo di dati e ha caricato i layer ufficiali delle scuole della città. Quando il feed nazionale dei trasporti non etichettava i tram di Lione, è passato a OpenStreetMap per le fermate e i binari del tram. Ha scritto Python due volte, per misurare la distanza di ogni scuola dalla fermata più vicina.

Altri tre compiti, e uno in cui QGIS MCP è stato più veloce
Una sola gara dimostra poco, quindi ho cronometrato altri tre compiti allo stesso modo. Non vanno tutti a nostro favore:
| Compito | QGIS MCP, con Claude Code | AI Agent |
|---|---|---|
| Edifici del centro storico di Porto per tipo, su una mappa di base satellitare | 1 min 44 s | 1 min 21 s |
| Lo stesso, più un layout PDF A4 con titolo, legenda, barra di scala e freccia del nord | 2 min 48 s | 5 min 26 s |
| Edifici a York a rischio di alluvione fluviale, da dati dell'Environment Agency | Non finito dopo 15 min, niente sulla mappa | Non finito dopo 15 min, caricata una parte dei dati sulle alluvioni, nessun conteggio |
Quando i dati sono a un solo download di OpenStreetMap di distanza, QGIS MCP tiene il passo, e sul layout PDF è stato circa il doppio più rapido. La sua stessa risposta avvertiva che ha esportato il PDF senza controllare che le tile satellitari fossero caricate. Il divario si apre quando il modello deve trovare e scaricare i dati da solo, come a Lione. Nessuno dei due strumenti ha finito il compito sulle alluvioni di York in 15 minuti. Una prima prova su Porto il 26 settembre è costata a QGIS MCP 8 min 29 s perché quel giorno i server di download erano sovraccarichi, quindi ho cronometrato tutto di nuovo.
Come abbiamo misurato. Stesso computer, entrambi gli strumenti in esecuzione nello stesso momento, QGIS 3.44.15, un progetto nuovo e impostazioni predefinite tranne l'effort di AI Agent, impostato su Medium. Una prova ciascuno, senza ripetizioni: QGIS MCP 0.15.2 pilotato da Claude Code su Claude Sonnet 5.5 con solo gli strumenti di QGIS consentiti, e AI Agent 1.9.0 in modalità Balanced. Il tempo di QGIS MCP è il tempo di esecuzione di Claude Code, che esclude i 52 secondi impiegati dal client per avviarsi. Il computer era molto carico e i server di OpenStreetMap hanno dato errori a entrambi gli strumenti durante la gara di Lione. Abbiamo filmato ogni esecuzione.
Puoi inviare la stessa richiesta nel tuo QGIS in pochi minuti: installa il plugin, accedi e incollala nel pannello.
Dove QGIS MCP mostra i suoi limiti
Questi sono i limiti che ho incontrato o trovato documentati, ciascuno con la sua fonte:
- La chat è fuori da QGIS. Passi da una finestra all'altra. Il modello lavora sui risultati degli strumenti e vede la mappa solo quando chiede a QGIS un'immagine.
- Quattro parti mobili. Quando non succede niente, il guasto può essere nelle impostazioni del client, in
uv, nel server, nella porta o nel plugin. La pagina di risoluzione dei problemi del progetto elenca "No response from QGIS",Connection refusedeModuleNotFoundErrorcome errori più comuni. - Una trappola su Windows. Il README avverte che Claude Desktop installato dal Microsoft Store esegue i server in una sandbox che rompe la configurazione abituale, quindi una configurazione che funziona altrove lì fallisce.
- Qualsiasi Python, nessuna password di default. Lo strumento
execute_codeesegue qualsiasi PyQGIS (il codice Python di QGIS) scritto dal modello. Lo dice il README: "By default the socket has no authentication... any process on the machine that can reach the port can drive QGIS (including execute_code, which runs arbitrary PyQGIS)." Un fork, QGIS Agent MCP, esiste soprattutto per eliminare questo strumento. - Nessun dato proprio. Controlla QGIS, ma trovare e scaricare i dati spetta al modello, di solito scrivendo Python. Nel test di Lione, 6 dei suoi 10 passaggi erano Python, e i download hanno bloccato QGIS per circa sette minuti.
- Nessun annullamento per un'intera richiesta. L'annullamento di QGIS copre le modifiche, non i layer aggiunti né i file scritti.
- La copia con più stelle non è quella mantenuta. L'originale su GitHub, jjsantos01/qgis_mcp, ha 1.099 stelle, nessuna modifica al codice dal 1 ottobre 2025 e una issue aperta intitolata "Broken plugin for QGIS version 4.01". La versione mantenuta, nkarasiak/qgis-mcp, è quella presente nel repository dei plugin di QGIS.
Dove il web sbaglia
"Serve Claude Pro." I server MCP locali funzionano con il piano gratuito di Claude, entro i suoi limiti giornalieri. Il vincolo del piano a pagamento riguarda ChatGPT, che comunque non può raggiungere direttamente un server sul tuo computer.
"Riavvia il computer dopo aver modificato la configurazione." Basta riavviare l'app client. Su Windows, assicurati che sia chiusa del tutto, perché resta in esecuzione nell'area di notifica.
"Installa il repository con più stelle." Installa invece dal gestore dei plugin di QGIS, che ti dà la versione mantenuta.
Altri modi per collegare Claude a QGIS
Il plugin qui sopra è quello a cui pensano la maggior parte delle guide, ma altri tre progetti portano Claude in QGIS. Letti sulle loro pagine il 23 ottobre 2026:
- piatkowski/qgis-mcp: un progetto separato con lo stesso nome, pensato per Claude Desktop. Si installa da uno ZIP nella pagina delle release su GitHub, non dal gestore dei plugin, richiede Python 3.12 o successivo per il suo server e inizia ad ascoltare sulla porta 9876 appena il plugin viene attivato. Anche il plugin qui sopra usa la porta 9876, quindi usane uno alla volta.
- ClaudIA QGIS: derivato dal plugin qui sopra, con la porta locale sostituita da una connessione alla community agrônomo10X via HTTPS, quindi non c'è Python da installare. Serve un account agrônomo10X, e la sua release 0.2.3 del 15 settembre 2026 è segnata come sperimentale.
- QGIS Agent: un pannello di chat dentro QGIS con la tua chiave LLM, con un server MCP locale facoltativo che Claude Desktop o Cursor possono pilotare.
Un'alternativa a QGIS MCP: un agente dentro QGIS
Sviluppiamo noi AI Agent, quindi questa sezione parla del nostro plugin. Fa lo stesso lavoro di QGIS MCP da dentro QGIS: la chat è un pannello agganciato accanto alla mappa e il modello è incluso nel plugin. Sui benchmark GeoKTools e GeoExpertQueries di Google, Claude Sonnet 5.5 che pilota QGIS con questo plugin MCP (versione 0.15.1, in Claude Code) ha ottenuto 24,9 su 100 su 41 domande tenute fuori, e AI Agent con effort Low (GPT-6 Luna) 43,8 (i risultati del benchmark).
Le differenze che contano ogni giorno:
- Una sola installazione.
Plugins > Gestisci ed Installa Plugin..., cerca AI Agent by TerraLab, installa, accedi. Nienteuv, niente file di configurazione, niente app separata, nessun server da avviare a ogni sessione. - Vede il tuo progetto. Nomi dei layer, campi, SR, estensione e selezione accompagnano ogni richiesta, e l'agente renderizza la mappa per controllare il proprio lavoro.
- Dati integrati. Un catalogo di 190 fonti di open data, da OpenStreetMap a Sentinel-2 fino agli enti cartografici nazionali, così il modello non scrive codice di download.
- Chiede prima. Con l'impostazione predefinita si ferma prima di eliminare o sovrascrivere, e il Python che modifica il tuo progetto richiede sempre il tuo clic.
- Annullamento per messaggio. Ogni messaggio lascia un punto di ripristino, e con un clic riporti il progetto a quel punto.
Richiede una connessione a internet e invia una descrizione del tuo progetto, mai i tuoi file di dati, a un servizio ospitato nell'UE. C'è un piano gratuito senza carta, e un messaggio conta come una sola esecuzione a prescindere da quanti passaggi richieda. Prova Pro gratis per 7 giorni: aggiungi una carta, annulla prima della fine e non ti viene addebitato nulla.
Prova AI Agent gratis in QGIS, senza carta
QGIS MCP e agente dentro QGIS a confronto
| QGIS MCP | AI Agent | |
|---|---|---|
| Dove chatti | In un'app esterna (Claude Desktop, Cursor, Claude Code) | In un pannello dentro QGIS |
| Cosa installi | Il plugin, uv, un client MCP, una voce di configurazione | Un solo plugin |
| A ogni sessione | Avvii il server in QGIS, tieni aperte entrambe le app | Apri il pannello |
| Modello | Quello che usa il tuo client, sul tuo piano | Incluso |
| Catalogo di open data | No | 190 fonti |
| Esegue Python | Sì, senza chiedere di default | Chiede prima del codice che modifica il progetto |
| Annulla un'intera richiesta | No | Sì, con un clic |
| Prezzo | Plugin gratuito, più il tuo piano AI | Piano gratuito, poi Pro a 49 € al mese |
| Ideale per | Sviluppatori che lavorano già in Claude Code o Cursor | Utenti GIS che vogliono il risultato in QGIS |
Quale scegliere?
Se lavori già in Claude Code o Cursor, scrivi Python e vuoi QGIS come uno strumento in più lì dentro, QGIS MCP è adatto e non costa niente oltre al piano AI che già paghi. Se vuoi scrivere un compito GIS e ottenere il risultato nel tuo progetto, senza terminale, uv né una seconda app, un agente dentro QGIS ci arriva con meno da configurare e da mantenere. Questo secondo caso è quello della maggior parte degli utenti GIS che conosco.
Cosa ricordare
QGIS MCP collega un'app AI esterna a QGIS, come Claude Desktop, tramite una connessione locale, così il modello dell'app può eseguire strumenti di QGIS e codice Python.
Richiede quattro componenti in esecuzione insieme: l'app client, uv con il server MCP, il plugin QGIS MCP con il suo server avviato, e QGIS.
Il lato QGIS si installa in pochi secondi. Il resto avviene fuori da QGIS: installare uv, un'app AI, un comando da terminale, e fare di nuovo clic su Run MCP dopo ogni riavvio.
Sul compito di Lione, AI Agent ha risposto in 5 min 35 s dai layer ufficiali delle scuole della città. QGIS MCP ha impiegato 9 min 28 s e ha scritto Python per 6 dei suoi 10 passaggi. Sui compiti più semplici il divario si riduce, e su un layout PDF QGIS MCP è stato più veloce.
ChatGPT non può usare direttamente un server MCP locale. Il piano gratuito di Claude funziona, entro i suoi limiti giornalieri.
Un agente dentro QGIS, come AI Agent, fa lo stesso lavoro da un solo plugin, con il modello, un catalogo di dati e l'annullamento con un clic inclusi.
Domande frequenti
Un plugin di QGIS e un server MCP locale che permettono a un'app AI di controllare QGIS tramite il Model Context Protocol. Chatti nell'app, di solito Claude Desktop o Claude Code, e il modello chiama strumenti di QGIS: caricare layer, eseguire Processing, applicare stili, renderizzare la mappa ed eseguire Python.
Installa il plugin QGIS MCP dal gestore dei plugin e fai clic su Run MCP, installa uv, poi aggiungi il server QGIS MCP al file di configurazione di Claude Desktop, oppure esegui il comando claude mcp add in Claude Code, e riavvia il client. Oppure installa un plugin agente che funziona dentro QGIS con un proprio modello, come AI Agent, che elimina client, uv e configurazione.
Non direttamente. Il centro assistenza di OpenAI dice che ChatGPT si collega a server MCP su internet, quindi un server sul tuo computer, come QGIS MCP, avrebbe bisogno di un tunnel per essere raggiungibile. La modalità sviluppatore, che MCP richiede, è limitata ai piani ChatGPT a pagamento.
Può eseguire qualsiasi Python scritto dal modello dentro QGIS e, di default, il socket locale non ha autenticazione, come dichiara il suo README. Usalo su una macchina di cui ti fidi, imposta il token con segreto condiviso se altri usano la stessa macchina, ferma il server quando hai finito e tieni copie di backup dei progetti importanti.
Le cause più comuni, dalla guida alla risoluzione dei problemi del progetto: il server non è avviato in QGIS (Connection refused, fai clic su Run MCP), uv non è installato o non viene trovato (ModuleNotFoundError), oppure la porta non è la 9876. Dopo un riavvio di QGIS il server è di nuovo spento, a meno che l'avvio automatico sia attivo. Su Windows, un'installazione di Claude Desktop dal Microsoft Store richiede la forma --directory della configurazione.
Sì. I plugin agente funzionano dentro QGIS come pannello di chat, senza app esterne né server locale. A settembre 2026 abbiamo contato 38 plugin agente e assistente nel repository ufficiale. Il nostro, AI Agent, include il modello, 190 fonti di open data e l'annullamento con un clic, con un piano gratuito.
Cos'è un agente AI in QGIS conta tutti i 38 plugin agente e assistente del repository ufficiale, ponti MCP compresi. La guida ad AI Agent mostra dieci esecuzioni reali con i loro prompt, e PyQGIS misura quanto spesso il codice scritto da un chatbot funziona al primo colpo. L'hub QGIS AI confronta il resto del panorama.
Continua a leggereClaude e QGIS: 3 modi per collegarli, testati su un compito reale
Fallo in QGIS semplicemente chiedendolo
AI Agent esegue l'attività che descrivi, direttamente nel tuo progetto QGIS. Gratis, senza carta.


