QGIS MCP: installatie, beperkingen en alternatief
Gepubliceerd op Bijgewerkt op
QGIS MCP is een gratis QGIS-plugin plus een klein programma op je computer waarmee een AI-app buiten QGIS, meestal Claude Desktop of Claude Code, QGIS kan bedienen. Je typt in de AI-app, die stuurt opdrachten via een lokale verbinding naar QGIS, en QGIS voert ze uit: lagen laden, Processing-tools draaien, de kaart opmaken of Python-code uitvoeren.

Het idee is goed en de plugin is netjes gemaakt. Nicolas Karasiak onderhoudt de versie in de officiële QGIS-pluginrepository, die op 26 september 2026 op 52.575 downloads stond. Wat tutorials overslaan, is hoeveel er nodig is om het draaiend te krijgen en waar het ophoudt. Ik heb het van nul af opgezet en daarna dezelfde taak gegeven aan QGIS MCP en aan een agent die in QGIS zelf draait. Die tweede bouwen wij, AI Agent, dus weeg mijn conclusies met dat in gedachten.
Wat MCP is, in één alinea
MCP, het Model Context Protocol, is een open standaard van Anthropic waarmee AI-apps externe tools kunnen gebruiken. De officiële introductie noemt het “a USB-C port for AI applications”. De AI-app heet de client. Een server biedt de client tools aan. QGIS MCP is een server waarvan de tools QGIS-acties zijn. Het protocol benoemt het risico zelf ronduit: “Tools represent arbitrary code execution and must be treated with appropriate caution.”
Hoe QGIS MCP werkt
Vier onderdelen moeten tegelijk geïnstalleerd zijn en draaien:
- Een MCP-client: de AI-app waarin je typt, zoals Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI of Gemini CLI.
- De MCP-server: een klein Python-programma dat de client op de achtergrond start via
uv, een tool die Python-programma's installeert en draait. Eerst installeer jeuv. - De QGIS MCP-plugin: in QGIS luistert die naar opdrachten op een lokale netwerkpoort, nummer 9876. Je start hem met een klik op Run MCP in de werkbalkknop van de plugin.
- QGIS zelf, met je project geopend.
Als je een verzoek typt, kiest het AI-model een QGIS-tool, geeft de server de aanroep door aan de plugin, voert de plugin die uit in QGIS en stuurt het resultaat terug. Het model ziet je scherm niet. Het ziet de kaart alleen als het QGIS vraagt om er een afbeelding van te maken.
Wat je nodig hebt voordat je begint
| Vereiste | Waarom | Kosten |
|---|---|---|
| QGIS 3.28 of nieuwer | Het minimum van de plugin | Gratis |
| Een MCP-clientapp | Waar je met het model chat | Gratis niveau met dagelijkse limieten, of een betaald abonnement |
uv (Python-pakketrunner) | Start de MCP-server | Gratis, installeren met één terminalopdracht |
| Een terminalopdracht of een regel in een configuratiebestand | Vertelt de client waar de server staat | Gratis, maar met de hand |
| De QGIS MCP-plugin | De QGIS-kant van de brug | Gratis |
Een veelgelezen installatiegids zegt dat je een betaald Claude Pro-account nodig hebt. Dat klopt niet. De documentatie van Anthropic over lokale MCP-servers noemt geen abonnement, en een GIS-blogger draaide QGIS MCP op het gratis niveau van Claude in augustus 2026 en liep alleen tegen de dagelijkse berichtenlimiet aan. ChatGPT is lastiger. Het helpcentrum van OpenAI zegt dat het alleen verbinding maakt met MCP-servers op internet, niet met een server op je eigen computer, en de ontwikkelaarsmodus die daarvoor nodig is, is voorbehouden aan betaalde abonnementen.
QGIS MCP installeren, met tijden
Ik installeerde QGIS MCP 0.15.0 op QGIS 3.44 op 26 september 2026 en noteerde elke stap. De eigen pagina van de plugin is er eerlijk over: “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.”
Installeer de plugin
Plug-ins > Plug-ins beheren en installeren, zoek QGIS MCP, klik op Plug-in installeren. Dit deel gaat snel: de plugin laadde in 2,7 seconden, zonder herstart.
Installeer uv
De server draait via
uv, dat niet standaard op Windows en macOS staat. Je installeert het met één opdracht in een terminal.Kies een MCP-client
Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI of een andere app die MCP spreekt, met een eigen account en abonnement.
Koppel de client aan QGIS
De Configurator van de plugin toont een opdracht om in je terminal te plakken, zoals
claude mcp add -s user qgis -- uvx ... qgis-mcp-server. Sommige clients willen in plaats daarvan een regel in een instellingenbestand.Start de server in QGIS
Klik op Run MCP in de werkbalkknop van de plugin. QGIS logt bij het opstarten “Token authentication disabled (open)”.
Stuur een eerste bericht
De eerste aanroep downloadt de server, ongeveer 90 MB, en maakt dan verbinding. In mijn test duurde dat 16 seconden, en de client zag 125 QGIS-tools.
In de schermafbeelding hieronder kies je in de Configurator je client en kopieer je de terminalopdracht.

Mijn run duurde ongeveer drie minuten, maar uv en een client stonden al op de computer en een script deed het klikwerk. Wie het voor het eerst doet, leest ook de documentatie, installeert uv en een client en typt de opdracht.
Een deel keert elke dag terug. Na een herstart van QGIS blijft de server uit, tenzij je in de Configurator automatisch starten aanvinkt. De AI-app meldt dan alleen “Error executing tool ping”, en je moet zelf bedenken dat je opnieuw op Run MCP moet klikken.
Dezelfde taak, twee manieren
Ik gaf beide tools hetzelfde verzoek, tegelijk op dezelfde computer, elk in een leeg QGIS-project: “Zoek in Lyon, Frankrijk, de scholen binnen 300 meter van een tramhalte, toon ze op een kaart met de tramlijnen en vertel me hoeveel het er zijn.”
| QGIS MCP, met Claude Code | AI Agent | |
|---|---|---|
| Tijd tot het antwoord | 9 min 28 s | 5 min 35 s |
| Stappen | 10, waarvan 6 Python-code | 40, waarvan 2 Python-code |
| Gebruikte data | OpenStreetMap, gedownload met Python die het zelf schreef | De officiële lagen met scholen, colleges en lycea van de Métropole de Lyon, plus OpenStreetMap-tramhaltes en -sporen |
| Geteld aantal scholen | 87 | 80 (52 basisscholen, 14 colleges, 14 lycea) |
De aantallen verschillen omdat de twee tools andere data gebruikten. QGIS MCP telde OpenStreetMap-scholen bij tramhaltes uit een kader rond Lyon, dus een paar haltes net buiten de stad tellen ook mee, en het zei zelf dat de 87 niet ontdubbeld was. AI Agent gebruikte de officiële schoolregisters van de stad en de gemeentegrens van Lyon.
Het grotere verschil zit in de weg ernaartoe. QGIS MCP heeft geen databrontool, dus schreef het model Python om de Overpass-servers van OpenStreetMap te bevragen. Die antwoordden met fouten (406, 504, daarna twee keer 502), en het probeerde opnieuw. Die Python draaide op de hoofdthread van QGIS, dus QGIS was ongeveer zeven minuten bevroren, en de kaart bleef leeg tot 7 min 22 s.

AI Agent zocht eerst in zijn datacatalogus en laadde de officiële schoollagen van de stad. Toen de nationale openbaarvervoerfeed de trams van Lyon niet benoemde, schakelde hij voor de tramhaltes en -sporen over op OpenStreetMap. Hij schreef twee keer Python, om de afstand van elke school tot de dichtstbijzijnde halte te meten.

Drie andere taken, en één waar QGIS MCP sneller was
Eén race bewijst weinig, dus ik timede drie andere taken op dezelfde manier. Ze gaan niet allemaal onze kant op:
| Taak | QGIS MCP, met Claude Code | AI Agent |
|---|---|---|
| De gebouwen van het historische centrum van Porto op type, op een satellietbasiskaart | 1 min 44 s | 1 min 21 s |
| Hetzelfde, plus een A4-pdf-layout met titel, legenda, schaalbalk en noordpijl | 2 min 48 s | 5 min 26 s |
| Gebouwen in York met risico op rivieroverstroming, uit gegevens van de Environment Agency | Niet af na 15 min, niets op de kaart | Niet af na 15 min, een deel van de overstromingsdata geladen, geen telling |
Als de data één OpenStreetMap-download ver weg is, houdt QGIS MCP het bij, en bij de pdf-layout was het ongeveer twee keer zo snel. Zijn eigen antwoord waarschuwde dat het de pdf exporteerde zonder te controleren of de satelliettegels waren geladen. Het verschil ontstaat als het model de data zelf moet vinden en downloaden, zoals in Lyon. Geen van beide tools maakte de overstromingstaak in York af binnen 15 minuten. Een eerste Porto-run op 26 september kostte QGIS MCP 8 min 29 s omdat de downloadservers die dag overbelast waren, dus ik heb alles opnieuw getimed.
Zo hebben we gemeten. Dezelfde computer, beide tools tegelijk draaiend, QGIS 3.44.15, een leeg project en standaardinstellingen, behalve de effort van AI Agent, die op Medium stond. Eén run per tool, geen herhalingen: QGIS MCP 0.15.2 aangestuurd door Claude Code op Claude Sonnet 5.5 met alleen de QGIS-tools toegestaan, en AI Agent 1.9.0 in de modus Balanced. De tijd van QGIS MCP is de eigen looptijd van Claude Code, waarin de 52 seconden die de client nodig had om te starten niet zijn meegeteld. De computer was zwaar belast en de OpenStreetMap-servers faalden tijdens de race in Lyon voor beide tools. We hebben elke run gefilmd.
Je kunt hetzelfde verzoek in je eigen QGIS binnen een paar minuten versturen: installeer de plugin, log in en plak het in het paneel.
Waar QGIS MCP tekortschiet
Dit zijn de beperkingen waar ik tegenaan liep of die gedocumenteerd zijn, elk met de bron erbij:
- De chat staat buiten QGIS. Je wisselt tussen twee vensters. Het model werkt met de resultaten van tools en ziet de kaart alleen als het QGIS vraagt om er een afbeelding van te maken.
- Vier bewegende delen. Als er niets gebeurt, kan de fout zitten in de clientinstellingen,
uv, de server, de poort of de plugin. De probleemoplossingspagina van het project noemt “No response from QGIS”,Connection refusedenModuleNotFoundErrorals de gebruikelijke fouten. - Een valkuil op Windows. De README waarschuwt dat Claude Desktop uit de Microsoft Store servers in een sandbox draait, wat de gebruikelijke installatie breekt, zodat een configuratie die elders werkt daar faalt.
- Elke Python, standaard geen wachtwoord. De tool
execute_codevoert alle PyQGIS uit (de Python-code van QGIS) die het model schrijft. De README zegt dat zelf: “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).” Eén fork, QGIS Agent MCP, bestaat vooral om die tool te verwijderen. - Geen eigen data. Het bedient QGIS, maar het zoeken en downloaden van data is aan het model, meestal door Python te schrijven. In de Lyon-test was 6 van de 10 stappen Python, en de downloads bevroren QGIS ongeveer zeven minuten.
- Geen ongedaan maken voor een heel verzoek. Ongedaan maken in QGIS geldt voor bewerkingen, niet voor toegevoegde lagen of weggeschreven bestanden.
- De kopie met de meeste sterren is niet de onderhouden kopie. Het origineel op GitHub, jjsantos01/qgis_mcp, heeft 1.099 sterren, geen codewijziging sinds 1 oktober 2025 en een open issue met de titel “Broken plugin for QGIS version 4.01”. De onderhouden versie, nkarasiak/qgis-mcp, is die in de QGIS-pluginrepository.
Waar het web dit verkeerd heeft
“Je hebt Claude Pro nodig.” Lokale MCP-servers werken op het gratis abonnement van Claude, binnen de dagelijkse limieten. De betaalmuur zit bij ChatGPT, dat toch niet rechtstreeks bij een server op je computer kan.
“Herstart je computer na het aanpassen van de configuratie.” Het is genoeg om de clientapp te herstarten. Zorg er op Windows voor dat de app helemaal is afgesloten, want hij blijft draaien in het systeemvak.
“Installeer de repository met de meeste sterren.” Installeer liever via de pluginbeheerder van QGIS, dan krijg je de onderhouden versie.
Andere manieren om Claude met QGIS te verbinden
De plugin hierboven is degene die de meeste gidsen bedoelen, maar drie andere projecten brengen Claude ook in QGIS. Afgelezen op hun eigen pagina's op 23 oktober 2026:
- piatkowski/qgis-mcp: een apart project met dezelfde naam, gebouwd voor Claude Desktop. Het installeert vanuit een ZIP op de releasepagina van GitHub, niet vanuit de pluginbeheerder, vraagt Python 3.12 of nieuwer voor de server en begint op poort 9876 te luisteren zodra de plugin is ingeschakeld. De plugin hierboven gebruikt ook poort 9876, dus draai er steeds maar één.
- ClaudIA QGIS: afgeleid van de plugin hierboven, waarbij de lokale poort is vervangen door een verbinding via HTTPS met de community van agrônomo10X, dus er is geen Python te installeren. Je hebt een agrônomo10X-account nodig, en de release 0.2.3 van 15 september 2026 is als experimenteel gemarkeerd.
- QGIS Agent: een chatpaneel in QGIS op je eigen LLM-sleutel, met een optionele lokale MCP-server die Claude Desktop of Cursor kan aansturen.
Een QGIS MCP-alternatief: een agent in QGIS
Wij bouwen AI Agent, dus deze sectie gaat over onze eigen plugin. Hij doet hetzelfde werk als QGIS MCP vanuit QGIS zelf: de chat is een paneel naast je kaart en het model zit bij de plugin. Op de benchmarks GeoKTools en GeoExpertQueries van Google scoorde Claude Sonnet 5.5, die QGIS via deze MCP-plugin aanstuurt (versie 0.15.1, in Claude Code), 24,9 van de 100 op 41 achtergehouden vragen, en AI Agent op effort Low (GPT-6 Luna) 43,8 (de benchmarkresultaten).
De verschillen die dagelijks tellen:
- Eén installatie. Plug-ins > Plug-ins beheren en installeren, zoek AI Agent by TerraLab, installeer en log in. Geen
uv, geen configuratiebestand, geen aparte app, geen server die je elke sessie moet starten. - Hij ziet je project. Laagnamen, velden, CRS, bereik en selectie gaan mee met elk verzoek, en hij rendert de kaart om zijn eigen werk te controleren.
- Data ingebouwd. Een catalogus van 190 open databronnen, van OpenStreetMap tot Sentinel-2 en nationale kaartdiensten, zodat het model geen downloadcode hoeft te schrijven.
- Hij vraagt eerst. In de standaardinstelling stopt hij vóór het verwijderen of overschrijven, en Python die je project wijzigt, vraagt altijd om jouw klik.
- Ongedaan maken per bericht. Elk bericht laat een herstelpunt achter, en met één klik zet je het project daarnaar terug.
Hij heeft een internetverbinding nodig en stuurt een beschrijving van je project, nooit je databestanden, naar een dienst die in de EU wordt gehost. Er is een Free-abonnement zonder creditcard, en één bericht telt als één taak, hoeveel stappen het ook kost. Probeer Pro 7 dagen gratis: voeg een creditcard toe, zeg op vóór het einde en er wordt niets in rekening gebracht.
Probeer AI Agent gratis in QGIS, zonder creditcard
QGIS MCP of een agent in QGIS, naast elkaar
| QGIS MCP | AI Agent | |
|---|---|---|
| Waar je chat | Een externe app (Claude Desktop, Cursor, Claude Code) | Een paneel in QGIS |
| Wat je installeert | De plugin, uv, een MCP-client, een configuratieregel | Eén plugin |
| Elke sessie | Server starten in QGIS, beide apps open houden | Het paneel openen |
| Model | Wat je client gebruikt, op jouw abonnement | Inbegrepen |
| Catalogus met open data | Nee | 190 bronnen |
| Voert Python uit | Ja, standaard zonder te vragen | Vraagt eerst bij code die het project wijzigt |
| Een heel verzoek ongedaan maken | Nee | Ja, met één klik |
| Prijs | Gratis plugin, plus je AI-abonnement | Free-abonnement, daarna Pro voor € 49 per maand |
| Past het best bij | Ontwikkelaars die al in Claude Code of Cursor werken | GIS-gebruikers die het resultaat in QGIS willen |
Welke kies je?
Als je al in Claude Code of Cursor werkt, Python schrijft en QGIS als extra tool daarin wilt, is QGIS MCP een goede keuze, en het kost niets bovenop het AI-abonnement dat je al betaalt. Als je een GIS-taak wilt typen en het resultaat in je project wilt krijgen, zonder terminal, uv of een tweede app, brengt een agent in QGIS je er met minder opzet en onderhoud. Dat tweede geval geldt voor de meeste GIS-gebruikers die ik ken.
Wat je moet onthouden
QGIS MCP verbindt een AI-app buiten QGIS, zoals Claude Desktop, via een lokale verbinding met QGIS, zodat het model van de app QGIS-tools en Python kan uitvoeren.
Er moeten vier onderdelen tegelijk draaien: de clientapp, uv en de MCP-server, de QGIS MCP-plugin met gestarte server, en QGIS.
De QGIS-kant installeer je in seconden. De rest gebeurt buiten QGIS: uv installeren, een AI-app, een terminalopdracht, en na elke herstart opnieuw op Run MCP klikken.
Bij de taak in Lyon antwoordde AI Agent in 5 min 35 s vanuit de officiële schoollagen van de stad. QGIS MCP had 9 min 28 s nodig en schreef Python voor 6 van zijn 10 stappen. Bij eenvoudigere taken wordt het verschil kleiner, en bij een pdf-layout was QGIS MCP sneller.
ChatGPT kan een lokale MCP-server niet rechtstreeks gebruiken. Het gratis abonnement van Claude werkt wel, binnen de dagelijkse limieten.
Een agent in QGIS, zoals AI Agent, doet hetzelfde werk vanuit één plugin, met model, databroncatalogus en ongedaan maken met één klik inbegrepen.
Veelgestelde vragen
Een QGIS-plugin en een lokale MCP-server waarmee een AI-app QGIS bedient via het Model Context Protocol. Je chat in de app, meestal Claude Desktop of Claude Code, en het model roept QGIS-tools aan: lagen laden, Processing draaien, opmaken, de kaart renderen en Python uitvoeren.
Installeer de QGIS MCP-plugin via de pluginbeheerder en klik op Run MCP, installeer uv, voeg de QGIS MCP-server toe aan het configuratiebestand van Claude Desktop of voer de opdracht claude mcp add uit in Claude Code, en herstart de client. Of installeer een agentplugin die in QGIS zelf draait met een eigen model, zoals AI Agent, waarmee de client, uv en de configuratie wegvallen.
Niet rechtstreeks. Het helpcentrum van OpenAI zegt dat ChatGPT verbinding maakt met MCP-servers op internet, dus een server op je eigen computer, zoals QGIS MCP, heeft een tunnel nodig om bereikbaar te zijn. De ontwikkelaarsmodus die MCP vereist, is beperkt tot betaalde ChatGPT-abonnementen.
Het kan alle Python uitvoeren die het model in QGIS schrijft, en standaard heeft de lokale socket geen authenticatie, zoals de README zegt. Gebruik het op een computer die je vertrouwt, stel de gedeelde geheime token in als anderen de computer delen, stop de server als je klaar bent en bewaar back-ups van belangrijke projecten.
De gebruikelijke oorzaken, uit de probleemoplossingsgids van het project: de server is niet gestart in QGIS (Connection refused, klik op Run MCP), uv is niet geïnstalleerd of wordt niet gevonden (ModuleNotFoundError), of de poort is niet 9876. Na een herstart van QGIS staat de server weer uit, tenzij automatisch starten is aangevinkt. Bij een installatie van Claude Desktop uit de Microsoft Store op Windows heb je de vorm met --directory in de configuratie nodig.
Ja. Agentplugins draaien in QGIS als chatpaneel, zonder externe app of lokale server. In september 2026 telden we 38 agent- en assistentplugins in de officiële pluginrepository. Die van ons, AI Agent, bevat het model, 190 open databronnen en ongedaan maken met één klik, met een Free-abonnement.
Wat een AI-agent in QGIS is telt alle 38 agent- en assistentplugins in de officiële pluginrepository, MCP-bruggen inbegrepen. De handleiding voor AI Agent toont tien echte runs met hun prompts, en PyQGIS meet hoe vaak code van een chatbot meteen draait. De QGIS AI-hub vergelijkt het bredere veld.
Verder lezenClaude met QGIS koppelen: 3 manieren getest op één taak
Doe het in QGIS door erom te vragen
AI Agent voert de taak uit die je beschrijft, in je eigen QGIS-project. Gratis, geen kaart nodig.


