QGIS MCP: installatie, beperkingen en alternatief

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:

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

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

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, in een leeg QGIS-project: “Laad de gebouwen van het historische centrum van Porto, Portugal uit OpenStreetMap, kleur ze op gebouwtype, voeg eronder een satellietbasiskaart toe en vertel me hoeveel gebouwen het er zijn.”

Beide aantallen kloppen voor het gebied dat elke tool koos, en daarom verschillen ze. Het verschil zit in de weg ernaartoe. QGIS MCP heeft geen databrontool, dus schreef het model Python om OpenStreetMap-data te downloaden. Toen de downloadservers traag waren, bevroren de herhaalpogingen QGIS tot een minuut per keer. Het verdient wel een pluim: het ving zelf een bug op die 37 gebouwen had laten vallen, en loste die op.

AI Agent gebruikte zijn ingebouwde OpenStreetMap-tool, zocht de echte grens van het historische centrum op, clipte de gebouwen daarop en maakte ze op, zonder code te schrijven. De satellietbasiskaart is bij deze zoomstand wazig, onscherper dan die QGIS MCP koos.

Zo hebben we gemeten. Dezelfde computer, QGIS 3.44.7, hetzelfde verzoek, een leeg project en standaardinstellingen, met QGIS MCP 0.15.0 aangestuurd door Claude Code op Claude Sonnet, en AI Agent 1.4.1. We controleerden beide aantallen zelf, tegen OpenStreetMap voor de rechthoek en door de uiteindelijke laag te tellen voor de grens. De downloadservers waren tijdens de run met QGIS MCP overbelast, wat tijd kostte, en een eerste poging met AI Agent liet QGIS crashen, een bug die we hebben geregistreerd, dus de cijfers van AI Agent komen uit de herhaling.

Je kunt hetzelfde verzoek in je eigen QGIS binnen een paar minuten versturen: installeer de plugin, log in en plak het in het paneel.

Probeer AI Agent gratis in QGIS, zonder creditcard

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 mijn test waren 17 van de 28 acties Python, en de herhaalde downloadpogingen bevroren QGIS telkens 40 tot 62 seconden.
• 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.

Het simpelere 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.

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 55 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 AI Agent gratis in QGIS, zonder creditcard

QGIS MCP of een agent in QGIS, naast elkaar

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 dezelfde taak in Porto antwoordde AI Agent in 1 min 11 s met 15 acties en zonder code. QGIS MCP had 8 min 29 s nodig en schreef Python voor 17 van zijn 28 acties.

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 is QGIS MCP?

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.

Hoe koppel ik Claude aan QGIS?

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.

Kan ChatGPT QGIS MCP gebruiken?

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.

Is QGIS MCP veilig?

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.

Waarom maakt QGIS MCP geen verbinding?

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.

Is er een alternatief voor QGIS MCP?

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, 55 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.