Vai al contenuto
AI Agent
QGIS
Guida

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.

Due righe confrontano le architetture. Riga in alto, QGIS MCP, quattro componenti da installare, configurare e avviare: un client AI come Claude Desktop, Claude Code o Cursor con il suo piano, che comunica via stdio con un server MCP, un processo Python lanciato tramite uv con uvx qgis-mcp-server, che comunica via TCP sulla porta 9876 con il plugin QGIS MCP, un server socket dentro QGIS in cui fai clic su Run MCP a ogni sessione, che controlla il tuo progetto QGIS. Riga in basso, AI Agent, un solo plugin: il pannello AI Agent agganciato in QGIS, installato dal gestore dei plugin, che vede layer, campi, SR, estensione e selezione, e comunica via HTTPS con un servizio agente che esegue il modello nell'UE, senza chiave API né app client, e controlla il tuo progetto QGIS.
In alto: i quattro componenti che QGIS MCP richiede in esecuzione insieme. In basso: un plugin agente che vive dentro QGIS, in questo caso il nostro.

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:

  1. Un client MCP: l'app AI in cui scrivi, come Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI o Gemini CLI.
  2. 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 installare uv.
  3. 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.
  4. 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

RequisitoPerchéCosto
QGIS 3.28 o successivoIl minimo richiesto dal pluginGratis
Un'app client MCPDove chatti con il modelloPiano gratuito con limiti giornalieri, o piano a pagamento
uv (esecutore di pacchetti Python)Avvia il server MCPGratis, si installa con un comando da terminale
Un comando da terminale o una voce in un file di configurazioneIndica al client dove trovare il serverGratis, ma a mano
Il plugin QGIS MCPIl lato QGIS del ponteGratis

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."

  1. 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.

  2. Installa uv

    Il server funziona tramite uv, che Windows e macOS non includono. Lo installi con un solo comando da terminale.

  3. 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.

  4. 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.

  5. 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)".

  6. 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.

A sinistra: la pagina di QGIS MCP 0.15.0 di Nicolas Karasiak nel gestore dei plugin, con 387 voti e 52.575 download, e una descrizione che dice che il plugin è solo metà dell'installazione e che serve anche il server MCP qgis-mcp. A destra: la finestra Setup e Configurator del plugin con claude-code selezionato come client, lo stato Server running on port 9876 e un comando da eseguire nel terminale che inizia con claude mcp add.
La pagina del plugin e il suo Configurator. Il lato QGIS è rapido; il resto si fa in un terminale e in un'altra app.

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 CodeAI Agent
Tempo per arrivare alla risposta9 min 28 s5 min 35 s
Passaggi10, di cui 6 erano codice Python40, di cui 2 erano codice Python
Dati usatiOpenStreetMap, scaricati con Python scritto da luiI layer ufficiali di scuole, scuole medie e licei della Métropole de Lyon, più fermate e binari del tram di OpenStreetMap
Scuole contate8780 (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.

QGIS dopo l'esecuzione di QGIS MCP a Lione: punti rossi per le scuole a meno di 300 m da una fermata del tram, linee del tram blu e fermate del tram grigie su sfondo bianco, senza mappa di base. Il pannello Layer elenca schools_within_300m, tram_lines, tram_stops e un layer schools_all nascosto.
QGIS MCP con Claude Code: 9 min 28 s, 87 scuole, ogni download scritto in Python.

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.

QGIS con il pannello AI Agent sulla destra. La mappa mostra il contorno del comune di Lione, i binari del tram e le scuole a meno di 300 m da una fermata, con etichette per nome e colori per primarie, scuole medie e licei. La risposta dell'agente mostra una scheda di statistiche con 80 scuole (52 primarie, 14 scuole medie, 14 licei) e distanze dalla fermata più vicina da 14,6 a 297,2 m, poi le sue fonti: scuole della Métropole de Lyon, fermate e binari del tram di OpenStreetMap, il confine di Lione e un estratto GTFS.
AI Agent: 5 min 35 s, 80 scuole, dai layer scolastici della città.

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:

CompitoQGIS MCP, con Claude CodeAI Agent
Edifici del centro storico di Porto per tipo, su una mappa di base satellitare1 min 44 s1 min 21 s
Lo stesso, più un layout PDF A4 con titolo, legenda, barra di scala e freccia del nord2 min 48 s5 min 26 s
Edifici a York a rischio di alluvione fluviale, da dati dell'Environment AgencyNon finito dopo 15 min, niente sulla mappaNon 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 refused e ModuleNotFoundError come 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_code esegue 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. Niente uv, 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 MCPAI Agent
Dove chattiIn un'app esterna (Claude Desktop, Cursor, Claude Code)In un pannello dentro QGIS
Cosa installiIl plugin, uv, un client MCP, una voce di configurazioneUn solo plugin
A ogni sessioneAvvii il server in QGIS, tieni aperte entrambe le appApri il pannello
ModelloQuello che usa il tuo client, sul tuo pianoIncluso
Catalogo di open dataNo190 fonti
Esegue PythonSì, senza chiedere di defaultChiede prima del codice che modifica il progetto
Annulla un'intera richiestaNoSì, con un clic
PrezzoPlugin gratuito, più il tuo piano AIPiano gratuito, poi Pro a 49 € al mese
Ideale perSviluppatori che lavorano già in Claude Code o CursorUtenti 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

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.

Fallo in QGIS semplicemente chiedendolo

AI Agent esegue l'attività che descrivi, direttamente nel tuo progetto QGIS. Gratis, senza carta.

Prova AI Agent gratis

Continua a leggere