QGIS MCP: Einrichtung, Grenzen und eine einfachere Option

QGIS MCP ist ein kostenloses QGIS-Plugin samt einem kleinen Programm auf Ihrem Rechner, mit dem eine KI-App außerhalb von QGIS, meist Claude Desktop oder Claude Code, QGIS steuert. Sie tippen in der KI-App, sie schickt Befehle über eine lokale Verbindung an QGIS, und QGIS führt sie aus: Layer laden, Verarbeitungswerkzeuge starten, die Karte gestalten oder Python-Code ausführen.

Die Idee ist gut und das Plugin sauber gemacht. Nicolas Karasiak pflegt die Version im offiziellen QGIS-Repository, die am 26. September 2026 auf 52.575 Downloads kam. Was Tutorials auslassen: wie viel Aufwand bis zum Start nötig ist und wo die Grenzen liegen. Ich habe es von Grund auf eingerichtet und dieselbe Aufgabe dann an QGIS MCP und an einen Agenten gegeben, der in QGIS läuft. Den zweiten, AI Agent, bauen wir selbst. Bewerten Sie meine Schlussfolgerungen also mit diesem Wissen.

Was MCP ist, in einem Absatz

MCP, das Model Context Protocol, ist ein offener Standard von Anthropic, mit dem KI-Apps externe Werkzeuge nutzen. Die offizielle Einführung nennt es „einen USB-C-Anschluss für KI-Anwendungen“. Die KI-App heißt Client. Ein Server stellt ihr Werkzeuge bereit. QGIS MCP ist ein Server, dessen Werkzeuge QGIS-Aktionen sind. Das Protokoll benennt das Risiko offen: „Tools represent arbitrary code execution and must be treated with appropriate caution.“

So funktioniert QGIS MCP

Vier Teile müssen gleichzeitig installiert sein und laufen:

1. Ein MCP-Client: die KI-App, in der Sie tippen, etwa Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI oder Gemini CLI.
2. Der MCP-Server: ein kleines Python-Programm, das der Client im Hintergrund über uv startet, ein Werkzeug zum Installieren und Ausführen von Python-Programmen. uv installieren Sie zuerst.
3. Das Plugin QGIS MCP: Es lauscht in QGIS auf einem lokalen Netzwerkport, der Nummer 9876, auf Befehle. Zum Starten klicken Sie in seiner Werkzeugleiste auf Run MCP.
4. QGIS selbst, mit geöffnetem Projekt.

Wenn Sie eine Anfrage eingeben, wählt das KI-Modell ein QGIS-Werkzeug, der Server reicht den Aufruf an das Plugin weiter, und das Plugin führt ihn in QGIS aus und schickt das Ergebnis zurück. Das Modell sieht Ihren Bildschirm nicht. Die Karte sieht es nur, wenn es QGIS um ein Bild davon bittet.

Was Sie vor dem Start brauchen

Eine viel gelesene Einrichtungsanleitung behauptet, Sie bräuchten ein kostenpflichtiges Claude-Pro-Konto. Das stimmt nicht. Die Dokumentation von Anthropic zu lokalen MCP-Servern nennt keinen Tarif, und ein GIS-Blogger hat QGIS MCP im August 2026 im kostenlosen Tarif von Claude betrieben und lediglich das Tageslimit für Nachrichten erreicht. Bei ChatGPT ist es schwieriger. Laut Hilfecenter von OpenAI verbindet es sich nur mit MCP-Servern im Internet, nicht mit einem auf Ihrem Rechner, und der nötige Entwicklermodus ist bezahlten Tarifen vorbehalten.

QGIS MCP einrichten, mit Stoppuhr

Ich habe QGIS MCP 0.15.0 am 26. September 2026 unter QGIS 3.44 installiert und jeden Schritt notiert. Die Seite des Plugins sagt es offen: „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.“

Im Configurator, den der Screenshot unten zeigt, wählen Sie Ihren Client und kopieren den Terminalbefehl.

Mein Durchlauf dauerte etwa drei Minuten, aber uv und ein Client waren schon installiert, und ein Skript hat geklickt. Beim ersten Mal liest man zusätzlich die Dokumentation, installiert uv und einen Client und tippt den Befehl.

Ein Teil kehrt jeden Tag wieder. Nach einem QGIS-Neustart bleibt der Server aus, solange Sie im Configurator nicht den Autostart aktivieren. Die KI-App meldet dann nur „Error executing tool ping“, und Sie müssen selbst darauf kommen, dass erneut ein Klick auf Run MCP hilft.

Dieselbe Aufgabe, auf beiden Wegen

Beiden Werkzeugen habe ich in einem frischen QGIS-Projekt dieselbe Anfrage gegeben: „Load the buildings of the historic centre of Porto, Portugal from OpenStreetMap, colour them by building type, add a satellite basemap underneath, and tell me how many buildings there are.“

Beide Zahlen stimmen für das Gebiet, das jedes Werkzeug gewählt hat, deshalb unterscheiden sie sich. Der Unterschied liegt im Weg dorthin. QGIS MCP hat kein Datenwerkzeug, also schrieb das Modell Python, um OpenStreetMap-Daten herunterzuladen. Als die Download-Server langsam waren, froren seine Wiederholungen QGIS jeweils bis zu einer Minute lang ein. Zu seinen Gunsten: Es bemerkte seinen eigenen Fehler, der 37 Gebäude verschluckt hatte, und behob ihn.

AI Agent nutzte sein eingebautes OpenStreetMap-Werkzeug, suchte die tatsächliche Grenze der Altstadt, schnitt die Gebäude darauf zu und gestaltete sie, ohne Code zu schreiben. Seine Satellitenbasiskarte ist bei diesem Zoom unschärfer als die, die QGIS MCP gewählt hat.

So haben wir gemessen. Derselbe Rechner, QGIS 3.44.7, dieselbe Anfrage, frisches Projekt und Standardeinstellungen, mit QGIS MCP 0.15.0 über Claude Code auf Claude Sonnet und AI Agent 1.4.1. Beide Zahlen haben wir selbst geprüft, die eine gegen OpenStreetMap für das Rechteck, die andere durch Zählen des fertigen Layers für die Grenze. Während des Laufs mit QGIS MCP waren die Download-Server überlastet, was Zeit kostete. Ein erster Versuch mit AI Agent brachte QGIS zum Absturz, ein Fehler, den wir erfasst haben. Seine Werte stammen deshalb aus dem zweiten Durchlauf.

Dieselbe Anfrage können Sie in wenigen Minuten in Ihrem eigenen QGIS senden: Plugin installieren, anmelden und in das Bedienfeld einfügen.

AI Agent kostenlos in QGIS testen, ohne Kreditkarte

Wo QGIS MCP an Grenzen stößt

Das sind die Grenzen, auf die ich gestoßen bin oder die dokumentiert sind, jeweils mit Quelle:

• Der Chat liegt außerhalb von QGIS. Sie wechseln zwischen zwei Fenstern. Das Modell arbeitet mit Werkzeugergebnissen und sieht die Karte nur, wenn es QGIS um ein Bild davon bittet.
• Vier bewegliche Teile. Wenn nichts passiert, kann der Fehler in den Client-Einstellungen, bei uv, im Server, am Port oder im Plugin liegen. Die Fehlerseite des Projekts nennt „No response from QGIS“, Connection refused und ModuleNotFoundError als übliche Fehler.
• Eine Windows-Falle. Die README warnt, dass Claude Desktop aus dem Microsoft Store Server in einer Sandbox ausführt, die die übliche Einrichtung bricht. Eine Konfiguration, die anderswo funktioniert, scheitert dort.
• Beliebiger Python-Code, standardmäßig ohne Passwort. Das Werkzeug execute_code führt jeden PyQGIS-Code (den Python-Code von QGIS) aus, den das Modell schreibt. Die README sagt es selbst: „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).“ Ein Fork, QGIS Agent MCP, existiert vor allem, um dieses Werkzeug zu entfernen.
• Keine eigenen Daten. Es steuert QGIS, aber Daten zu finden und herunterzuladen bleibt dem Modell überlassen, meist durch selbst geschriebenen Python-Code. In meinem Test waren 17 seiner 28 Aktionen Python, und seine Download-Wiederholungen froren QGIS jeweils 40 bis 62 Sekunden lang ein.
• Kein Rückgängig für eine ganze Anfrage. Das Rückgängig von QGIS gilt für Bearbeitungen, nicht für hinzugefügte Layer oder geschriebene Dateien.
• Die Kopie mit den meisten Sternen ist nicht die gepflegte. Das Original auf GitHub, jjsantos01/qgis_mcp, hat 1.099 Sterne, seit dem 1. Oktober 2025 keine Codeänderung und ein offenes Issue mit dem Titel „Broken plugin for QGIS version 4.01“. Die gepflegte Version, nkarasiak/qgis-mcp, ist die im QGIS-Plugin-Repository.

Was das Netz falsch darstellt

„Sie brauchen Claude Pro.“ Lokale MCP-Server funktionieren im kostenlosen Tarif von Claude, innerhalb seiner Tageslimits. Die Bezahlschranke gibt es bei ChatGPT, das einen Server auf Ihrem Rechner ohnehin nicht direkt erreichen kann.

„Starten Sie den Rechner nach dem Bearbeiten der Konfiguration neu.“ Ein Neustart der Client-App genügt. Unter Windows muss sie vollständig beendet sein, da sie im Infobereich der Taskleiste weiterläuft.

„Installieren Sie das Repository mit den meisten Sternen.“ Installieren Sie stattdessen über die Erweiterungsverwaltung von QGIS. So erhalten Sie die gepflegte Version.

Die einfachere Option: ein Agent in QGIS

Wir bauen AI Agent, dieser Abschnitt handelt also von unserem eigenen Plugin. Es erledigt dieselbe Arbeit wie QGIS MCP, aber in QGIS: Der Chat ist ein Bedienfeld neben Ihrer Karte, und das Modell gehört zum Plugin.

Die Unterschiede, die im Alltag zählen:

• Eine Installation. Erweiterungen > Erweiterungen verwalten und installieren…, nach AI Agent by TerraLab suchen, installieren, anmelden. Kein uv, keine Konfigurationsdatei, keine zweite App, kein Server, der in jeder Sitzung gestartet werden muss.
• Es kennt Ihr Projekt. Layernamen, Felder, KBS, Ausdehnung und Auswahl gehen mit jeder Anfrage mit, und es rendert die Karte, um seine eigene Arbeit zu prüfen.
• Daten eingebaut. Ein Katalog mit 55 Open-Data-Quellen, von OpenStreetMap über Sentinel-2 bis zu nationalen Kartierungsbehörden, damit das Modell keinen Download-Code schreiben muss.
• Es fragt zuerst. In der Standardeinstellung hält es vor dem Löschen oder Überschreiben an, und Python-Code, der Ihr Projekt ändert, braucht immer Ihren Klick.
• Rückgängig pro Nachricht. Jede Nachricht hinterlässt einen Wiederherstellungspunkt, und ein Klick setzt das Projekt darauf zurück.

Es braucht eine Internetverbindung und sendet eine Beschreibung Ihres Projekts, nie Ihre Datendateien, an einen Dienst, der in der EU gehostet wird. Es gibt einen kostenlosen Tarif ohne Kreditkarte, und eine Nachricht zählt als eine Aufgabe, egal wie viele Schritte sie umfasst.

AI Agent kostenlos in QGIS testen, ohne Kreditkarte

QGIS MCP und ein Agent in QGIS im direkten Vergleich

Welche Option passt zu Ihnen?

Wenn Sie schon in Claude Code oder Cursor arbeiten, Python schreiben und QGIS als weiteres Werkzeug dort einbinden wollen, passt QGIS MCP gut, und es kostet nichts zusätzlich zum KI-Tarif, den Sie ohnehin zahlen. Wenn Sie eine GIS-Aufgabe eintippen und das Ergebnis in Ihrem Projekt sehen wollen, ohne Terminal, uv oder zweite App, kommt ein Agent in QGIS mit weniger Einrichtung und Wartung ans Ziel. Das ist der Fall der meisten GIS-Anwender, die ich kenne.

Was Sie mitnehmen sollten

QGIS MCP verbindet eine KI-App außerhalb von QGIS, etwa Claude Desktop, über eine lokale Verbindung mit QGIS, sodass das Modell der App QGIS-Werkzeuge und Python ausführen kann.

Es braucht vier Teile, die gemeinsam laufen: die Client-App, uv und den MCP-Server, das Plugin QGIS MCP mit gestartetem Server und QGIS.

Die QGIS-Seite ist in Sekunden installiert. Der Rest passiert außerhalb von QGIS: uv installieren, eine KI-App, ein Terminalbefehl und nach jedem Neustart erneut auf Run MCP klicken.

Bei derselben Aufgabe in Porto antwortete AI Agent in 1 Minute 11 Sekunden mit 15 Aktionen und ohne Code. QGIS MCP brauchte 8 Minuten 29 Sekunden und schrieb für 17 seiner 28 Aktionen Python.

ChatGPT kann einen lokalen MCP-Server nicht direkt nutzen. Der kostenlose Tarif von Claude funktioniert, innerhalb seiner Tageslimits.

Ein Agent in QGIS wie AI Agent erledigt dieselbe Arbeit mit einem einzigen Plugin, inklusive Modell, Datenkatalog und Rückgängig per Klick.

Häufige Fragen

Was ist QGIS MCP?

Ein QGIS-Plugin und ein lokaler MCP-Server, über die eine KI-App QGIS per Model Context Protocol steuert. Sie chatten in der App, meist Claude Desktop oder Claude Code, und das Modell ruft QGIS-Werkzeuge auf: Layer laden, Verarbeitungswerkzeuge starten, gestalten, die Karte rendern und Python ausführen.

Wie verbinde ich Claude mit QGIS?

Installieren Sie das Plugin QGIS MCP über die Erweiterungsverwaltung und klicken Sie auf Run MCP, installieren Sie uv, tragen Sie dann den QGIS-MCP-Server in die Konfigurationsdatei von Claude Desktop ein oder führen Sie in Claude Code den Befehl claude mcp add aus, und starten Sie den Client neu. Oder installieren Sie ein Agent-Plugin, das mit eigenem Modell in QGIS läuft, etwa AI Agent. Dort entfallen Client, uv und Konfiguration.

Kann ChatGPT QGIS MCP nutzen?

Nicht direkt. Laut Hilfecenter von OpenAI verbindet sich ChatGPT mit MCP-Servern im Internet. Ein Server auf Ihrem Rechner wie QGIS MCP bräuchte also einen Tunnel, um erreichbar zu sein. Der Entwicklermodus, den MCP voraussetzt, ist bezahlten ChatGPT-Tarifen vorbehalten.

Ist QGIS MCP sicher?

Es kann in QGIS jeden Python-Code ausführen, den das Modell schreibt, und der lokale Socket hat standardmäßig keine Authentifizierung, wie die README selbst sagt. Nutzen Sie es auf einem Rechner, dem Sie vertrauen, setzen Sie das gemeinsame Token, wenn andere den Rechner mitnutzen, beenden Sie den Server nach der Arbeit und sichern Sie wichtige Projekte.

Warum verbindet sich QGIS MCP nicht?

Die üblichen Ursachen laut Fehlerseite des Projekts: Der Server ist in QGIS nicht gestartet (Connection refused, auf Run MCP klicken), uv ist nicht installiert oder wird nicht gefunden (ModuleNotFoundError), oder der Port ist nicht 9876. Nach einem QGIS-Neustart ist der Server wieder aus, sofern der Autostart nicht aktiviert ist. Unter Windows braucht eine Microsoft-Store-Installation von Claude Desktop die Form --directory in der Konfiguration.

Gibt es eine Alternative zu QGIS MCP?

Ja. Agent-Plugins laufen als Chat-Bedienfeld in QGIS, ohne externe App und ohne lokalen Server. Im September 2026 haben wir 38 Agent- und Assistenten-Plugins im offiziellen Repository gezählt. Unser AI Agent enthält das Modell, 55 Open-Data-Quellen und Rückgängig per Klick, mit kostenlosem Tarif.

Was ein KI-Agent in QGIS ist zählt alle 38 Agent- und Assistenten-Plugins im offiziellen Repository, einschließlich der MCP-Brücken. Der Leitfaden zu AI Agent zeigt zehn echte Durchläufe mit ihren Prompts, und PyQGIS misst, wie oft von Chatbots geschriebener Code auf Anhieb läuft. Der QGIS-KI-Hub vergleicht das weitere Feld.