Claude e QGIS: 3 modi per collegarli, testati su un compito reale

Non esiste un plugin ufficiale di Anthropic per QGIS. Hai tre modi principali per usare Claude con QGIS: collegare Claude Desktop o Claude Code tramite un server MCP per QGIS, chiedere a Claude di scrivere codice PyQGIS da incollare nella Console Python, oppure installare un plugin agente dentro QGIS.

Il 7 novembre 2026 ho testato come se la cava Claude con un compito reale: caricare i distretti e le scuole OpenStreetMap di Pune, in India, contare le scuole per poligono e creare una mappa coropletica. Nessuno dei due script PyQGIS scritti da Claude Sonnet 5.5 ha funzionato così com'era, anche se uno ci è riuscito in 44-48 secondi dopo che ho cambiato l'URL del suo server dati. Un agente dentro QGIS ha completato lo stesso prompt in 45-63 secondi in due prove consecutive.

Quali sono i modi per usare Claude con QGIS?

Collegare Claude a QGIS significa dare al modello di Anthropic un ponte per eseguire strumenti dentro il tuo progetto aperto, oppure copiare script PyQGIS tra una finestra di chat e la Console Python di QGIS. Una terza strada salta il ponte e mette un pannello con un agente AI direttamente dentro QGIS.

La maggior parte dei tutorial mostra solo il ponte Model Context Protocol (MCP). Prima di installare strumenti a riga di comando in più o modificare file di configurazione, conviene vedere cosa richiedono tutte e tre le strade e cosa succede quando dai loro lo stesso lavoro.

Se vuoi fare questo compito a mano senza AI, la strada gratuita in QGIS richiede quattro passaggi: scaricare i confini e i punti amenity=school con Vettore > QuickOSM > QuickOSM..., eseguire Vettore > Strumenti di analisi > Conta punti nel poligono... (native:countpointsinpolygon) e impostare Proprietà layer > Simbologia su Graduato sul nuovo campo del conteggio.

Esiste un plugin Claude nel repository di QGIS?

Nel repository dei plugin QGIS non esiste nessun plugin ufficiale di Anthropic. Quando ho controllato l'indice del repository il 7 novembre 2026 (4.399 plugin per QGIS 3.44 e 1.697 per QGIS 4.0), 45 plugin contenevano la parola "claude" nei metadati, ma 36 di questi si limitavano a citare Claude come assistente di programmazione o avevano un autore di nome Claude.

Solo nove plugin della community collegano davvero un modello o un abbonamento Claude a QGIS:

• QGIS MCP (di Nicolas Karasiak, v0.15.2, 77.002 download al 7 novembre 2026): apre una porta locale così che Claude Desktop, Claude Code o Cursor possano eseguire 125 strumenti dentro QGIS.
• WAI QGIS MCP (v0.3.0, 753 download): si collega a Claude Desktop tramite un unico file di estensione .mcpb, così non devi installare Node.js da solo.
• QGIS Agent (di bunkmr, v2.4.15, 3.783 download), QGIS Agent Mcp (v0.5.0, 3.210 download), QGIS Salah MCP (v1.1.1, 2.037 download) e ClaudIA QGIS (v0.4.6, 784 download): altri server socket MCP o pannelli che usano la tua chiave API.
• LandTalk.AI (v1.5.0, 5.927 download) e AI Copilot (v1.8.0, 2.098 download): pannelli di chat multi-modello che accettano chiavi Claude, OpenAI o Gemini.
• Mapsuke (di MIERUNE, v1.6.0, 1.242 download, aggiornato il 30 ottobre 2026): un pannello di chat dentro QGIS 3.44+ che funziona con il tuo login Claude Code o Codex esistente senza server MCP, a patto di avere installata la CLI di Claude Code.

Il piano Claude che ti serve dipende da come ti colleghi. Secondo le pagine di confronto dei piani di Anthropic (lette il 7 novembre 2026), la chat di Claude Desktop è disponibile nel piano Free oltre che in Pro, Max, Ultra, Team ed Enterprise, e puoi collegare un server MCP locale da Settings > Developer > Edit Config o tramite le Desktop Extensions. Claude Code, lo strumento a riga di comando su cui si basano plugin come Mapsuke e i flussi da CLI, non è incluso nel piano Free e richiede un abbonamento Pro, Max o Ultra.

Il test: mappare le scuole per distretto a Pune

Tutti i tutorial che ho letto per la mappa delle lacune nella SERP testavano Claude su un file che l'autore aveva già sul disco. Nel lavoro GIS reale, spesso chiedi allo strumento di scaricare open data per una città che non ha mai visto.

Ho scritto i criteri di successo prima di eseguire qualsiasi cosa, il 7 novembre 2026. Il prompt era una sola frase:

Load the districts of Pune, India and the schools from OpenStreetMap, count schools per district and make a choropleth.

Ho scelto Pune apposta, perché "distretti di Pune" è ambiguo. Pune è un distretto del Maharashtra diviso in 14 sotto-distretti (taluka o tehsil), mentre la città di Pune è divisa in 15 uffici amministrativi di circoscrizione e 58 circoscrizioni elettorali. Un buon flusso di lavoro o chiede quale confine intendi, o dice chiaramente quale ha caricato.

Strada 2: chiedere a Claude codice PyQGIS da incollare

Per la strada del copia e incolla, ho eseguito Claude Sonnet 5.5 (claude-sonnet-5-5 tramite Claude Code 2.1.306, con tutti gli strumenti e l'accesso al web disattivati, come in una normale finestra di chat) due volte sullo stesso identico prompt, aggiungendo solo "I use QGIS. Write the PyQGIS code I can paste in the QGIS Python console for this task". Se non hai mai usato la console, la nostra guida a PyQGIS spiega come si eseguono gli script.

Claude ha impiegato 77 secondi per generare il primo script di 134 righe e 67 secondi per il secondo di 108 righe. Entrambe le risposte facevano notare che "distretti" è ambiguo, sceglievano admin_level=6 (i 14 taluka del distretto di Pune) e spiegavano come cambiare il livello nel codice. La seconda risposta aggiungeva perfino un avvertimento onesto in fondo: "Non l'ho eseguito, quindi la prima esecuzione è il test."

Nessuno dei due script ha funzionato così come incollato in QGIS 3.44.15:

1. La risposta 1 è fallita dopo 1 secondo con URLError: <urlopen error [Errno 61] Connection refused>. Lo script chiamava il server Overpass pubblico principale (overpass-api.de), che quella mattina rifiutava le connessioni dal nostro IP.
2. La risposta 2 è fallita alla riga 3, prima di qualsiasi chiamata di rete. Ha sollevato ImportError: cannot import name 'QgsClassificationNaturalBreaks' from 'qgis.core'.

In QGIS 3.44, la classe degli intervalli naturali si chiama QgsClassificationJenks, non QgsClassificationNaturalBreaks. Siccome un chatbot senza strumenti non può testare i propri import sulla tua versione di QGIS, basta un solo nome di classe inventato per bloccare tutto lo script. Abbiamo visto lo stesso identico schema di ipotesi alla cieca quando abbiamo testato ChatGPT per QGIS su tre compiti ad Annecy.

Per capire se il primo script di Claude fosse per il resto corretto, ho cambiato una costante nella risposta 1, sostituendo overpass-api.de con il mirror francese overpass.openstreetmap.fr, e l'ho eseguito tre volte su un pannello dei layer pulito. Con un server funzionante, ha finito in 48, 44 e 45 secondi.

I calcoli della risposta 1 erano giusti: ha caricato 14 poligoni di taluka e 447 scuole, e quando ho ricalcolato in modo indipendente i conteggi punto nel poligono, tutte le 447 scuole corrispondevano al campo n_schools senza alcuna discrepanza (246 in Pune City Subdistrict, 75 a Haveli, 55 a Mulshi, fino a 0 a Indapur, Velhe e Ambegaon). La mappa però aveva difetti che una persona deve sistemare: la legenda per quantili stampava classi decimali come 0,0000 - 1,2000 per conteggi di scuole che sono numeri interi, e le etichette al centro si sovrapponevano allo zoom predefinito.

Strada 1: collegare Claude Desktop o Claude Code tramite QGIS MCP

Dare a Claude un server MCP per QGIS risolve il problema della cecità: Claude può ispezionare i tuoi layer, eseguire execute_code, vedere il traceback dell'errore e riprovare.

Non ho rieseguito il server MCP su Pune perché quella mattina il server Overpass pubblico rifiutava la nostra rete e avrebbe bloccato le stesse chiamate a OpenStreetMap. Avevamo però già misurato Claude Sonnet 5.5 alla guida di QGIS MCP (dalla v0.15.0 alla 0.15.2) in Claude Code su quattro compiti reali e un benchmark di 41 domande tra fine settembre e ottobre 2026:

• La configurazione richiede 5 passaggi e circa 3 minuti una volta installati uv e un client, più 16 secondi alla prima chiamata mentre scarica un server di 90 MB che espone 125 strumenti. Ogni volta che riavvii QGIS, devi ricordarti di cliccare di nuovo Run MCP, altrimenti Claude restituisce Error executing tool ping. La nostra guida alla configurazione e al test di QGIS MCP spiega ogni passaggio e ogni file di configurazione.
• Su un compito simile sulle scuole a Lione (contare le scuole entro 300 m da una fermata del tram), Claude + QGIS MCP ha trovato il conteggio giusto (87 scuole) in 9 minuti e 28 secondi. Sei dei suoi dieci passaggi erano Python grezzo, e QGIS si è bloccato per circa 7 minuti mentre lo script riceveva errori Overpass 406, 504 e 502.
• Quando i dati sono già puliti, MCP è veloce. Su un compito di edifici e layout di stampa a Porto, Claude + QGIS MCP ha finito in 2 minuti e 48 secondi, battendo i 5 minuti e 26 secondi del nostro agente.
• Sul benchmark GeoExpertQueries di Google (41 compiti riservati), Claude Sonnet 5.5 con QGIS MCP in Claude Code ha ottenuto 24,9 su 100, contro 43,8 di AI Agent con impegno Low (vedi i risultati completi del benchmark).

Se paghi già Claude Pro o Max e passi la giornata in Claude Code, MCP non costa nulla in più e ti dà piena libertà di combinare script di shell, file locali e QGIS in un solo terminale.

Strada 3: usare un plugin agente dentro QGIS

Siamo noi a sviluppare AI Agent, quindi questa sezione parla del nostro plugin. Invece di collegare un'app esterna a QGIS, aggancia un pannello di chat proprio accanto alla mappa, legge lo stato del tuo progetto, attinge a un catalogo dati integrato (circa 90 fonti e 2.800 dataset, più OpenStreetMap e Overture Maps), controlla un'immagine renderizzata della mappa prima di rispondere e mette un pulsante Annulla modifiche sotto ogni risposta.

Ho eseguito la stessa identica frase su Pune due volte in QGIS 3.44.15 (permessi Balanced, impegno Medium).

Nella prima prova, dopo 11 secondi, il pannello si è fermato e ha mostrato una scheda di chiarimento che chiedeva "Quali suddivisioni di Pune devono usare i conteggi delle scuole?" con due scelte cliccabili: Circoscrizioni della città di Pune e Tehsil del distretto di Pune. Scegliendo Circoscrizioni della città di Pune, il tempo totale dal clic su Invia è stato di 63 secondi in 15 passaggi.

Nella seconda prova, in una chat nuova, non ha fatto la domanda; ha dichiarato nella risposta che usava le 58 circoscrizioni elettorali di Pune come distretti della città e ha finito in circa 45 secondi (16 passaggi), colorando le circoscrizioni con una palette arancione.

Perché entrambe le prove sono riuscite mentre gli script incollati sbattevano contro errori di connessione? Perché l'agente non ha chiamato l'endpoint sovraccarico overpass-api.de da uno script grezzo: ha preso le circoscrizioni elettorali del 2022 da DataMeet e ha recuperato le 256 scuole (108 nodi e 148 way, convertendo le scuole poligonali in punti sulla superficie) tramite i suoi strumenti dati integrati. Quando ho eseguito una verifica indipendente punto nel poligono su entrambi i risultati, tutti i 256 punti delle scuole cadevano dentro le 58 circoscrizioni, senza alcuna discrepanza con il campo attributo schools.

Ha anche tenuto in ordine il pannello dei layer mettendo tre layer intermedi in un gruppo nascosto Working layers, e nella risposta mi ha ricordato che OpenStreetMap non è un censimento ufficiale delle scuole. La mia unica critica: tra la prova 1 e la prova 2 ha cambiato idea sul chiedermi la scelta tra circoscrizioni e tehsil o decidere da solo.

Prova AI Agent gratis in QGIS, senza carta

Quale strada scegliere?

Nel mio lavoro uso ancora Claude da solo, in un browser o in un terminale, quando scrivo uno script di Processing riutilizzabile o faccio il debug di un plugin personalizzato su venti file. In quei casi vuoi leggere il Python, metterlo su Git ed eseguirlo fuori dall'interfaccia grafica. Ricordati solo di incollare nel prompt la tua versione di QGIS, i nomi dei layer, i nomi dei campi e il SR, e aspettati di dover correggere un import o due.

Scegli Claude + QGIS MCP se hai già un abbonamento Claude a pagamento, ti trovi a tuo agio con uv e i file di configurazione JSON, e vuoi mescolare operazioni su file locali e chiamate a QGIS in Claude Desktop o Claude Code. Non costa nulla oltre al tuo piano attuale ed è veloce quando i layer di dati sono già caricati.

Scegli un agente dentro QGIS quando vuoi la mappa e i numeri senza dover badare a traceback Python, timeout di Overpass o porte che non rispondono. Per un analista con una scadenza o per un team che ha bisogno di una simbologia coerente, delle citazioni delle fonti dati e di un Annulla con un clic, avere l'agente e il catalogo dati integrati in QGIS fa risparmiare più tempo. Puoi leggere in cosa differisce l'architettura nella nostra guida su cos'è un agente AI in QGIS, o scoprire tutti gli strumenti attuali nell'hub QGIS AI.

Come l'abbiamo misurato. Tutte le prove su Pune si sono svolte il 7 novembre 2026 tra le 10:29 e le 11:03 ora di Parigi, su macOS con QGIS 3.44.15-Solothurn (Qt 5.15.19). I criteri di successo sono stati scritti alle 10:14, prima del primo prompt. Claude Sonnet 5.5 (claude-sonnet-5-5) è stato chiamato tramite Claude Code 2.1.306 (claude -p --safe-mode --tools "" --model sonnet) in una cartella vuota, senza server MCP né accesso al web; i due script restituiti sono stati eseguiti nel Python di QGIS e verificati con uno script indipendente punto nel poligono. AI Agent 1.9.4 (modalità Balanced, impegno Medium) è stato eseguito due volte sulla stessa frase in progetti puliti. Durante i test sullo stesso Mac giravano altre sessioni QGIS, quindi i tempi reali sono più lenti che su una macchina inattiva. Due prove per strada su un solo compito sono un campione piccolo, e il rifiuto di connessione di overpass-api.de è stato osservato da una sola rete in una sola mattina.

Domande frequenti

Esiste un plugin Claude ufficiale per QGIS?

No. Anthropic non pubblica un plugin per QGIS. Al 7 novembre 2026, il repository dei plugin QGIS conta nove plugin della community che collegano Claude a QGIS, tramite un server Model Context Protocol (MCP) locale (come QGIS MCP e WAI QGIS MCP), tramite la tua chiave API o tramite un login locale di Claude Code (Mapsuke). In alternativa, AI Agent si installa direttamente dal gestore plugin di QGIS, con il modello AI e il catalogo dati integrati.

Claude Desktop può controllare QGIS gratis?

Sì, con dei limiti. Secondo la documentazione dei piani di Anthropic, la chat di Claude Desktop è disponibile nel piano Free e supporta server MCP locali tramite claude_desktop_config.json o le Desktop Extensions (.mcpb). Per usare Claude Code dal terminale serve un piano Claude Pro, Max o Ultra a pagamento.

Claude sa scrivere codice PyQGIS che funziona in QGIS 3.44?

Sì, Claude Sonnet 5.5 scrive PyQGIS ben strutturato, ma siccome non vede la tua installazione di QGIS e non può testare il proprio codice, a volte inventa nomi di classi o si affida a server esterni che falliscono. Nel nostro test su due campioni in QGIS 3.44.15, uno script è fallito con ImportError su QgsClassificationNaturalBreaks (la classe vera è QgsClassificationJenks) e l'altro ha fallito finché non abbiamo cambiato l'URL della sua Overpass API.

Qual è il modo più semplice per usare l'AI dentro QGIS senza configurare MCP?

Installa un plugin agente integrato da Plugins > Gestisci e installa plugin in QGIS. Con AI Agent non ci sono ambienti Python, gestori di pacchetti uv o file di configurazione da mantenere: accedi gratis, ottieni 5 task al mese (300 con Pro) e scrivi la tua richiesta nel pannello agganciato.

Prova AI Agent gratis