Lewati ke konten
AI Agent
QGIS
Panduan

Claude untuk QGIS: 3 Cara Menghubungkannya, Diuji pada Satu Tugas

Diterbitkan

Tidak ada plugin resmi Anthropic untuk QGIS. Ada tiga cara utama memakai Claude dengan QGIS: menghubungkan Claude Desktop atau Claude Code lewat server MCP QGIS, meminta Claude menulis kode PyQGIS yang Anda tempel ke Python console, atau memasang plugin agen di dalam QGIS.

Pada 7 November 2026, saya menguji bagaimana Claude menangani tugas nyata: memuat distrik dan sekolah OpenStreetMap di Pune, India, menghitung sekolah per poligon, dan memberi gaya choropleth. Tidak satu pun dari dua skrip PyQGIS yang ditulis Claude Sonnet 5.5 berjalan saat langsung ditempel, meski satu berhasil dalam 44 sampai 48 detik setelah saya mengganti URL server datanya. Agen di dalam QGIS menyelesaikan prompt yang sama dalam 45 sampai 63 detik pada dua uji berturut-turut.

Jendela QGIS yang menampilkan peta choropleth sekolah per ward di Pune dalam nuansa biru, layer tree di kiri, dan panel chat AI Agent di kanan yang menampilkan prompt, pilihan Pune city wards, dan jumlah akhir 256 sekolah di 58 ward pemilihan.
Choropleth sekolah Pune yang dibuat dari satu kalimat di QGIS: 256 sekolah OpenStreetMap dihitung di 58 ward pemilihan dalam 63 detik.

Apa saja cara memakai Claude dengan QGIS?

Menghubungkan Claude ke QGIS berarti memberi model Anthropic itu jembatan agar ia bisa menjalankan alat di dalam proyek yang sedang Anda buka, atau menyalin skrip PyQGIS bolak-balik antara jendela chat dan Python console QGIS. Cara ketiga melewati jembatan itu dan memasang panel agen AI langsung di dalam QGIS.

Kebanyakan tutorial hanya menunjukkan jembatan Model Context Protocol (MCP). Sebelum Anda memasang alat command line tambahan atau mengedit file konfigurasi, ada baiknya melihat apa yang dibutuhkan ketiga cara ini dan apa yang terjadi ketika mereka diberi pekerjaan yang sama.

Cara 1: Claude + QGIS MCPCara 2: Claude menulis PyQGISCara 3: Agen di dalam QGIS
Langkah setup5 langkah (pasang plugin, uv, klien, konfigurasi, klik Run MCP tiap sesi)0 langkah setup (3 klik per tugas untuk membuka editor, menempel, dan menjalankan)3 langkah (pasang dari plugin manager QGIS, buka panel, masuk)
Yang Anda butuhkanClaude Desktop (Free atau berbayar) atau Claude Code (paket berbayar), plus uv dan server lokalChat Claude apa pun, tanpa software tambahanQGIS 3.28+ dan akun gratis (tanpa kunci API atau kartu)
Siapa yang menjalankan kodeClaude memicu alat lewat port MCP lokalAnda menempel dan menjalankan skrip di Python consolePlugin menjalankan alat QGIS dan mengecek petanya sendiri
Melihat proyek Anda?Ya, saat server MCP berjalanTidak, kecuali Anda mengetik nama layer dan CRS di promptYa, membaca layer yang terbuka, field, dan extent peta
UndoBersihkan manual di QGISBersihkan manual di QGISTombol Undo changes sekali klik di setiap jawaban
Hasil tugas PuneTidak dijalankan di Pune (9 mnt 28 dtk pada tugas sekolah serupa di Lyon)0 dari 2 skrip berjalan saat ditempel; 1 berhasil dalam 44 sampai 48 dtk setelah URL diedit (447 sekolah di 14 taluka)2 dari 2 uji lulus dalam 63 dtk dan ~45 dtk (256 sekolah di 58 ward kota)

Kalau Anda ingin mengerjakan tugas ini secara manual tanpa AI, cara QGIS gratisnya butuh empat langkah: unduh batas wilayah dan titik amenity=school dengan Vector > QuickOSM > QuickOSM..., jalankan Vector > Analysis Tools > Count Points in Polygon... (native:countpointsinpolygon), lalu atur Layer Properties > Symbology ke Graduated pada field jumlah yang baru.

Apakah ada plugin Claude di repositori QGIS?

Tidak ada plugin resmi dari Anthropic di repositori plugin QGIS. Ketika saya mengecek indeks repositori pada 7 November 2026 (4.399 plugin untuk QGIS 3.44 dan 1.697 untuk QGIS 4.0), 45 plugin memuat kata "claude" di metadatanya, tetapi 36 di antaranya hanya menyebut Claude sebagai asisten coding atau punya penulis bernama Claude.

Hanya sembilan plugin komunitas yang benar-benar menghubungkan model atau langganan Claude ke QGIS:

  • QGIS MCP (oleh Nicolas Karasiak, v0.15.2, 77.002 unduhan per 7 November 2026): membuka port lokal agar Claude Desktop, Claude Code, atau Cursor bisa menjalankan 125 alat di dalam QGIS.
  • WAI QGIS MCP (v0.3.0, 753 unduhan): terhubung ke Claude Desktop lewat satu file ekstensi .mcpb sehingga Anda tidak perlu memasang Node.js sendiri.
  • QGIS Agent (oleh bunkmr, v2.4.15, 3.783 unduhan), QGIS Agent Mcp (v0.5.0, 3.210 unduhan), QGIS Salah MCP (v1.1.1, 2.037 unduhan), dan ClaudIA QGIS (v0.4.6, 784 unduhan): server socket MCP atau panel lain yang memakai kunci API Anda sendiri.
  • LandTalk.AI (v1.5.0, 5.927 unduhan) dan AI Copilot (v1.8.0, 2.098 unduhan): panel chat multi-model yang menerima kunci Claude, OpenAI, atau Gemini.
  • Mapsuke (oleh MIERUNE, v1.6.0, 1.242 unduhan, diperbarui 30 Oktober 2026): panel chat di dalam QGIS 3.44+ yang berjalan dengan login Claude Code atau Codex Anda tanpa server MCP, asalkan Claude Code CLI sudah terpasang.

Paket Claude yang Anda butuhkan bergantung pada cara Anda menghubungkannya. Menurut halaman perbandingan paket Anthropic (dibaca 7 November 2026), chat Claude Desktop tersedia di paket Free serta Pro, Max, Ultra, Team, dan Enterprise, dan Anda bisa memasang server MCP lokal lewat Settings > Developer > Edit Config atau lewat Desktop Extensions. Claude Code, alat command line yang diandalkan plugin seperti Mapsuke dan alur kerja CLI, tidak termasuk dalam paket Free dan membutuhkan langganan Pro, Max, atau Ultra.

Pengujiannya: memetakan sekolah per distrik di Pune

Setiap tutorial yang saya baca untuk peta celah SERP menguji Claude dengan file yang sudah ada di disk penulisnya. Dalam pekerjaan GIS nyata, Anda sering meminta alat mengambil data terbuka untuk kota yang belum pernah ia lihat.

Saya menulis kriteria keberhasilan sebelum menjalankan apa pun pada 7 November 2026. Prompt-nya satu kalimat:

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

Saya sengaja memilih Pune karena "districts of Pune" ambigu. Pune adalah distrik di Maharashtra yang terbagi menjadi 14 subdistrik (taluka atau tehsil), sedangkan kota Pune terbagi menjadi 15 kantor ward administratif dan 58 ward pemilihan. Alur kerja yang baik akan menanyakan batas wilayah mana yang Anda maksud atau menyebutkan dengan jelas batas mana yang dimuat.

Cara 2: Meminta kode PyQGIS dari Claude untuk ditempel

Untuk cara salin-tempel, saya menjalankan Claude Sonnet 5.5 (claude-sonnet-5-5 lewat Claude Code 2.1.306 dengan semua alat dan akses web dimatikan, setara jendela chat biasa) dua kali dengan prompt yang persis sama, hanya ditambah "I use QGIS. Write the PyQGIS code I can paste in the QGIS Python console for this task". Kalau Anda belum pernah memakai console ini, panduan PyQGIS kami menjelaskan cara skrip dijalankan di sana.

Claude butuh 77 detik untuk menghasilkan skrip pertama sepanjang 134 baris dan 67 detik untuk skrip kedua sepanjang 108 baris. Kedua jawaban mencatat bahwa "districts" ambigu, memilih admin_level=6 (14 taluka di distrik Pune), dan menjelaskan cara mengganti level-nya di kode. Jawaban kedua bahkan menambahkan peringatan yang adil di bagian bawah: "Saya belum menjalankannya, jadi percobaan pertama adalah ujiannya."

Tidak satu pun skrip berjalan saat langsung ditempel di QGIS 3.44.15:

  1. Jawaban 1 gagal setelah 1 detik dengan URLError: <urlopen error [Errno 61] Connection refused>. Skrip memanggil server Overpass publik utama (overpass-api.de), yang pagi itu menolak koneksi dari IP kami.
  2. Jawaban 2 gagal di baris 3 sebelum melakukan panggilan jaringan apa pun. Skrip memunculkan ImportError: cannot import name 'QgsClassificationNaturalBreaks' from 'qgis.core'.
Python Console QGIS yang menampilkan Traceback merah dengan ImportError: cannot import name QgsClassificationNaturalBreaks from qgis.core di baris 3 skrip yang ditempel.
Skrip PyQGIS kedua dari Claude berhenti di baris 3: QgsClassificationNaturalBreaks tidak ada di QGIS 3.44.15 (kelas yang benar adalah QgsClassificationJenks).

Di QGIS 3.44, kelas natural breaks bernama QgsClassificationJenks, bukan QgsClassificationNaturalBreaks. Karena chatbot tanpa alat tidak bisa menguji import-nya sendiri terhadap versi QGIS Anda, satu nama kelas karangan menghentikan seluruh skrip. Kami melihat pola tebak-buta yang persis sama ketika menguji ChatGPT untuk QGIS pada tiga tugas di Annecy.

Untuk melihat apakah skrip pertama Claude selebihnya sudah benar, saya mengubah satu konstanta di Jawaban 1, mengganti overpass-api.de dengan mirror Prancis overpass.openstreetmap.fr, lalu menjalankannya tiga kali pada layer tree yang bersih. Dengan server yang berfungsi, skrip selesai dalam 48, 44, dan 45 detik.

Peta 14 taluka di distrik Pune dengan gaya gradasi merah dan titik sekolah hitam di atasnya, dibuat oleh skrip PyQGIS pertama Claude setelah URL server Overpass diganti.
Skrip pertama Claude setelah URL Overpass diganti: 447 sekolah dihitung di 14 taluka Pune, dengan kelas kuantil.

Hitungan di Jawaban 1 benar: skrip memuat 14 poligon taluka dan 447 objek sekolah, dan ketika saya menghitung ulang point-in-polygon secara terpisah, ke-447 sekolah cocok dengan field n_schools tanpa satu pun selisih (246 di Pune City Subdistrict, 75 di Haveli, 55 di Mulshi, hingga 0 di Indapur, Velhe, dan Ambegaon). Namun petanya masih punya kekurangan yang harus dirapikan manusia: legenda kuantil mencetak batas desimal seperti 0,0000 - 1,2000 untuk jumlah sekolah yang berupa bilangan bulat, dan label di tengah saling bertumpuk pada zoom default.

Cara 1: Menghubungkan Claude Desktop atau Claude Code lewat QGIS MCP

Memberi Claude server MCP QGIS mengatasi masalah kebutaan: Claude bisa memeriksa layer Anda, menjalankan execute_code, melihat traceback error, lalu mencoba lagi.

Saya tidak menjalankan ulang server MCP di Pune karena server Overpass publik pagi itu menolak jaringan kami dan akan memblokir panggilan OpenStreetMap yang sama. Sebagai gantinya, kami sudah mengukur Claude Sonnet 5.5 yang mengendalikan QGIS MCP (v0.15.0 sampai 0.15.2) di Claude Code pada empat tugas nyata dan benchmark 41 soal di akhir September dan Oktober 2026:

  • Setup butuh 5 langkah dan sekitar 3 menit kalau uv dan klien sudah terpasang, plus 16 detik pada panggilan pertama saat ia mengunduh server 90 MB yang menyediakan 125 alat. Setiap kali Anda memulai ulang QGIS, Anda harus ingat mengklik Run MCP lagi, atau Claude mengembalikan Error executing tool ping. Panduan setup dan uji QGIS MCP kami menjelaskan setiap langkah dan file konfigurasinya.
  • Pada tugas sekolah serupa di Lyon (menghitung sekolah dalam 300 m dari halte trem), Claude + QGIS MCP mendapat jumlah yang benar (87 sekolah) dalam 9 menit 28 detik. Enam dari sepuluh langkahnya berupa Python mentah, dan QGIS membeku sekitar 7 menit saat skrip terkena error Overpass 406, 504, dan 502.
  • Kalau datanya sudah bersih, MCP cepat. Pada tugas bangunan dan layout cetak di Porto, Claude + QGIS MCP selesai dalam 2 menit 48 detik, mengalahkan agen kami sendiri yang butuh 5 menit 26 detik.
  • Pada benchmark GeoExpertQueries dari Google (41 tugas held-out), Claude Sonnet 5.5 dengan QGIS MCP di Claude Code mendapat skor 24,9 dari 100, dibandingkan 43,8 untuk AI Agent dengan effort Low (lihat hasil benchmark lengkap).

Kalau Anda sudah membayar Claude Pro atau Max dan seharian bekerja di Claude Code, MCP tidak menambah biaya dan memberi kebebasan penuh untuk menggabungkan skrip shell, file lokal, dan QGIS dalam satu terminal.

Cara 3: Memakai plugin agen di dalam QGIS

Kami membuat AI Agent, jadi bagian ini tentang plugin kami sendiri. Alih-alih menjembatani aplikasi luar ke QGIS, ia menempelkan panel chat tepat di sebelah kanvas peta, membaca kondisi proyek Anda, mengambil data dari katalog bawaan (sekitar 90 sumber dan 2.800 dataset, ditambah OpenStreetMap dan Overture Maps), mengecek gambar hasil render peta sebelum menjawab, dan menaruh tombol Undo changes di bawah setiap balasan.

Saya menjalankan kalimat Pune yang persis sama dua kali di QGIS 3.44.15 (izin Balanced, effort Medium).

Pada uji pertama, setelah 11 detik, panel berhenti sejenak dan menampilkan kartu klarifikasi yang bertanya "Which subdivisions of Pune should the school counts use?" (subdivisi Pune mana yang dipakai untuk menghitung sekolah?) dengan dua pilihan yang bisa diklik: Pune city wards (ward kota Pune) dan Pune district tehsils (tehsil distrik Pune). Memilih Pune city wards membuat total waktu dari klik Send menjadi 63 detik dalam 15 langkah.

Render peta jarak dekat 58 ward pemilihan Pune yang diwarnai dalam lima kelas Jenks biru dari biru muda hingga biru tua, dengan penanda titik gelap untuk 256 sekolah OpenStreetMap.
Peta hasil render dari Uji 1: 58 ward pemilihan (batas DataMeet 2022) dalam lima kelas Jenks, dengan jumlah tertinggi (39 sekolah) di Ward 16 Fergusson College - Erandwane.

Pada uji kedua di chat baru, ia tidak bertanya; ia menyebutkan di jawabannya bahwa ia memakai 58 ward pemilihan Pune sebagai distrik kota dan selesai dalam sekitar 45 detik (16 langkah), dengan gaya palet oranye pada ward-nya.

Jendela QGIS dari uji kedua yang menampilkan ward pemilihan Pune dengan choropleth oranye lima kelas di kiri dan jawaban AI Agent di kanan yang mengonfirmasi 256 objek sekolah OpenStreetMap di 58 ward.
Uji 2 dengan prompt yang sama: selesai dalam sekitar 45 detik dengan 256 sekolah yang sama di 58 ward dan lima kelas Jenks (0-1, 1-5, 5-11, 11-22, 22-39).

Mengapa kedua uji berhasil sementara skrip yang ditempel terkena error koneksi? Karena agen tidak memanggil endpoint overpass-api.de yang kelebihan beban dari skrip mentah; ia mengambil ward pemilihan 2022 dari DataMeet dan mengambil 256 objek sekolah (108 node dan 148 way, dengan sekolah berbentuk poligon diubah menjadi titik permukaan) lewat alat data bawaannya. Ketika saya menjalankan pemeriksaan point-in-polygon terpisah pada kedua hasil, ke-256 titik sekolah berada di dalam 58 ward tanpa satu pun selisih dengan field atribut schools.

Ia juga menjaga layer tree tetap rapi dengan menyimpan tiga layer perantara di grup tersembunyi Working layers, dan mengingatkan saya di jawabannya bahwa OpenStreetMap bukan sensus sekolah resmi. Satu keluhan saya: antara Uji 1 dan Uji 2, ia berubah pikiran soal apakah harus menanyakan pilihan ward atau tehsil kepada saya atau memutuskannya sendiri.

Coba AI Agent gratis di QGIS, tanpa kartu

Cara mana yang sebaiknya Anda pilih?

Dalam pekerjaan saya sendiri, saya masih memakai Claude biasa di browser atau terminal ketika menulis skrip Processing yang akan dipakai ulang atau men-debug plugin kustom di dua puluh file. Di situ Anda ingin membaca Python-nya, meng-commit-nya ke Git, dan menjalankannya di luar GUI. Jangan lupa menempelkan versi QGIS, nama layer, nama field, dan CRS Anda ke prompt, dan bersiaplah memperbaiki satu atau dua import.

Pilih Claude + QGIS MCP kalau Anda sudah punya langganan Claude berbayar, terbiasa dengan uv dan file konfigurasi JSON, dan ingin menggabungkan operasi file lokal dengan panggilan QGIS di Claude Desktop atau Claude Code. Cara ini gratis di atas paket yang sudah Anda punya dan cepat kalau layer data Anda sudah dimuat.

Pilih agen di dalam QGIS ketika Anda menginginkan peta dan angkanya tanpa harus mengurus traceback Python, timeout Overpass, atau port yang rusak. Bagi analis yang dikejar tenggat atau tim yang butuh simbologi konsisten, kutipan sumber data, dan Undo sekali klik, agen dan katalog data yang sudah terpasang di dalam QGIS menghemat waktu paling banyak. Anda bisa membaca perbedaan arsitekturnya di panduan kami tentang apa itu AI agent di QGIS, atau melihat semua alat terkini di hub AI QGIS.

Cara kami mengukurnya. Semua uji Pune berlangsung pada 7 November 2026 antara pukul 10.29 dan 11.03 waktu Paris di macOS dengan QGIS 3.44.15-Solothurn (Qt 5.15.19). Kriteria keberhasilan ditulis pukul 10.14 sebelum prompt pertama. Claude Sonnet 5.5 (claude-sonnet-5-5) dipanggil lewat Claude Code 2.1.306 (claude -p --safe-mode --tools "" --model sonnet) di direktori kosong tanpa server MCP atau akses web; dua skrip yang dihasilkan dijalankan di Python QGIS dan dicek dengan skrip point-in-polygon terpisah. AI Agent 1.9.4 (mode Balanced, effort Medium) dijalankan dua kali dengan kalimat yang sama di proyek bersih. Sesi QGIS lain juga berjalan di Mac yang sama selama pengujian, jadi waktunya lebih lambat dibanding di mesin yang menganggur. Dua uji per cara pada satu tugas adalah sampel kecil, dan penolakan koneksi overpass-api.de diamati dari satu jaringan pada satu pagi.

Pertanyaan yang sering diajukan

Apakah ada plugin Claude resmi untuk QGIS?

Tidak. Anthropic tidak menerbitkan plugin QGIS. Per 7 November 2026, repositori plugin QGIS punya sembilan plugin komunitas yang menghubungkan Claude ke QGIS, baik lewat server Model Context Protocol (MCP) lokal (seperti QGIS MCP dan WAI QGIS MCP), lewat kunci API Anda sendiri, maupun lewat login Claude Code lokal (Mapsuke). Sebagai alternatif, AI Agent terpasang langsung dari plugin manager QGIS dengan model AI dan katalog data bawaan.

Bisakah Claude Desktop mengendalikan QGIS secara gratis?

Bisa, dengan batasan. Menurut dokumentasi paket Anthropic, chat Claude Desktop tersedia di paket Free dan mendukung server MCP lokal lewat claude_desktop_config.json atau Desktop Extensions (.mcpb). Menjalankan Claude Code dari terminal membutuhkan paket berbayar Claude Pro, Max, atau Ultra.

Bisakah Claude menulis kode PyQGIS yang berjalan di QGIS 3.44?

Bisa, Claude Sonnet 5.5 menulis PyQGIS yang terstruktur dengan baik, tetapi karena ia tidak bisa melihat instalasi QGIS Anda atau menguji kodenya sendiri, kadang ia mengarang nama kelas atau bergantung pada server luar yang gagal. Dalam uji dua sampel kami di QGIS 3.44.15, satu skrip gagal dengan ImportError pada QgsClassificationNaturalBreaks (kelas yang benar adalah QgsClassificationJenks) dan yang lain gagal sampai kami mengganti URL Overpass API-nya.

Apa cara termudah memakai AI di dalam QGIS tanpa setup MCP?

Pasang plugin agen terintegrasi dari Plugins > Manage and Install Plugins di QGIS. Dengan AI Agent, tidak ada environment Python, package manager uv, atau file konfigurasi yang perlu dirawat: Anda masuk secara gratis, mendapat 5 tugas per bulan (300 di Pro), lalu mengetik permintaan Anda di panel yang menempel.

Coba AI Agent gratis

Kerjakan di QGIS cukup dengan memintanya

AI Agent menjalankan tugas yang Anda jelaskan, langsung di proyek QGIS Anda sendiri. Gratis, tanpa kartu.

Coba AI Agent gratis