Claude w QGIS: 3 sposoby połączenia, przetestowane na jednym zadaniu

Nie ma oficjalnej wtyczki Anthropic dla QGIS. Masz trzy główne sposoby, by używać Claude z QGIS: podłączyć Claude Desktop lub Claude Code przez serwer MCP dla QGIS, poprosić Claude o kod PyQGIS, który wklejasz do konsoli Pythona, albo zainstalować wtyczkę z agentem w samym QGIS.

7 listopada 2026 sprawdziłem, jak Claude radzi sobie z prawdziwym zadaniem: wczytać dzielnice i szkoły z OpenStreetMap dla Pune w Indiach, policzyć szkoły w każdym poligonie i nadać styl kartogramu. Żaden z dwóch skryptów PyQGIS napisanych przez Claude Sonnet 5.5 nie zadziałał po wklejeniu, choć jeden przeszedł w 44 do 48 sekund, gdy podmieniłem w nim adres serwera danych. Agent w QGIS wykonał ten sam prompt w 45 do 63 sekund w dwóch kolejnych przebiegach.

Jakie są sposoby używania Claude z QGIS?

Połączenie Claude z QGIS oznacza albo danie modelowi Anthropic mostu, przez który uruchamia narzędzia w twoim otwartym projekcie, albo kopiowanie skryptów PyQGIS między oknem czatu a konsolą Pythona w QGIS. Trzecia droga pomija most i umieszcza panel agenta AI bezpośrednio w QGIS.

Większość poradników pokazuje tylko most Model Context Protocol (MCP). Zanim zainstalujesz dodatkowe narzędzia wiersza poleceń albo zaczniesz edytować pliki konfiguracyjne, warto zobaczyć, czego wymagają wszystkie trzy drogi i co się dzieje, gdy dostają to samo zadanie.

Jeśli chcesz zrobić to zadanie ręcznie, bez żadnego AI, darmowa droga w QGIS ma cztery kroki: pobierz granice i punkty amenity=school przez Wektor > QuickOSM > QuickOSM… (Vector > QuickOSM > QuickOSM...), uruchom Vector > Analysis Tools > Count Points in Polygon... (native:countpointsinpolygon) i w Layer Properties > Symbology ustaw styl Graduated na nowym polu z liczbą.

Czy w repozytorium QGIS jest wtyczka Claude?

W repozytorium wtyczek QGIS nie ma oficjalnej wtyczki od Anthropic. Gdy 7 listopada 2026 sprawdziłem indeks repozytorium (4399 wtyczek dla QGIS 3.44 i 1697 dla QGIS 4.0), 45 wtyczek miało słowo „claude” w metadanych, ale 36 z nich jedynie wymieniało Claude jako asystenta przy pisaniu kodu albo miało autora o imieniu Claude.

Tylko dziewięć wtyczek społeczności naprawdę łączy model lub subskrypcję Claude z QGIS:

• QGIS MCP (autor Nicolas Karasiak, v0.15.2, 77 002 pobrania na 7 listopada 2026): otwiera lokalny port, przez który Claude Desktop, Claude Code albo Cursor mogą uruchamiać 125 narzędzi w QGIS.
• WAI QGIS MCP (v0.3.0, 753 pobrania): łączy się z Claude Desktop przez jeden plik rozszerzenia .mcpb, więc nie musisz sam instalować Node.js.
• QGIS Agent (autor bunkmr, v2.4.15, 3783 pobrania), QGIS Agent Mcp (v0.5.0, 3210 pobrań), QGIS Salah MCP (v1.1.1, 2037 pobrań) i ClaudIA QGIS (v0.4.6, 784 pobrania): inne serwery gniazd MCP lub panele, które korzystają z twojego własnego klucza API.
• LandTalk.AI (v1.5.0, 5927 pobrań) i AI Copilot (v1.8.0, 2098 pobrań): panele czatu dla wielu modeli, które przyjmują klucze Claude, OpenAI lub Gemini.
• Mapsuke (autor MIERUNE, v1.6.0, 1242 pobrania, aktualizacja 30 października 2026): panel czatu w QGIS 3.44+, który działa na twoim istniejącym logowaniu do Claude Code lub Codex bez serwera MCP, pod warunkiem że masz zainstalowane CLI Claude Code.

To, jakiego planu Claude potrzebujesz, zależy od sposobu połączenia. Według stron porównania planów Anthropic (czytanych 7 listopada 2026) czat w Claude Desktop jest dostępny w planie Free, a także w Pro, Max, Ultra, Team i Enterprise, a lokalny serwer MCP podłączysz przez Settings > Developer > Edit Config albo przez Desktop Extensions. Claude Code, narzędzie wiersza poleceń, na którym opierają się wtyczki takie jak Mapsuke i przepływy pracy w CLI, nie wchodzi w plan Free i wymaga subskrypcji Pro, Max lub Ultra.

Test: mapa szkół w dzielnicach Pune

Każdy poradnik, który przeczytałem przy analizie luk w wynikach wyszukiwania, testował Claude na pliku, który autor miał już na dysku. W prawdziwej pracy GIS często prosisz narzędzie o pobranie otwartych danych dla miasta, którego nigdy nie widziało.

Kryteria sukcesu spisałem 7 listopada 2026, zanim cokolwiek uruchomiłem. Prompt miał jedno zdanie:

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

(Po polsku: wczytaj dzielnice Pune w Indiach i szkoły z OpenStreetMap, policz szkoły w każdej dzielnicy i zrób kartogram.)

Wybrałem Pune celowo, bo „dzielnice Pune” to określenie niejednoznaczne. Pune to dystrykt w stanie Maharasztra podzielony na 14 jednostek niższego rzędu (taluki, czyli tehsile), a samo miasto Pune dzieli się na 15 biur okręgów administracyjnych i 58 okręgów wyborczych. Dobry przepływ pracy albo zapyta, o które granice chodzi, albo jasno powie, które wczytał.

Droga 2: prośba do Claude o kod PyQGIS do wklejenia

Dla drogi kopiuj-wklej uruchomiłem Claude Sonnet 5.5 (claude-sonnet-5-5 przez Claude Code 2.1.306 z wyłączonymi wszystkimi narzędziami i dostępem do sieci, co odpowiada zwykłemu oknu czatu) dwa razy na dokładnie tym samym prompcie, dopisując tylko „I use QGIS. Write the PyQGIS code I can paste in the QGIS Python console for this task”. Jeśli nigdy nie używałeś konsoli, nasz poradnik o PyQGIS wyjaśnia, jak uruchamia się w niej skrypty.

Wygenerowanie pierwszego skryptu (134 linie) zajęło Claude 77 sekund, a drugiego (108 linii) 67 sekund. Obie odpowiedzi zauważyły, że „districts” jest niejednoznaczne, wybrały admin_level=6 (14 taluk dystryktu Pune) i wyjaśniły, jak zmienić poziom w kodzie. Druga odpowiedź dodała na końcu nawet uczciwe ostrzeżenie: „Nie uruchamiałem tego, więc pierwsze uruchomienie jest testem”.

Żaden skrypt nie zadziałał po wklejeniu w QGIS 3.44.15:

1. Odpowiedź 1 wysypała się po 1 sekundzie z URLError: <urlopen error [Errno 61] Connection refused>. Skrypt wywoływał główny publiczny serwer Overpass (overpass-api.de), który tego ranka odrzucał połączenia z naszego IP.
2. Odpowiedź 2 wysypała się w linii 3, zanim w ogóle sięgnęła do sieci. Zgłosiła ImportError: cannot import name 'QgsClassificationNaturalBreaks' from 'qgis.core'.

W QGIS 3.44 klasa naturalnych przerw nazywa się QgsClassificationJenks, a nie QgsClassificationNaturalBreaks. Chatbot bez narzędzi nie może sprawdzić własnych importów w twojej wersji QGIS, więc jedna zmyślona nazwa klasy zatrzymuje cały skrypt. Dokładnie ten sam schemat zgadywania na ślepo widzieliśmy, gdy testowaliśmy ChatGPT dla QGIS na trzech zadaniach w Annecy.

Żeby sprawdzić, czy pierwszy skrypt Claude był poza tym poprawny, zmieniłem w Odpowiedzi 1 jedną stałą, podmieniając overpass-api.de na francuski mirror overpass.openstreetmap.fr, i uruchomiłem go trzy razy na czystym drzewie warstw. Z działającym serwerem kończył w 48, 44 i 45 sekund.

Obliczenia w Odpowiedzi 1 były poprawne: skrypt wczytał 14 poligonów taluk i 447 obiektów szkół, a gdy niezależnie przeliczyłem punkty w poligonach, wszystkie 447 szkół zgadzały się z polem n_schools bez żadnej rozbieżności (246 w Pune City Subdistrict, 75 w Haveli, 55 w Mulshi, aż do 0 w Indapur, Velhe i Ambegaon). Mapa miała jednak niedoróbki, które musi posprzątać człowiek: legenda kwantylowa pokazywała przedziały z ułamkami, na przykład 0,0000 - 1,2000, dla liczby szkół, która jest zawsze całkowita, a etykiety w centrum nakładały się na siebie przy domyślnym przybliżeniu.

Droga 1: podłączenie Claude Desktop lub Claude Code przez MCP dla QGIS

Serwer MCP dla QGIS rozwiązuje problem ślepoty: Claude może przejrzeć twoje warstwy, uruchomić execute_code, zobaczyć traceback błędu i spróbować ponownie.

Nie uruchamiałem ponownie serwera MCP na Pune, bo publiczny serwer Overpass odrzucał tego ranka naszą sieć i zablokowałby te same wywołania OpenStreetMap. Zmierzyliśmy już jednak wcześniej, jak Claude Sonnet 5.5 steruje QGIS MCP (v0.15.0 do 0.15.2) w Claude Code na czterech prawdziwych zadaniach i w benchmarku z 41 pytaniami, pod koniec września i w październiku 2026:

• Konfiguracja to 5 kroków i około 3 minut, gdy masz już zainstalowane uv i klienta, plus 16 sekund przy pierwszym wywołaniu, kiedy pobiera się serwer o rozmiarze 90 MB udostępniający 125 narzędzi. Po każdym ponownym uruchomieniu QGIS musisz pamiętać, żeby znowu kliknąć Run MCP, inaczej Claude zwraca Error executing tool ping. Nasz poradnik o konfiguracji i teście QGIS MCP omawia każdy krok i plik konfiguracyjny.
• Na porównywalnym zadaniu ze szkołami w Lyonie (liczenie szkół w promieniu 300 m od przystanku tramwajowego) Claude + QGIS MCP podał poprawną liczbę (87 szkół) w 9 minut 28 sekund. Sześć z jego dziesięciu kroków to był surowy Python, a QGIS zawiesił się na około 7 minut, gdy skrypt trafiał na błędy Overpass 406, 504 i 502.
• Gdy dane są już czyste, MCP jest szybki. Na zadaniu z budynkami i układem wydruku w Porto Claude + QGIS MCP skończył w 2 minuty 48 sekund, szybciej niż nasz własny agent (5 minut 26 sekund).
• W benchmarku GeoExpertQueries od Google (41 odłożonych zadań) Claude Sonnet 5.5 z QGIS MCP w Claude Code uzyskał 24,9 na 100, wobec 43,8 dla AI Agent na wysiłku Low (zobacz pełne wyniki benchmarku).

Jeśli już płacisz za Claude Pro lub Max i cały dzień pracujesz w Claude Code, MCP nic dodatkowo nie kosztuje i daje pełną swobodę łączenia skryptów powłoki, plików lokalnych i QGIS w jednym terminalu.

Droga 3: wtyczka z agentem w QGIS

Tworzymy AI Agent, więc ta sekcja dotyczy naszej własnej wtyczki. Zamiast podłączać zewnętrzną aplikację do QGIS, dokuje panel czatu tuż obok okna mapy, czyta stan projektu, korzysta z wbudowanego katalogu danych (około 90 źródeł i 2800 zbiorów danych, do tego OpenStreetMap i Overture Maps), przed odpowiedzią sprawdza wyrenderowany obraz mapy i pod każdą odpowiedzią umieszcza przycisk Cofnij zmiany.

Uruchomiłem to samo zdanie o Pune dwa razy w QGIS 3.44.15 (uprawnienia Balanced, wysiłek Medium).

W pierwszym przebiegu po 11 sekundach panel się zatrzymał i pokazał kartę z pytaniem „Których podziałów Pune użyć do liczenia szkół?” z dwiema opcjami do kliknięcia: okręgi miasta Pune i tehsile dystryktu Pune. Po wybraniu okręgów miasta Pune łączny czas od kliknięcia Wyślij wyniósł 63 sekundy w 15 krokach.

W drugim przebiegu, w nowym czacie, agent nie zadał pytania; w odpowiedzi napisał, że jako dzielnice miasta przyjmuje 58 okręgów wyborczych Pune, i skończył w około 45 sekund (16 kroków), nadając okręgom pomarańczową paletę.

Dlaczego oba przebiegi się udały, a wklejone skrypty trafiły na błędy połączenia? Bo agent nie wywoływał przeciążonego endpointu overpass-api.de z surowego skryptu; pobrał okręgi wyborcze z 2022 r. z DataMeet i ściągnął 256 obiektów szkół (108 węzłów i 148 linii, zamieniając szkoły zapisane jako poligony na punkty na powierzchni) przez swoje wbudowane narzędzia danych. Gdy uruchomiłem niezależne sprawdzenie punktów w poligonach na obu wynikach, wszystkie 256 punktów szkół leżało w 58 okręgach, bez żadnej rozbieżności z polem atrybutu schools.

Utrzymał też porządek w drzewie warstw, chowając trzy warstwy pośrednie do ukrytej grupy Working layers, i przypomniał mi w odpowiedzi, że OpenStreetMap nie jest oficjalnym spisem szkół. Moje jedyne zastrzeżenie: między przebiegiem 1 a 2 zmienił zdanie, czy zapytać mnie o okręgi albo tehsile, czy zdecydować sam.

Wypróbuj AI Agent w QGIS za darmo, bez karty

Którą drogę wybrać?

W mojej własnej pracy nadal używam zwykłego Claude w przeglądarce lub terminalu, gdy piszę skrypt Processing do wielokrotnego użytku albo debuguję własną wtyczkę rozłożoną na dwadzieścia plików. Wtedy chcesz czytać Pythona, commitować go do Gita i uruchamiać poza interfejsem graficznym. Pamiętaj tylko, by wkleić do promptu wersję QGIS, nazwy warstw, nazwy pól i CRS, i spodziewaj się poprawiania importu czy dwóch.

Wybierz Claude + QGIS MCP, jeśli masz już płatną subskrypcję Claude, dobrze czujesz się z uv i plikami konfiguracyjnymi JSON i chcesz łączyć operacje na plikach lokalnych z wywołaniami QGIS w Claude Desktop lub Claude Code. Nie kosztuje nic ponad twój obecny plan i jest szybki, gdy warstwy danych są już wczytane.

Wybierz agenta w QGIS, gdy chcesz mapy i liczb bez pilnowania tracebacków Pythona, timeoutów Overpass czy zepsutych portów. Analitykowi z terminem na karku albo zespołowi, który potrzebuje spójnej symbolizacji, cytowania źródeł danych i cofania jednym kliknięciem, agent z katalogiem danych wbudowany w QGIS oszczędza najwięcej czasu. Czym różni się architektura, przeczytasz w naszym poradniku o tym, czym jest agent AI w QGIS, a wszystkie aktualne narzędzia znajdziesz w centrum QGIS AI.

Jak to zmierzyliśmy. Wszystkie przebiegi na Pune odbyły się 7 listopada 2026 między 10:29 a 11:03 czasu paryskiego na macOS z QGIS 3.44.15-Solothurn (Qt 5.15.19). Kryteria sukcesu spisałem o 10:14, przed pierwszym promptem. Claude Sonnet 5.5 (claude-sonnet-5-5) był wywoływany przez Claude Code 2.1.306 (claude -p --safe-mode --tools "" --model sonnet) w pustym katalogu, bez serwerów MCP i dostępu do sieci; dwa zwrócone skrypty uruchomiłem w Pythonie QGIS i sprawdziłem niezależnym skryptem liczącym punkty w poligonach. AI Agent 1.9.4 (tryb Balanced, wysiłek Medium) uruchomiłem dwa razy na tym samym zdaniu w czystych projektach. Podczas testów na tym samym Macu działały inne sesje QGIS, więc czasy są dłuższe niż na nieobciążonym komputerze. Dwa przebiegi na drogę i jedno zadanie to mała próbka, a odrzucanie połączeń przez overpass-api.de zaobserwowałem z jednej sieci jednego ranka.

Najczęściej zadawane pytania

Czy istnieje oficjalna wtyczka Claude dla QGIS?

Nie. Anthropic nie publikuje wtyczki dla QGIS. Na 7 listopada 2026 repozytorium wtyczek QGIS ma dziewięć wtyczek społeczności, które łączą Claude z QGIS, albo przez lokalny serwer Model Context Protocol (MCP) (jak QGIS MCP i WAI QGIS MCP), albo przez twój własny klucz API, albo przez lokalne logowanie do Claude Code (Mapsuke). Możesz też zainstalować AI Agent bezpośrednio z menedżera wtyczek QGIS, z wbudowanym modelem AI i katalogiem danych.

Czy Claude Desktop może sterować QGIS za darmo?

Tak, z ograniczeniami. Według dokumentacji planów Anthropic czat w Claude Desktop jest dostępny w planie Free i obsługuje lokalne serwery MCP przez claude_desktop_config.json albo Desktop Extensions (.mcpb). Uruchamianie Claude Code z terminala wymaga płatnego planu Claude Pro, Max lub Ultra.

Czy Claude napisze kod PyQGIS, który działa w QGIS 3.44?

Tak, Claude Sonnet 5.5 pisze dobrze zbudowany kod PyQGIS, ale nie widzi twojej instalacji QGIS i nie może przetestować własnego kodu, więc czasem zmyśla nazwy klas albo polega na zewnętrznych serwerach, które zawodzą. W naszym teście z dwiema próbkami w QGIS 3.44.15 jeden skrypt wysypał się z ImportError na QgsClassificationNaturalBreaks (prawdziwa klasa to QgsClassificationJenks), a drugi nie działał, dopóki nie podmieniliśmy w nim adresu Overpass API.

Jak najprościej używać AI w QGIS bez konfigurowania MCP?

Zainstaluj zintegrowaną wtyczkę z agentem przez Wtyczki > Zarządzanie wtyczkami… (Plugins > Manage and Install Plugins) w QGIS. Z AI Agent nie musisz utrzymywać środowiska Pythona, menedżera pakietów uv ani pliku konfiguracyjnego: logujesz się za darmo, dostajesz 5 zadań miesięcznie (300 w Pro) i wpisujesz polecenie w zadokowanym panelu.

Wypróbuj AI Agent za darmo