Czym jest QGIS MCP? Instalacja, limity i alternatywa
Opublikowano Zaktualizowano
QGIS MCP to darmowa wtyczka QGIS wraz z niewielkim programem na twoim komputerze, dzięki którym aplikacja AI spoza QGIS, zwykle Claude Desktop lub Claude Code, steruje QGIS. Piszesz w aplikacji AI, ona wysyła polecenia do QGIS przez lokalne połączenie, a QGIS je wykonuje: wczytuje warstwy, uruchamia algorytmy przetwarzania, stylizuje mapę albo uruchamia kod w Pythonie.

Pomysł jest dobry, a wtyczka dobrze zrobiona. Wersję z oficjalnego repozytorium QGIS prowadzi Nicolas Karasiak, a 26 września 2026 miała ona 52 575 pobrań. Poradniki pomijają to, ile trzeba zrobić, żeby ją uruchomić, i gdzie się kończą jej możliwości. Skonfigurowałem ją od zera, a potem dałem to samo zadanie jej i agentowi działającemu wewnątrz QGIS. Ten drugi, AI Agent, tworzymy my, więc czytaj moje wnioski z tą wiedzą.
Czym jest MCP, w jednym akapicie
MCP, czyli Model Context Protocol, to otwarty standard zapoczątkowany przez Anthropic, który pozwala aplikacjom AI korzystać z zewnętrznych narzędzi. Oficjalne wprowadzenie nazywa go „portem USB-C dla aplikacji AI”. Aplikacja AI to klient. Serwer udostępnia mu narzędzia. QGIS MCP to serwer, którego narzędzia są działaniami w QGIS. Protokół wprost nazywa ryzyko: „Narzędzia oznaczają wykonywanie dowolnego kodu i trzeba je traktować z odpowiednią ostrożnością.”
Jak działa QGIS MCP
Cztery elementy muszą być zainstalowane i uruchomione w tym samym czasie:
- Klient MCP: aplikacja AI, w której piszesz, na przykład Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI lub Gemini CLI.
- Serwer MCP: mały program w Pythonie, który klient uruchamia w tle przez
uv, narzędzie instalujące i uruchamiające programy w Pythonie.uvinstalujesz najpierw. - Wtyczka QGIS MCP: wewnątrz QGIS nasłuchuje poleceń na lokalnym porcie sieciowym o numerze 9876. Uruchamiasz ją przyciskiem Run MCP na jej pasku narzędzi.
- Sam QGIS z otwartym projektem.
Gdy wpisujesz prośbę, model AI wybiera narzędzie QGIS, serwer przekazuje wywołanie do wtyczki, a wtyczka wykonuje je w QGIS i odsyła wynik. Model nie widzi twojego ekranu. Mapę widzi dopiero wtedy, gdy poprosi QGIS o jej obraz.
Czego potrzebujesz na start
| Wymaganie | Po co | Koszt |
|---|---|---|
| QGIS 3.28 lub nowszy | Minimum wymagane przez wtyczkę | Za darmo |
| Aplikacja kliencka MCP | Tu rozmawiasz z modelem | Plan darmowy z dziennymi limitami albo płatny |
uv (uruchamiacz pakietów Pythona) | Uruchamia serwer MCP | Za darmo, jedno polecenie w terminalu |
| Polecenie w terminalu albo wpis w pliku konfiguracji | Mówi klientowi, gdzie jest serwer | Za darmo, ale ręcznie |
| Wtyczka QGIS MCP | Strona QGIS w tym moście | Za darmo |
Jeden z popularnych poradników twierdzi, że potrzebujesz płatnego konta Claude Pro. Nie potrzebujesz. Dokumentacja Anthropic dla lokalnych serwerów MCP nie wymienia żadnego planu, a pewien bloger GIS uruchomił QGIS MCP w darmowym planie Claude w sierpniu 2026, napotykając tylko dzienny limit wiadomości. Z ChatGPT jest trudniej. Centrum pomocy OpenAI mówi, że łączy się on tylko z serwerami MCP w internecie, nie z serwerem na twoim komputerze, a wymagany tryb deweloperski jest dostępny w planach płatnych.
Instalacja QGIS MCP z pomiarem czasu
Zainstalowałem QGIS MCP 0.15.0 w QGIS 3.44 dnia 26 września 2026 i zapisywałem każdy krok. Strona wtyczki mówi o tym otwarcie: „Ta wtyczka to tylko połowa konfiguracji. Potrzebujesz też serwera MCP qgis-mcp, który twój klient MCP uruchamia, aby rozmawiać z QGIS.”
Zainstaluj wtyczkę
Wtyczki > Zarządzanie wtyczkami… (Plugins > Manage and Install Plugins…), wyszukaj QGIS MCP, kliknij Zainstaluj wtyczkę. Ta część jest szybka: wtyczka wczytała się w 2,7 s, bez ponownego uruchamiania.Zainstaluj uv
Serwer działa przez
uv, którego Windows i macOS nie mają w zestawie. Instalujesz go jednym poleceniem w terminalu.Zdobądź klienta MCP
Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI albo inna aplikacja obsługująca MCP, z własnym kontem i planem.
Połącz klienta z QGIS
Configurator we wtyczce pokazuje polecenie do wklejenia w terminalu, na przykład
claude mcp add -s user qgis -- uvx ... qgis-mcp-server. Niektórzy klienci wymagają zamiast tego dopisania linii w pliku ustawień.Uruchom serwer w QGIS
Kliknij Run MCP na przycisku wtyczki na pasku narzędzi. Przy starcie QGIS zapisuje w logu „Token authentication disabled (open)”.
Wyślij pierwszą wiadomość
Pierwsze wywołanie pobiera serwer, około 90 MB, a potem się łączy. W moim teście zajęło to 16 s, a klient zobaczył 125 narzędzi QGIS.
Configurator na zrzucie poniżej to miejsce, w którym wybierasz klienta i kopiujesz polecenie do terminala.

Mój test trwał około trzech minut, ale uv i klient były już zainstalowane, a klikał skrypt. Za pierwszym razem człowiek czyta jeszcze dokumentację, instaluje uv i klienta oraz wpisuje polecenie.
Część tej pracy wraca codziennie. Po ponownym uruchomieniu QGIS serwer pozostaje wyłączony, o ile w Configuratorze nie zaznaczysz autostartu. Aplikacja AI mówi wtedy tylko „Error executing tool ping”, a ty musisz się domyślić, że trzeba znowu kliknąć Run MCP.
To samo zadanie, dwa sposoby
Obu narzędziom dałem tę samą prośbę, w tym samym czasie na tym samym komputerze, każdemu w świeżym projekcie QGIS: „W Lyonie we Francji znajdź szkoły w promieniu 300 metrów od przystanku tramwajowego, pokaż je na mapie razem z liniami tramwajowymi i powiedz mi, ile ich jest.”
| QGIS MCP z Claude Code | AI Agent | |
|---|---|---|
| Czas do odpowiedzi | 9 min 28 s | 5 min 35 s |
| Kroki | 10, w tym 6 to kod w Pythonie | 40, w tym 2 to kod w Pythonie |
| Użyte dane | OpenStreetMap, pobrane kodem w Pythonie, który sam napisał | Oficjalne warstwy szkół podstawowych, collèges i lycées Métropole de Lyon oraz przystanki i tory tramwajowe z OpenStreetMap |
| Policzone szkoły | 87 | 80 (52 podstawowe, 14 collèges, 14 lycées) |
Liczby się różnią, bo narzędzia użyły innych danych. QGIS MCP policzył szkoły z OpenStreetMap w pobliżu przystanków tramwajowych wybranych w prostokącie wokół Lyonu, więc liczą się też przystanki tuż za granicą miasta, a sam napisał, że 87 nie jest oczyszczone z duplikatów. AI Agent użył oficjalnych rejestrów szkół miasta i granicy gminy Lyon.
Większą różnicą jest to, jak do nich doszły. QGIS MCP nie ma narzędzia do danych, więc model napisał kod w Pythonie, który odpytywał serwery Overpass z OpenStreetMap. Odpowiadały błędami (406, 504, a potem dwa razy 502), a on ponawiał próby. Ten kod działał w głównym wątku QGIS, więc QGIS był zawieszony przez około siedem minut, a mapa pozostała pusta do 7 min 22 s.

AI Agent najpierw przeszukał swój katalog danych i wczytał oficjalne warstwy szkół miasta. Gdy krajowy zbiór danych transportu nie opisywał tramwajów w Lyonie, przeszedł na OpenStreetMap po przystanki i tory tramwajowe. Dwa razy napisał kod w Pythonie, żeby zmierzyć odległość od każdej szkoły do najbliższego przystanku.

Trzy kolejne zadania, w jednym z nich QGIS MCP był szybszy
Jeden wyścig niewiele dowodzi, więc zmierzyłem czas trzech kolejnych zadań tak samo. Nie wszystkie kończą się po naszej myśli:
| Zadanie | QGIS MCP z Claude Code | AI Agent |
|---|---|---|
| Budynki starego miasta w Porto według typu, na podkładzie satelitarnym | 1 min 44 s | 1 min 21 s |
| To samo, plus układ wydruku PDF w A4 z tytułem, legendą, skalą i strzałką północy | 2 min 48 s | 5 min 26 s |
| Budynki w York zagrożone powodzią rzeczną, z danych Environment Agency | Niedokończone po 15 min, nic na mapie | Niedokończone po 15 min, część danych o powodzi wczytana, bez liczby |
Gdy dane są o jedno pobranie z OpenStreetMap, QGIS MCP dotrzymuje kroku, a przy układzie PDF był około dwa razy szybszy. Jego własna odpowiedź ostrzegała, że wyeksportował PDF bez sprawdzenia, czy kafelki satelitarne się wczytały. Przepaść otwiera się, gdy model sam musi znaleźć i pobrać dane, jak w Lyonie. Żadne narzędzie nie skończyło zadania z powodzią w York w 15 minut. Pierwszy przebieg w Porto 26 września zajął QGIS MCP 8 min 29 s, bo serwery pobierania były tego dnia przeciążone, więc zmierzyłem wszystko jeszcze raz.
Jak to zmierzyliśmy. Ten sam komputer, oba narzędzia działały jednocześnie, QGIS 3.44.15, świeży projekt i ustawienia domyślne, poza poziomem effort w AI Agent, ustawionym na Medium. Jeden przebieg każdego, bez powtórek: QGIS MCP 0.15.2 sterowany przez Claude Code na Claude Sonnet 5.5, z dozwolonymi tylko narzędziami QGIS, oraz AI Agent 1.9.0 w trybie Balanced. Czas QGIS MCP to czas pracy samego Claude Code, który pomija 52 sekundy potrzebne klientowi na start. Komputer był mocno obciążony, a serwery OpenStreetMap zawodziły przy obu narzędziach w wyścigu w Lyonie. Nagraliśmy każdy przebieg.
Tę samą prośbę możesz wysłać w swoim QGIS w kilka minut: zainstaluj wtyczkę, zaloguj się i wklej ją do panelu.
Gdzie QGIS MCP zawodzi
Oto ograniczenia, na które trafiłem albo które są udokumentowane, każde ze źródłem:
- Czat jest poza QGIS. Przełączasz się między dwoma oknami. Model pracuje na wynikach narzędzi i widzi mapę dopiero wtedy, gdy poprosi QGIS o jej obraz.
- Cztery ruchome części. Gdy nic się nie dzieje, usterka może tkwić w ustawieniach klienta, w
uv, serwerze, porcie albo wtyczce. Strona rozwiązywania problemów projektu wymienia „No response from QGIS”,Connection refusediModuleNotFoundErrorjako typowe błędy. - Pułapka w Windows. README ostrzega, że Claude Desktop zainstalowany z Microsoft Store uruchamia serwery w piaskownicy, która psuje zwykłą konfigurację, więc ustawienia działające gdzie indziej tam zawodzą.
- Dowolny kod Pythona, domyślnie bez hasła. Narzędzie
execute_codeuruchamia dowolny kod PyQGIS (kod Pythona dla QGIS), który napisze model. README mówi to wprost: „Domyślnie gniazdo nie ma uwierzytelniania... każdy proces na maszynie, który sięgnie do portu, może sterować QGIS (w tym execute_code, które uruchamia dowolny kod PyQGIS).” Jeden fork, QGIS Agent MCP, powstał głównie po to, żeby usunąć to narzędzie. - Brak własnych danych. Steruje QGIS, ale znalezienie i pobranie danych zostaje po stronie modelu, zwykle przez napisanie kodu w Pythonie. W teście z Lyonu 6 z jego 10 kroków to był Python, a pobieranie zamroziło QGIS na około siedem minut.
- Brak cofnięcia całej prośby. Cofnij w QGIS obejmuje edycje, nie dodane warstwy ani zapisane pliki.
- Najczęściej oznaczana gwiazdką kopia nie jest utrzymywana. Oryginał na GitHubie, jjsantos01/qgis_mcp, ma 1099 gwiazdek, żadnej zmiany w kodzie od 1 października 2025 i otwarty problem zatytułowany „Broken plugin for QGIS version 4.01”. Utrzymywana wersja, nkarasiak/qgis-mcp, to ta z repozytorium wtyczek QGIS.
Gdzie internet się myli
„Potrzebujesz Claude Pro.” Lokalne serwery MCP działają w darmowym planie Claude, w granicach jego dziennych limitów. Bramka płatnego planu jest w ChatGPT, który i tak nie sięga bezpośrednio do serwera na twoim komputerze.
„Po edycji konfiguracji uruchom komputer ponownie.” Wystarczy ponownie uruchomić aplikację kliencką. W Windows upewnij się, że została całkiem zamknięta, bo działa dalej w zasobniku systemowym.
„Zainstaluj repozytorium z największą liczbą gwiazdek.” Zainstaluj lepiej z menedżera wtyczek QGIS, który da ci wersję utrzymywaną.
Inne sposoby połączenia Claude z QGIS
Wtyczka opisana wyżej to ta, o której mówi większość poradników, ale Claude w QGIS umieszczają też trzy inne projekty. Odczytane na ich własnych stronach 23 października 2026:
- piatkowski/qgis-mcp: osobny projekt o tej samej nazwie, zbudowany dla Claude Desktop. Instaluje się z pliku ZIP ze strony wydań na GitHubie, a nie z menedżera wtyczek, jego serwer wymaga Pythona 3.12 lub nowszego i zaczyna nasłuchiwać na porcie 9876, gdy tylko włączysz wtyczkę. Wtyczka opisana wyżej też używa portu 9876, więc uruchamiaj jedną naraz.
- ClaudIA QGIS: pochodna wtyczki opisanej wyżej, z lokalnym portem zastąpionym połączeniem ze społecznością agrônomo10X przez HTTPS, więc nie ma Pythona do instalacji. Wymaga konta agrônomo10X, a jej wydanie 0.2.3 z 15 września 2026 jest oznaczone jako eksperymentalne.
- QGIS Agent: panel czatu wewnątrz QGIS z twoim własnym kluczem LLM i opcjonalnym lokalnym serwerem MCP, którym może sterować Claude Desktop albo Cursor.
Alternatywa dla QGIS MCP: agent wewnątrz QGIS
Tworzymy AI Agent, więc ta sekcja dotyczy naszej własnej wtyczki. Wykonuje tę samą pracę co QGIS MCP, ale z wnętrza QGIS: czat to panel zadokowany obok mapy, a model jest dołączony do wtyczki. W benchmarkach Google GeoKTools i GeoExpertQueries Claude Sonnet 5.5 sterujący QGIS przez tę wtyczkę MCP (wersja 0.15.1, w Claude Code) uzyskał 24,9 na 100 w 41 pytaniach zachowanych do testu, a AI Agent na poziomie effort Low (GPT-6 Luna) 43,8 (wyniki benchmarku).
Różnice, które liczą się na co dzień:
- Jedna instalacja.
Wtyczki > Zarządzanie wtyczkami…, wyszukaj AI Agent by TerraLab, zainstaluj, zaloguj się. Bezuv, bez pliku konfiguracji, bez osobnej aplikacji, bez serwera do uruchamiania w każdej sesji. - Widzi twój projekt. Nazwy warstw, pola, układ współrzędnych, zasięg i zaznaczenie trafiają z każdą prośbą, a agent renderuje mapę, żeby sprawdzić własną pracę.
- Dane w zestawie. Katalog 190 otwartych źródeł danych, od OpenStreetMap przez Sentinel-2 po krajowe agencje kartograficzne, więc model nie pisze kodu do pobierania.
- Pyta najpierw. W ustawieniu domyślnym zatrzymuje się przed usunięciem lub nadpisaniem, a kod w Pythonie zmieniający projekt zawsze wymaga twojego kliknięcia.
- Cofnięcie dla każdej wiadomości. Każda wiadomość zostawia punkt przywracania, a jedno kliknięcie cofa projekt do niego.
Potrzebuje połączenia z internetem i wysyła opis twojego projektu, nigdy twoje pliki z danymi, do usługi hostowanej w UE. Jest plan Free, bez karty, a jedna wiadomość liczy się jako jedno zadanie, niezależnie od liczby kroków. Wypróbuj Pro za darmo przez 7 dni: podaj kartę, anuluj przed końcem, a nic nie zostanie pobrane.
Wypróbuj AI Agent w QGIS za darmo, bez karty
QGIS MCP a agent wewnątrz QGIS, obok siebie
| QGIS MCP | AI Agent | |
|---|---|---|
| Gdzie rozmawiasz | W zewnętrznej aplikacji (Claude Desktop, Cursor, Claude Code) | W panelu wewnątrz QGIS |
| Co instalujesz | Wtyczkę, uv, klienta MCP, wpis w konfiguracji | Jedną wtyczkę |
| Każda sesja | Uruchom serwer w QGIS, trzymaj otwarte obie aplikacje | Otwórz panel |
| Model | Ten, którego używa twój klient, w twoim planie | W zestawie |
| Katalog otwartych danych | Nie | 190 źródeł |
| Uruchamia Pythona | Tak, domyślnie bez pytania | Pyta przed kodem zmieniającym projekt |
| Cofnięcie całej prośby | Nie | Tak, jednym kliknięciem |
| Cena | Darmowa wtyczka plus twój plan AI | Plan Free, potem Pro za 49 € miesięcznie |
| Najlepszy dla | Deweloperów pracujących już w Claude Code lub Cursor | Użytkowników GIS, którzy chcą wyniku w QGIS |
Z którego korzystać?
Jeśli już pracujesz w Claude Code lub Cursor, piszesz w Pythonie i chcesz mieć QGIS jako jeszcze jedno narzędzie w tym środowisku, QGIS MCP jest dobrym wyborem i nie kosztuje nic ponad plan AI, który już opłacasz. Jeśli chcesz wpisać zadanie GIS i dostać wynik w swoim projekcie, bez terminala, uv ani drugiej aplikacji, agent wewnątrz QGIS zaprowadzi cię tam przy mniejszej konfiguracji i utrzymaniu. Ten drugi przypadek dotyczy większości użytkowników GIS, których znam.
Co warto zapamiętać
QGIS MCP łączy aplikację AI spoza QGIS, taką jak Claude Desktop, z QGIS przez lokalne połączenie, dzięki czemu model tej aplikacji może uruchamiać narzędzia QGIS i kod w Pythonie.
Potrzebuje czterech elementów działających razem: aplikacji klienckiej, uv z serwerem MCP, wtyczki QGIS MCP z uruchomionym serwerem oraz QGIS.
Strona QGIS instaluje się w kilka sekund. Reszta dzieje się poza QGIS: instalacja uv, aplikacji AI, polecenie w terminalu i ponowne klikanie Run MCP po każdym restarcie.
W zadaniu z Lyonu AI Agent odpowiedział w 5 min 35 s, korzystając z oficjalnych warstw szkół miasta. QGIS MCP zajęło 9 min 28 s i napisało kod w Pythonie dla 6 z 10 kroków. Przy prostszych zadaniach różnica się zmniejsza, a przy układzie PDF QGIS MCP był szybszy.
ChatGPT nie potrafi bezpośrednio użyć lokalnego serwera MCP. Darmowy plan Claude działa, w granicach dziennych limitów.
Agent wewnątrz QGIS, taki jak AI Agent, wykonuje tę samą pracę z jednej wtyczki, z modelem, katalogiem danych i cofnięciem jednym kliknięciem w zestawie.
Najczęstsze pytania
Wtyczka QGIS i lokalny serwer MCP, dzięki którym aplikacja AI steruje QGIS przez Model Context Protocol. Rozmawiasz w aplikacji, zwykle Claude Desktop lub Claude Code, a model wywołuje narzędzia QGIS: wczytuje warstwy, uruchamia algorytmy przetwarzania, stylizuje, renderuje mapę i uruchamia kod w Pythonie.
Zainstaluj wtyczkę QGIS MCP z menedżera wtyczek i kliknij Run MCP, zainstaluj uv, a potem dodaj serwer QGIS MCP do pliku konfiguracji Claude Desktop albo uruchom polecenie claude mcp add w Claude Code i uruchom klienta ponownie. Możesz też zainstalować wtyczkę agenta działającą wewnątrz QGIS z własnym modelem, taką jak AI Agent, która pomija klienta, uv i konfigurację.
Nie bezpośrednio. Centrum pomocy OpenAI mówi, że ChatGPT łączy się z serwerami MCP w internecie, więc serwer na twoim komputerze, taki jak QGIS MCP, potrzebowałby tunelu, żeby był osiągalny. Tryb deweloperski, którego wymaga MCP, jest ograniczony do płatnych planów ChatGPT.
Może uruchamiać w QGIS dowolny kod Pythona napisany przez model, a domyślnie lokalne gniazdo nie ma uwierzytelniania, co potwierdza jego README. Używaj go na zaufanym komputerze, ustaw token ze wspólnym sekretem, jeśli komputer dzielą inni, zatrzymuj serwer po pracy i rób kopie zapasowe ważnych projektów.
Zwykłe przyczyny, według przewodnika rozwiązywania problemów projektu: serwer nie jest uruchomiony w QGIS (Connection refused, kliknij Run MCP), uv nie jest zainstalowany albo nie można go znaleźć (ModuleNotFoundError) lub port nie jest równy 9876. Po ponownym uruchomieniu QGIS serwer jest znowu wyłączony, o ile nie zaznaczono autostartu. W Windows instalacja Claude Desktop z Microsoft Store wymaga zapisu konfiguracji z --directory.
Tak. Wtyczki agentów działają wewnątrz QGIS jako panel czatu, bez zewnętrznej aplikacji i lokalnego serwera. We wrześniu 2026 naliczyliśmy w oficjalnym repozytorium 38 wtyczek agentów i asystentów. Nasz AI Agent ma w zestawie model, 190 otwartych źródeł danych i cofnięcie jednym kliknięciem, w planie Free.
Czym jest agent AI w QGIS zlicza wszystkie 38 wtyczek agentów i asystentów w oficjalnym repozytorium, łącznie z mostami MCP. Poradnik AI Agent pokazuje dziesięć prawdziwych uruchomień z ich promptami, a PyQGIS mierzy, jak często kod napisany przez chatbota działa za pierwszym razem. Centrum QGIS AI porównuje szersze pole.
Czytaj dalejClaude w QGIS: 3 sposoby połączenia, przetestowane na jednym zadaniu
Zrób to w QGIS, po prostu o to prosząc
AI Agent wykonuje zadanie, które opiszesz, w Twoim własnym projekcie QGIS. Za darmo, bez karty.


