QGIS MCP: installazione, limiti e alternativa semplice
Pubblicato 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, in un progetto QGIS nuovo: "Carica gli edifici del centro storico di Porto, in Portogallo, da OpenStreetMap, colorali per tipo di edificio, aggiungi sotto una mappa di base satellitare e dimmi quanti edifici ci sono."
| QGIS MCP, con Claude Code | AI Agent | |
|---|---|---|
| Tempo per arrivare alla risposta | 8 min 29 s | 1 min 11 s |
| Azioni | 28, di cui 17 erano codice Python | 15, nessuna in Python |
| Area usata | Un rettangolo disegnato da lui, che include anche la riva opposta del fiume | Il confine del centro storico mappato in OpenStreetMap |
| Edifici contati | 4.445 | 1.914 |
| Conteggio verificato a mano | Corretto per il suo rettangolo | Corretto per il confine |
Entrambi i conteggi sono giusti per l'area scelta da ciascuno strumento, ed è per questo che differiscono. Ciò che cambia è come ci sono arrivati. QGIS MCP non ha uno strumento per i dati, quindi il modello ha scritto codice Python per scaricare i dati di OpenStreetMap. Quando i server di download erano lenti, i tentativi ripetuti hanno bloccato QGIS fino a un minuto per volta. Va riconosciuto che ha individuato da solo un suo errore che aveva fatto perdere 37 edifici, e l'ha corretto.
AI Agent ha usato il suo strumento OpenStreetMap integrato, ha cercato il vero confine del centro storico, ha ritagliato gli edifici su quel confine e ha applicato lo stile, senza scrivere codice. La sua mappa di base satellitare è più sfocata a questo zoom di quella scelta da QGIS MCP.
Come abbiamo misurato. Stesso computer, QGIS 3.44.7, stessa richiesta, progetto nuovo e impostazioni predefinite, con QGIS MCP 0.15.0 pilotato da Claude Code su Claude Sonnet e AI Agent 1.4.1. Abbiamo verificato noi i due conteggi, rispetto a OpenStreetMap per il rettangolo e contando il layer finale per il confine. I server di download erano sovraccarichi durante la prova di QGIS MCP, il che gli è costato tempo, e un primo tentativo con AI Agent ha mandato in crash QGIS, un bug che abbiamo registrato, quindi le sue cifre vengono dalla seconda esecuzione.
Puoi inviare la stessa richiesta nel tuo QGIS in pochi minuti: installa il plugin, accedi e incollala nel pannello.
Prova AI Agent gratis in QGIS, senza carta
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 mio test, 17 delle sue 28 azioni erano Python, e i tentativi di download hanno bloccato QGIS per 40-62 secondi per volta.
- 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.
L'alternativa più semplice: 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.
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 55 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 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 | 55 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.
Sullo stesso compito di Porto, AI Agent ha risposto in 1 min 11 s con 15 azioni e nessun codice. QGIS MCP ha impiegato 8 min 29 s e ha scritto Python per 17 delle sue 28 azioni.
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
Cos'è QGIS MCP?
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.
Come collego Claude a QGIS?
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.
ChatGPT può usare QGIS MCP?
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.
QGIS MCP è sicuro?
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.
Perché QGIS MCP non si connette?
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.
Esiste un'alternativa a QGIS MCP?
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, 55 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.
