Ga naar inhoud
AI Agent
QGIS
Gids

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.

Twee rijen vergelijken architecturen. Bovenste rij, QGIS MCP, vier onderdelen die je installeert, configureert en start: een AI-client zoals Claude Desktop, Claude Code of Cursor met een eigen abonnement, die via stdio praat met een MCP-server, een Python-proces dat met uv wordt gestart via uvx qgis-mcp-server, die via TCP-poort 9876 praat met de QGIS MCP-plugin, een socketserver in QGIS waarin je elke sessie op Run MCP klikt, die je QGIS-project bedient. Onderste rij, AI Agent, één plugin: het paneel AI Agent vast in QGIS, geïnstalleerd via de pluginbeheerder, dat lagen, velden, CRS, bereik en selectie ziet en via HTTPS praat met een agentservice die het model in de EU draait, zonder API-sleutel of clientapp, en je QGIS-project bedient.
Boven: de vier onderdelen die QGIS MCP tegelijk nodig heeft. Onder: een agentplugin die in QGIS zelf draait, in dit geval de onze.

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:

  1. Een MCP-client: de AI-app waarin je typt, zoals Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI of Gemini CLI.
  2. 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 je uv.
  3. 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.
  4. 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

VereisteWaaromKosten
QGIS 3.28 of nieuwerHet minimum van de pluginGratis
Een MCP-clientappWaar je met het model chatGratis niveau met dagelijkse limieten, of een betaald abonnement
uv (Python-pakketrunner)Start de MCP-serverGratis, installeren met één terminalopdracht
Een terminalopdracht of een regel in een configuratiebestandVertelt de client waar de server staatGratis, maar met de hand
De QGIS MCP-pluginDe QGIS-kant van de brugGratis

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

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

  2. Installeer uv

    De server draait via uv, dat niet standaard op Windows en macOS staat. Je installeert het met één opdracht in een terminal.

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

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

  5. Start de server in QGIS

    Klik op Run MCP in de werkbalkknop van de plugin. QGIS logt bij het opstarten “Token authentication disabled (open)”.

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

Links: de pagina van QGIS MCP 0.15.0 van Nicolas Karasiak, 387 stemmen en 52.575 downloads, met een beschrijving die zegt dat de plugin maar de helft van de installatie is en dat je ook de MCP-server qgis-mcp nodig hebt. Rechts: het venster Setup en Configurator van de plugin met claude-code geselecteerd als client, de status Server running on port 9876 en een opdracht om in je terminal uit te voeren, beginnend met claude mcp add.
De pluginpagina en de Configurator. De QGIS-kant is snel; de rest gebeurt in een terminal en in een andere app.

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 CodeAI Agent
Tijd tot het antwoord9 min 28 s5 min 35 s
Stappen10, waarvan 6 Python-code40, waarvan 2 Python-code
Gebruikte dataOpenStreetMap, gedownload met Python die het zelf schreefDe officiële lagen met scholen, colleges en lycea van de Métropole de Lyon, plus OpenStreetMap-tramhaltes en -sporen
Geteld aantal scholen8780 (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.

QGIS na de run met QGIS MCP in Lyon: rode punten voor de scholen binnen 300 m van een tramhalte, blauwe tramlijnen en grijze tramhaltes op een witte achtergrond zonder basiskaart. Het paneel Lagen toont schools_within_300m, tram_lines, tram_stops en een verborgen laag schools_all.
QGIS MCP met Claude Code: 9 min 28 s, 87 scholen, elke download in Python geschreven.

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.

QGIS met rechts het paneel AI Agent. De kaart toont de omtrek van de gemeente Lyon, de tramsporen en de scholen binnen 300 m van een halte, met naam gelabeld en gekleurd als basisscholen, colleges en lycea. Het antwoord van de agent toont een statistiekkaart met 80 scholen (52 basisscholen, 14 colleges, 14 lycea) en afstanden tot de dichtstbijzijnde halte van 14,6 tot 297,2 m, daarna zijn bronnen: scholen van de Métropole de Lyon, OpenStreetMap-tramhaltes en -sporen, de grens van Lyon en een GTFS-extract.
AI Agent: 5 min 35 s, 80 scholen, uit de eigen schoollagen van de stad.

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:

TaakQGIS MCP, met Claude CodeAI Agent
De gebouwen van het historische centrum van Porto op type, op een satellietbasiskaart1 min 44 s1 min 21 s
Hetzelfde, plus een A4-pdf-layout met titel, legenda, schaalbalk en noordpijl2 min 48 s5 min 26 s
Gebouwen in York met risico op rivieroverstroming, uit gegevens van de Environment AgencyNiet af na 15 min, niets op de kaartNiet 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 refused en ModuleNotFoundError als 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_code voert 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 MCPAI Agent
Waar je chatEen externe app (Claude Desktop, Cursor, Claude Code)Een paneel in QGIS
Wat je installeertDe plugin, uv, een MCP-client, een configuratieregelEén plugin
Elke sessieServer starten in QGIS, beide apps open houdenHet paneel openen
ModelWat je client gebruikt, op jouw abonnementInbegrepen
Catalogus met open dataNee190 bronnen
Voert Python uitJa, standaard zonder te vragenVraagt eerst bij code die het project wijzigt
Een heel verzoek ongedaan makenNeeJa, met één klik
PrijsGratis plugin, plus je AI-abonnementFree-abonnement, daarna Pro voor € 49 per maand
Past het best bijOntwikkelaars die al in Claude Code of Cursor werkenGIS-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

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.

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.

Probeer AI Agent gratis
Geschreven doorYvann Barbot
·19 min read

Verder lezen