Czym jest QGIS MCP? Instalacja, limity i alternatywa

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:

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

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

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 świeżym projekcie QGIS: „Wczytaj budynki ze starego miasta w Porto w Portugalii z OpenStreetMap, pokoloruj je według typu budynku, dodaj pod spodem podkład satelitarny i powiedz mi, ile jest budynków.”

Oba wyniki są poprawne dla obszaru, który wybrało każde narzędzie, dlatego się różnią. Różni się to, jak do nich doszły. QGIS MCP nie ma narzędzia do danych, więc model napisał kod w Pythonie, który pobrał dane z OpenStreetMap. Gdy serwery pobierania działały wolno, jego ponowne próby zamrażały QGIS nawet na minutę. Na jego korzyść: sam wyłapał własny błąd, który gubił 37 budynków, i go naprawił.

AI Agent użył wbudowanego narzędzia OpenStreetMap, znalazł prawdziwą granicę starego miasta, przyciął do niej budynki i nadał im styl, nie pisząc żadnego kodu. Jego podkład satelitarny jest przy tym powiększeniu bardziej rozmyty niż ten, który wybrał QGIS MCP.

Jak to zmierzyliśmy. Ten sam komputer, QGIS 3.44.7, ta sama prośba, świeży projekt i ustawienia domyślne, QGIS MCP 0.15.0 sterowany przez Claude Code na Claude Sonnet oraz AI Agent 1.4.1. Oba wyniki sprawdziliśmy sami: dla prostokąta z OpenStreetMap, a dla granicy przez policzenie obiektów w końcowej warstwie. W czasie testu QGIS MCP serwery pobierania były przeciążone, co kosztowało go czas, a pierwsza próba AI Agent zawiesiła QGIS (to błąd, który zapisaliśmy), więc jego wyniki pochodzą z powtórzenia.

Tę samą prośbę możesz wysłać w swoim QGIS w kilka minut: zainstaluj wtyczkę, zaloguj się i wklej ją do panelu.

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

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 moim teście 17 z jego 28 działań to były skrypty w Pythonie, a ponowne próby pobierania zamrażały QGIS na 40 do 62 s naraz.
• 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ą.

Prostsza opcja: 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.

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 55 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 AI Agent w QGIS za darmo, bez karty

QGIS MCP a agent wewnątrz QGIS, obok siebie

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 tym samym zadaniu z Porto AI Agent odpowiedział w 1 min 11 s, wykonując 15 działań i nie pisząc kodu. QGIS MCP zajęło 8 min 29 s i napisało kod w Pythonie dla 17 ze swoich 28 działań.

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

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.

Jak połączyć Claude z QGIS?

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

Czy ChatGPT może używać QGIS MCP?

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.

Czy QGIS MCP jest bezpieczny?

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.

Dlaczego QGIS MCP się nie łączy?

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.

Czy jest alternatywa dla QGIS MCP?

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