Przejdź do treści
AI Agent
QGIS
Poradnik

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.

Dwa rzędy porównują architektury. Górny rząd, QGIS MCP, cztery elementy, które instalujesz, konfigurujesz i uruchamiasz: klient AI, taki jak Claude Desktop, Claude Code lub Cursor, z własnym planem, łączy się przez stdio z serwerem MCP, czyli procesem Pythona uruchamianym przez uv poleceniem uvx qgis-mcp-server, który łączy się przez TCP na porcie 9876 z wtyczką QGIS MCP, serwerem gniazd wewnątrz QGIS, w którym w każdej sesji klikasz Run MCP, a ta steruje twoim projektem QGIS. Dolny rząd, AI Agent, jedna wtyczka: panel AI Agent zadokowany w QGIS, instalowany z menedżera wtyczek, widzi warstwy, pola, układ współrzędnych, zasięg i zaznaczenie, łączy się przez HTTPS z usługą agenta, która uruchamia model w UE bez klucza API i bez aplikacji klienckiej, a ta steruje twoim projektem QGIS.
Góra: cztery elementy, które QGIS MCP musi mieć uruchomione jednocześnie. Dół: wtyczka agenta działająca wewnątrz QGIS, tu nasza.

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:

  1. Klient MCP: aplikacja AI, w której piszesz, na przykład Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI lub Gemini CLI.
  2. 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. uv instalujesz najpierw.
  3. 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.
  4. 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

WymaganiePo coKoszt
QGIS 3.28 lub nowszyMinimum wymagane przez wtyczkęZa darmo
Aplikacja kliencka MCPTu rozmawiasz z modelemPlan darmowy z dziennymi limitami albo płatny
uv (uruchamiacz pakietów Pythona)Uruchamia serwer MCPZa darmo, jedno polecenie w terminalu
Polecenie w terminalu albo wpis w pliku konfiguracjiMówi klientowi, gdzie jest serwerZa darmo, ale ręcznie
Wtyczka QGIS MCPStrona QGIS w tym mościeZa 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.”

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

  2. Zainstaluj uv

    Serwer działa przez uv, którego Windows i macOS nie mają w zestawie. Instalujesz go jednym poleceniem w terminalu.

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

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

  5. Uruchom serwer w QGIS

    Kliknij Run MCP na przycisku wtyczki na pasku narzędzi. Przy starcie QGIS zapisuje w logu „Token authentication disabled (open)”.

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

Po lewej: strona menedżera wtyczek QGIS dla QGIS MCP 0.15.0 autorstwa Nicolasa Karasiaka, 387 głosów i 52 575 pobrań, z opisem mówiącym, że wtyczka to tylko połowa konfiguracji i potrzebny jest też serwer MCP qgis-mcp. Po prawej: okno Setup and Configurator wtyczki z wybranym klientem claude-code, statusem Server running on port 9876 i poleceniem do uruchomienia w terminalu, zaczynającym się od claude mcp add.
Strona wtyczki i jej Configurator. Strona QGIS jest szybka, reszta dzieje się w terminalu i w innej aplikacji.

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 CodeAI Agent
Czas do odpowiedzi9 min 28 s5 min 35 s
Kroki10, w tym 6 to kod w Pythonie40, w tym 2 to kod w Pythonie
Użyte daneOpenStreetMap, 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ły8780 (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.

QGIS po przebiegu QGIS MCP w Lyonie: czerwone punkty to szkoły w promieniu 300 m od przystanku tramwajowego, niebieskie linie to linie tramwajowe, a szare punkty to przystanki tramwajowe, na białym tle bez podkładu. Panel Warstwy zawiera schools_within_300m, tram_lines, tram_stops i ukrytą warstwę schools_all.
QGIS MCP z Claude Code: 9 min 28 s, 87 szkół, każde pobieranie napisane w Pythonie.

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.

QGIS z panelem AI Agent po prawej. Na mapie obrys gminy Lyon, tory tramwajowe i szkoły w promieniu 300 m od przystanku, podpisane nazwami i pokolorowane jako szkoły podstawowe, collèges i lycées. Odpowiedź agenta zawiera kartę ze statystykami: 80 szkół (52 podstawowe, 14 collèges, 14 lycées) i odległości do najbliższego przystanku od 14,6 do 297,2 m, a potem jego źródła: szkoły Métropole de Lyon, przystanki i tory tramwajowe z OpenStreetMap, granica Lyonu i wycinek GTFS.
AI Agent: 5 min 35 s, 80 szkół, z własnych warstw szkół miasta.

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:

ZadanieQGIS MCP z Claude CodeAI Agent
Budynki starego miasta w Porto według typu, na podkładzie satelitarnym1 min 44 s1 min 21 s
To samo, plus układ wydruku PDF w A4 z tytułem, legendą, skalą i strzałką północy2 min 48 s5 min 26 s
Budynki w York zagrożone powodzią rzeczną, z danych Environment AgencyNiedokończone po 15 min, nic na mapieNiedokoń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 refused i ModuleNotFoundError jako 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_code uruchamia 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ę. Bez uv, 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 MCPAI Agent
Gdzie rozmawiaszW zewnętrznej aplikacji (Claude Desktop, Cursor, Claude Code)W panelu wewnątrz QGIS
Co instalujeszWtyczkę, uv, klienta MCP, wpis w konfiguracjiJedną wtyczkę
Każda sesjaUruchom serwer w QGIS, trzymaj otwarte obie aplikacjeOtwórz panel
ModelTen, którego używa twój klient, w twoim planieW zestawie
Katalog otwartych danychNie190 źródeł
Uruchamia PythonaTak, domyślnie bez pytaniaPyta przed kodem zmieniającym projekt
Cofnięcie całej prośbyNieTak, jednym kliknięciem
CenaDarmowa wtyczka plus twój plan AIPlan Free, potem Pro za 49 € miesięcznie
Najlepszy dlaDeweloperów pracujących już w Claude Code lub CursorUż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

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.

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.

Wypróbuj AI Agent za darmo
Napisane przezYvann Barbot
·17 min read

Czytaj dalej