QGIS MCP: cara instal, batasan, dan alternatifnya
Diterbitkan Diperbarui
QGIS MCP adalah plugin QGIS gratis ditambah program kecil di komputer Anda, yang memungkinkan aplikasi AI di luar QGIS, biasanya Claude Desktop atau Claude Code, mengendalikan QGIS. Anda mengetik di aplikasi AI, aplikasi itu mengirim perintah ke QGIS lewat koneksi lokal, lalu QGIS menjalankannya: memuat layer, menjalankan tool Processing, mengatur simbologi peta, atau menjalankan kode Python.

Idenya bagus dan plugin-nya dibuat dengan baik. Nicolas Karasiak memelihara versi di repositori resmi QGIS, yang sudah diunduh 52.575 kali per 26 September 2026. Yang jarang dibahas tutorial adalah seberapa banyak yang harus disiapkan sampai semuanya jalan, dan di mana batasnya. Saya menyiapkannya dari nol, lalu memberi tugas yang sama kepada plugin ini dan kepada agen yang berjalan di dalam QGIS. Kami membuat yang kedua, AI Agent, jadi timbang kesimpulan saya dengan mengingat hal itu.
Apa itu MCP, dalam satu paragraf
MCP, Model Context Protocol, adalah standar terbuka yang dimulai oleh Anthropic agar aplikasi AI dapat memakai tool dari luar. Pengantar resminya menyebutnya “port USB-C untuk aplikasi AI”. Aplikasi AI disebut klien. Server menyediakan tool bagi klien itu. QGIS MCP adalah server yang tool-nya berupa aksi QGIS. Protokol ini menyatakan risikonya dengan jelas: “Tools represent arbitrary code execution and must be treated with appropriate caution.” (tool setara dengan eksekusi kode sembarang dan harus diperlakukan dengan hati-hati).
Cara kerja QGIS MCP
Empat komponen harus terinstal dan berjalan pada saat yang sama:
- Klien MCP: aplikasi AI tempat Anda mengetik, seperti Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI atau Gemini CLI.
- Server MCP: program Python kecil yang dijalankan klien di latar belakang lewat
uv, tool untuk menginstal dan menjalankan program Python. Anda harus menginstaluvlebih dulu. - Plugin QGIS MCP: berada di dalam QGIS dan menunggu perintah di port jaringan lokal bernomor 9876. Anda klik Run MCP di tombol toolbar plugin untuk memulainya.
- QGIS itu sendiri, dengan proyek Anda terbuka.
Saat Anda mengetik permintaan, model AI memilih sebuah tool QGIS, server meneruskan panggilan itu ke plugin, lalu plugin menjalankannya di QGIS dan mengirim kembali hasilnya. Model tidak melihat layar Anda. Model hanya melihat peta kalau ia meminta gambarnya dari QGIS.
Yang Anda butuhkan sebelum mulai
| Kebutuhan | Fungsi | Biaya |
|---|---|---|
| QGIS 3.28 atau lebih baru | Syarat minimum plugin | Gratis |
| Aplikasi klien MCP | Tempat Anda chat dengan model | Paket gratis dengan batas harian, atau paket berbayar |
uv (penjalan paket Python) | Menjalankan server MCP | Gratis, instal dengan satu perintah terminal |
| Perintah terminal atau satu baris di file konfigurasi | Memberi tahu klien lokasi server | Gratis, tetapi manual |
| Plugin QGIS MCP | Sisi QGIS dari jembatan ini | Gratis |
Sebuah panduan instalasi yang banyak dibaca menyebut Anda butuh akun Claude Pro berbayar. Tidak benar. Dokumentasi Anthropic untuk server MCP lokal tidak menyebut paket apa pun, dan seorang blogger GIS menjalankan QGIS MCP di paket gratis Claude pada Agustus 2026, dan hanya terkena batas pesan harian. ChatGPT lebih sulit. Pusat bantuan OpenAI menyebut ChatGPT hanya terhubung ke server MCP di internet, bukan ke server di komputer Anda, dan mode developer yang diperlukan hanya tersedia di paket berbayar.
Cara instal QGIS MCP, lengkap dengan waktunya
Saya menginstal QGIS MCP 0.15.0 di QGIS 3.44 pada 26 September 2026 dan mencatat setiap langkah. Halaman plugin-nya sendiri terus terang soal ini: “This plugin is only one half of the setup. You also need the qgis-mcp MCP server, which your MCP client runs to talk to QGIS.” (plugin ini hanya separuh dari pengaturan; Anda juga butuh server MCP qgis-mcp yang dijalankan klien MCP untuk berbicara dengan QGIS).
Instal plugin
Plugins > Manage and Install Plugins, cari QGIS MCP, lalu Install Plugin. Bagian ini cepat: plugin termuat dalam 2,7 detik, tanpa restart.Instal uv
Server berjalan lewat
uv, yang tidak disertakan di Windows maupun macOS. Anda menginstalnya dengan satu perintah di terminal.Siapkan klien MCP
Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI, atau aplikasi lain yang mendukung MCP, lengkap dengan akun dan paketnya sendiri.
Hubungkan klien ke QGIS
Configurator plugin menampilkan perintah untuk ditempel di terminal, misalnya
claude mcp add -s user qgis -- uvx ... qgis-mcp-server. Beberapa klien malah perlu satu baris tambahan di file pengaturan.Jalankan server di QGIS
Klik Run MCP di tombol toolbar plugin. QGIS mencatat “Token authentication disabled (open)” saat server mulai.
Kirim pesan pertama
Panggilan pertama mengunduh server sekitar 90 MB, lalu terhubung. Dalam pengujian saya ini memakan 16 detik, dan klien melihat 125 tool QGIS.
Configurator pada tangkapan layar di bawah adalah tempat Anda memilih klien dan menyalin perintah terminalnya.

Proses saya memakan sekitar tiga menit, tetapi uv dan klien sudah terinstal dan sebuah skrip yang mengklik semuanya. Pada percobaan pertama, orang sungguhan juga harus membaca dokumentasi, menginstal uv dan klien, lalu mengetik perintahnya.
Sebagian langkah itu terulang setiap hari. Setelah QGIS di-restart, server tetap mati kecuali Anda mencentang auto-start di Configurator. Aplikasi AI lalu hanya menjawab “Error executing tool ping”, dan Anda harus menebak sendiri bahwa solusinya adalah mengklik Run MCP lagi.
Tugas yang sama, dua cara
Saya memberi kedua tool permintaan yang sama, pada waktu yang sama di komputer yang sama, masing-masing di proyek QGIS yang baru: "In Lyon, France, find the schools within 300 metres of a tram stop, show them on a map with the tram lines, and tell me how many there are." (di Lyon, Prancis, cari sekolah dalam jarak 300 meter dari halte trem, tampilkan di peta bersama jalur trem, dan beri tahu berapa jumlahnya).
| QGIS MCP, dengan Claude Code | AI Agent | |
|---|---|---|
| Waktu sampai jawaban | 9 menit 28 detik | 5 menit 35 detik |
| Langkah | 10, 6 di antaranya kode Python | 40, 2 di antaranya kode Python |
| Data yang dipakai | OpenStreetMap, diunduh lewat Python yang ditulisnya sendiri | Layer resmi sekolah dasar, college, dan lycée dari Métropole de Lyon, ditambah halte dan jalur trem dari OpenStreetMap |
| Sekolah terhitung | 87 | 80 (52 sekolah dasar, 14 college, 14 lycée) |
Jumlahnya berbeda karena kedua tool memakai data yang berbeda. QGIS MCP menghitung sekolah OpenStreetMap di dekat halte trem yang diambil dari sebuah kotak di sekitar Lyon, sehingga beberapa halte tepat di luar kota ikut terhitung, dan ia sendiri menyatakan bahwa angka 87 belum dideduplikasi. AI Agent memakai daftar resmi sekolah milik kota dan batas komune Lyon.
Perbedaan terbesarnya ada pada cara mencapainya. QGIS MCP tidak punya tool data, jadi modelnya menulis Python untuk meminta data ke server Overpass milik OpenStreetMap. Server itu menjawab dengan error (406, 504, lalu 502 dua kali), dan ia mencoba ulang. Python itu berjalan di thread utama QGIS, sehingga QGIS membeku sekitar tujuh menit, dan peta tetap kosong sampai 7 menit 22 detik.

AI Agent mencari katalog datanya lebih dulu dan memuat layer sekolah resmi milik kota. Ketika data transportasi nasional tidak memberi label pada trem Lyon, ia beralih ke OpenStreetMap untuk halte dan jalur trem. Ia menulis Python dua kali, untuk mengukur jarak dari setiap sekolah ke halte terdekatnya.

Tiga tugas lagi, dan satu yang QGIS MCP lebih cepat
Satu balapan tidak membuktikan banyak, jadi saya mengukur tiga tugas lagi dengan cara yang sama. Tidak semuanya menguntungkan kami:
| Tugas | QGIS MCP, dengan Claude Code | AI Agent |
|---|---|---|
| Bangunan pusat kota bersejarah Porto menurut tipe, di atas basemap satelit | 1 menit 44 detik | 1 menit 21 detik |
| Sama, ditambah layout PDF A4 dengan judul, legenda, skala batang, dan panah utara | 2 menit 48 detik | 5 menit 26 detik |
| Bangunan di York yang berisiko banjir sungai, dari data Environment Agency | Belum selesai setelah 15 menit, tidak ada apa pun di peta | Belum selesai setelah 15 menit, sebagian data banjir termuat, tanpa hitungan |
Saat datanya hanya satu unduhan OpenStreetMap jauhnya, QGIS MCP mampu mengimbangi, dan pada layout PDF ia sekitar dua kali lebih cepat. Jawabannya sendiri memperingatkan bahwa ia mengekspor PDF tanpa memeriksa apakah tile satelitnya sudah termuat. Selisihnya muncul saat model harus mencari dan mengunduh datanya sendiri, seperti di Lyon. Tidak ada tool yang menyelesaikan tugas banjir York dalam 15 menit. Percobaan Porto pertama pada 26 September memakan 8 menit 29 detik untuk QGIS MCP karena server unduhan kelebihan beban hari itu, jadi saya mengukur ulang semuanya.
Cara kami mengukur. Komputer yang sama, kedua tool berjalan bersamaan, QGIS 3.44.15, proyek baru dan pengaturan default kecuali effort AI Agent, yang diatur ke Medium. Satu kali jalan masing-masing, tanpa percobaan ulang: QGIS MCP 0.15.2 yang dikendalikan Claude Code dengan Claude Sonnet 5.5 dan hanya tool QGIS yang diizinkan, serta AI Agent 1.9.0 dalam mode Balanced. Waktu QGIS MCP adalah waktu jalan Claude Code sendiri, yang tidak menghitung 52 detik yang dibutuhkan klien untuk mulai. Komputer sangat terbebani dan server OpenStreetMap gagal untuk kedua tool selama balapan Lyon. Kami merekam setiap percobaan.
Anda bisa mengirim permintaan yang sama di QGIS Anda sendiri dalam beberapa menit: instal plugin, masuk, lalu tempel permintaannya di panel.
Kekurangan QGIS MCP
Ini batasan yang saya temui atau yang tercatat di dokumentasi, masing-masing dengan sumbernya:
- Chat berada di luar QGIS. Anda berpindah antara dua jendela. Model bekerja dari hasil tool, dan hanya melihat peta kalau ia meminta gambarnya dari QGIS.
- Empat komponen yang bergerak. Saat tidak ada yang terjadi, masalahnya bisa ada di pengaturan klien,
uv, server, port, atau plugin. Halaman pemecahan masalah proyek ini mencantumkan “No response from QGIS”,Connection refused, danModuleNotFoundErrorsebagai error yang paling umum. - Jebakan di Windows. README memperingatkan bahwa Claude Desktop yang diinstal dari Microsoft Store menjalankan server di dalam sandbox yang merusak pengaturan biasa, sehingga konfigurasi yang jalan di tempat lain gagal di sana.
- Python apa pun, tanpa kata sandi secara default. Tool
execute_codemenjalankan PyQGIS (kode Python untuk QGIS) apa pun yang ditulis model. README menyatakannya sendiri: “By default the socket has no authentication... any process on the machine that can reach the port can drive QGIS (including execute_code, which runs arbitrary PyQGIS).” (secara default socket tidak punya autentikasi; proses apa pun di mesin yang bisa menjangkau port dapat mengendalikan QGIS, termasuk execute_code yang menjalankan PyQGIS sembarang). Satu fork, QGIS Agent MCP, dibuat terutama untuk menghapus tool itu. - Tidak punya data sendiri. Plugin ini mengendalikan QGIS, tetapi mencari dan mengunduh data diserahkan kepada model, biasanya dengan menulis Python. Dalam pengujian Lyon, 6 dari 10 langkahnya adalah Python, dan unduhannya membekukan QGIS sekitar tujuh menit.
- Tidak ada undo untuk satu permintaan utuh. Undo di QGIS hanya mencakup pengeditan, bukan layer yang ditambahkan atau file yang ditulis.
- Salinan dengan bintang terbanyak bukan yang dipelihara. Aslinya di GitHub, jjsantos01/qgis_mcp, punya 1.099 bintang, tidak ada perubahan kode sejak 1 Oktober 2025, dan satu issue terbuka berjudul “Broken plugin for QGIS version 4.01”. Versi yang dipelihara, nkarasiak/qgis-mcp, adalah yang ada di repositori plugin QGIS.
Kesalahan yang beredar di web
“Anda butuh Claude Pro.” Server MCP lokal berjalan di paket gratis Claude, dalam batas hariannya. Syarat paket berbayar ada di ChatGPT, yang memang tidak bisa menjangkau server di komputer Anda secara langsung.
“Restart komputer setelah mengedit konfigurasi.” Cukup restart aplikasi kliennya. Di Windows, pastikan aplikasi itu benar-benar tertutup, karena ia tetap berjalan di system tray.
“Instal repositori dengan bintang terbanyak.” Instal saja dari plugin manager QGIS, yang memberi Anda versi yang dipelihara.
Cara lain menghubungkan Claude ke QGIS
Plugin di atas adalah yang dimaksud sebagian besar panduan, tetapi tiga proyek lain juga menaruh Claude di QGIS. Dibaca di halaman masing-masing pada 23 Oktober 2026:
- piatkowski/qgis-mcp: proyek terpisah dengan nama yang sama, dibuat untuk Claude Desktop. Instalnya dari ZIP di halaman rilis GitHub-nya, bukan dari plugin manager, servernya butuh Python 3.12 atau lebih baru, dan ia mulai mendengarkan di port 9876 begitu plugin diaktifkan. Plugin di atas juga memakai port 9876, jadi jalankan satu per satu.
- ClaudIA QGIS: turunan dari plugin di atas, dengan port lokal diganti koneksi HTTPS ke komunitas agrônomo10X, sehingga tidak ada Python yang perlu diinstal. Ia butuh akun agrônomo10X, dan rilis 0.2.3 tanggal 15 September 2026 ditandai eksperimental.
- QGIS Agent: panel chat di dalam QGIS dengan kunci LLM Anda sendiri, plus server MCP lokal opsional yang bisa dikendalikan Claude Desktop atau Cursor.
Alternatif QGIS MCP: agen di dalam QGIS
Kami membuat AI Agent, jadi bagian ini membahas plugin kami sendiri. Plugin ini mengerjakan hal yang sama seperti QGIS MCP dari dalam QGIS: chat-nya berupa panel yang menempel di samping peta Anda, dan modelnya sudah termasuk dalam plugin. Pada benchmark GeoKTools dan GeoExpertQueries milik Google, Claude Sonnet 5.5 yang mengendalikan QGIS lewat plugin MCP ini (versi 0.15.1, di Claude Code) mendapat 24,9 dari 100 pada 41 pertanyaan uji terpisah, dan AI Agent pada effort Low (GPT-6 Luna) mendapat 43,8 (hasil benchmark).
Perbedaan yang terasa sehari-hari:
- Satu kali instal.
Plugins > Manage and Install Plugins, cari AI Agent by TerraLab, instal, lalu masuk. Tanpauv, tanpa file konfigurasi, tanpa aplikasi terpisah, tanpa server yang harus dimulai di setiap sesi. - Ia melihat proyek Anda. Nama layer, field, CRS, extent, dan seleksi ikut terkirim dalam setiap permintaan, dan ia merender peta untuk memeriksa hasil kerjanya sendiri.
- Data bawaan. Katalog 190 sumber data terbuka, dari OpenStreetMap hingga Sentinel-2 dan badan pemetaan nasional, sehingga model tidak perlu menulis kode unduhan.
- Ia bertanya dulu. Pada pengaturan default, ia berhenti sebelum menghapus atau menimpa, dan Python yang mengubah proyek Anda selalu butuh klik dari Anda.
- Undo per pesan. Setiap pesan meninggalkan titik pemulihan, dan satu klik mengembalikan proyek ke titik itu.
Plugin ini butuh koneksi internet dan mengirim deskripsi proyek Anda, bukan file data Anda, ke layanan yang di-host di Uni Eropa. Ada paket Free tanpa kartu, dan satu pesan dihitung sebagai satu tugas berapa pun jumlah langkahnya. Coba Pro gratis selama 7 hari: tambahkan kartu, batalkan sebelum berakhir dan tidak ada yang ditagih.
Coba AI Agent gratis di QGIS, tanpa kartu
QGIS MCP vs agen di dalam QGIS, berdampingan
| QGIS MCP | AI Agent | |
|---|---|---|
| Tempat Anda chat | Aplikasi di luar (Claude Desktop, Cursor, Claude Code) | Panel di dalam QGIS |
| Yang diinstal | Plugin, uv, klien MCP, satu entri konfigurasi | Satu plugin |
| Setiap sesi | Mulai server di QGIS, biarkan kedua aplikasi terbuka | Buka panel |
| Model | Apa pun yang dipakai klien Anda, sesuai paket Anda | Sudah termasuk |
| Katalog data terbuka | Tidak ada | 190 sumber |
| Menjalankan Python | Ya, tanpa bertanya secara default | Bertanya sebelum kode yang mengubah proyek |
| Undo satu permintaan utuh | Tidak | Ya, satu klik |
| Harga | Plugin gratis, ditambah paket AI Anda | Paket Free, lalu Pro seharga €49 per bulan |
| Paling cocok untuk | Developer yang sudah bekerja di Claude Code atau Cursor | Pengguna GIS yang ingin hasilnya langsung di QGIS |
Mana yang sebaiknya Anda pakai?
Kalau Anda sudah bekerja di Claude Code atau Cursor, menulis Python, dan ingin QGIS menjadi satu tool tambahan di sana, QGIS MCP cocok, dan tidak menambah biaya di luar paket AI yang sudah Anda bayar. Kalau Anda ingin mengetik tugas GIS dan mendapat hasilnya di proyek Anda, tanpa terminal, uv, atau aplikasi kedua, agen di dalam QGIS sampai ke tujuan dengan lebih sedikit yang perlu disiapkan dan dirawat. Kasus kedua inilah yang berlaku untuk sebagian besar pengguna GIS yang saya kenal.
Yang perlu diingat
QGIS MCP menghubungkan aplikasi AI di luar QGIS, seperti Claude Desktop, ke QGIS lewat koneksi lokal, sehingga model aplikasi itu dapat menjalankan tool QGIS dan Python.
Ia butuh empat komponen yang berjalan bersamaan: aplikasi klien, uv dan server MCP, plugin QGIS MCP dengan servernya yang sudah dimulai, dan QGIS.
Sisi QGIS terinstal dalam hitungan detik. Sisanya dikerjakan di luar QGIS: menginstal uv, aplikasi AI, perintah terminal, dan mengklik Run MCP lagi setiap kali restart.
Pada tugas Lyon, AI Agent menjawab dalam 5 menit 35 detik dari layer sekolah resmi milik kota. QGIS MCP butuh 9 menit 28 detik dan menulis Python untuk 6 dari 10 langkahnya. Pada tugas yang lebih sederhana selisihnya mengecil, dan pada layout PDF QGIS MCP lebih cepat.
ChatGPT tidak bisa memakai server MCP lokal secara langsung. Paket gratis Claude bisa, dalam batas hariannya.
Agen di dalam QGIS, seperti AI Agent, mengerjakan hal yang sama dari satu plugin, dengan model, katalog data, dan undo satu klik sudah termasuk.
Pertanyaan yang sering diajukan
Plugin QGIS dan server MCP lokal yang membuat aplikasi AI dapat mengendalikan QGIS lewat Model Context Protocol. Anda chat di aplikasi itu, biasanya Claude Desktop atau Claude Code, lalu model memanggil tool QGIS: memuat layer, menjalankan Processing, mengatur simbologi, merender peta, dan menjalankan Python.
Instal plugin QGIS MCP dari plugin manager lalu klik Run MCP, instal uv, kemudian tambahkan server QGIS MCP ke file konfigurasi Claude Desktop, atau jalankan perintah claude mcp add di Claude Code, lalu restart kliennya. Atau instal plugin agen yang berjalan di dalam QGIS dengan modelnya sendiri, seperti AI Agent, yang tidak memerlukan klien, uv, maupun konfigurasi.
Tidak secara langsung. Pusat bantuan OpenAI menyebut ChatGPT terhubung ke server MCP di internet, jadi server di komputer Anda, seperti QGIS MCP, memerlukan tunnel agar bisa dijangkau. Mode developer, yang diperlukan MCP, hanya tersedia di paket ChatGPT berbayar.
Ia dapat menjalankan Python apa pun yang ditulis model di dalam QGIS, dan secara default socket lokalnya tidak punya autentikasi, seperti yang dinyatakan README-nya. Pakai di mesin yang Anda percaya, atur token rahasia bersama kalau mesin dipakai orang lain, hentikan server setelah selesai, dan simpan cadangan proyek penting.
Penyebab yang paling umum, menurut panduan pemecahan masalah proyeknya: server belum dimulai di QGIS (Connection refused, klik Run MCP), uv belum terinstal atau tidak ditemukan (ModuleNotFoundError), atau portnya bukan 9876. Setelah QGIS di-restart, server mati lagi kecuali auto-start dicentang. Di Windows, Claude Desktop hasil instalasi Microsoft Store memerlukan bentuk --directory pada konfigurasinya.
Ada. Plugin agen berjalan di dalam QGIS sebagai panel chat, tanpa aplikasi luar atau server lokal. Pada September 2026 kami menghitung 38 plugin agen dan asisten di repositori resmi. Plugin kami, AI Agent, sudah mencakup model, 190 sumber data terbuka, dan undo satu klik, dengan paket Free.
Apa itu AI agent di QGIS menghitung semua 38 plugin agen dan asisten di repositori resmi, termasuk jembatan MCP. Panduan AI Agent menampilkan sepuluh proses nyata beserta prompt-nya, dan PyQGIS mengukur seberapa sering kode buatan chatbot langsung jalan pada percobaan pertama. Hub AI untuk QGIS membandingkan bidang yang lebih luas.
Baca selanjutnyaClaude untuk QGIS: 3 Cara Menghubungkannya, Diuji pada Satu Tugas
Kerjakan di QGIS cukup dengan memintanya
AI Agent menjalankan tugas yang Anda jelaskan, langsung di proyek QGIS Anda sendiri. Gratis, tanpa kartu.


