Lewati ke konten
AI Agent
QGIS
Panduan

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.

Dua baris membandingkan arsitektur. Baris atas, QGIS MCP, empat bagian yang harus Anda instal, konfigurasikan, dan jalankan: klien AI seperti Claude Desktop, Claude Code atau Cursor dengan paketnya sendiri, berbicara lewat stdio ke server MCP, yaitu proses Python yang dijalankan lewat uv dengan uvx qgis-mcp-server, berbicara lewat TCP port 9876 ke plugin QGIS MCP, sebuah socket server di dalam QGIS yang harus Anda mulai dengan klik Run MCP di setiap sesi, yang mengendalikan proyek QGIS Anda. Baris bawah, AI Agent, satu plugin: panel AI Agent yang menempel di QGIS, diinstal dari plugin manager, yang melihat layer, field, CRS, extent, dan seleksi, berbicara lewat HTTPS ke layanan agen yang menjalankan model di Uni Eropa tanpa kunci API atau aplikasi klien, yang mengendalikan proyek QGIS Anda.
Atas: empat bagian yang harus berjalan bersamaan agar QGIS MCP berfungsi. Bawah: plugin agen yang berada di dalam QGIS, dalam hal ini plugin kami.

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:

  1. Klien MCP: aplikasi AI tempat Anda mengetik, seperti Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI atau Gemini CLI.
  2. Server MCP: program Python kecil yang dijalankan klien di latar belakang lewat uv, tool untuk menginstal dan menjalankan program Python. Anda harus menginstal uv lebih dulu.
  3. 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.
  4. 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

KebutuhanFungsiBiaya
QGIS 3.28 atau lebih baruSyarat minimum pluginGratis
Aplikasi klien MCPTempat Anda chat dengan modelPaket gratis dengan batas harian, atau paket berbayar
uv (penjalan paket Python)Menjalankan server MCPGratis, instal dengan satu perintah terminal
Perintah terminal atau satu baris di file konfigurasiMemberi tahu klien lokasi serverGratis, tetapi manual
Plugin QGIS MCPSisi QGIS dari jembatan iniGratis

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

  1. Instal plugin

    Plugins > Manage and Install Plugins, cari QGIS MCP, lalu Install Plugin. Bagian ini cepat: plugin termuat dalam 2,7 detik, tanpa restart.

  2. Instal uv

    Server berjalan lewat uv, yang tidak disertakan di Windows maupun macOS. Anda menginstalnya dengan satu perintah di terminal.

  3. Siapkan klien MCP

    Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI, atau aplikasi lain yang mendukung MCP, lengkap dengan akun dan paketnya sendiri.

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

  5. Jalankan server di QGIS

    Klik Run MCP di tombol toolbar plugin. QGIS mencatat “Token authentication disabled (open)” saat server mulai.

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

Kiri: halaman plugin manager QGIS untuk QGIS MCP 0.15.0 oleh Nicolas Karasiak, 387 suara dan 52.575 unduhan, dengan deskripsi yang menyebut plugin ini hanya separuh dari pengaturan dan Anda juga butuh server MCP qgis-mcp. Kanan: jendela Setup dan Configurator milik plugin dengan claude-code dipilih sebagai klien, status Server running on port 9876, dan perintah untuk dijalankan di terminal yang diawali claude mcp add.
Halaman plugin dan Configurator-nya. Sisi QGIS cepat; sisanya dikerjakan di terminal dan aplikasi lain.

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 CodeAI Agent
Waktu sampai jawaban9 menit 28 detik5 menit 35 detik
Langkah10, 6 di antaranya kode Python40, 2 di antaranya kode Python
Data yang dipakaiOpenStreetMap, diunduh lewat Python yang ditulisnya sendiriLayer resmi sekolah dasar, college, dan lycée dari Métropole de Lyon, ditambah halte dan jalur trem dari OpenStreetMap
Sekolah terhitung8780 (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.

QGIS setelah dijalankan dengan QGIS MCP di Lyon: titik merah untuk sekolah dalam jarak 300 m dari halte trem, jalur trem biru dan halte trem abu-abu di atas latar putih tanpa basemap. Panel Layers memuat schools_within_300m, tram_lines, tram_stops, dan layer schools_all yang disembunyikan.
QGIS MCP dengan Claude Code: 9 menit 28 detik, 87 sekolah, setiap unduhan ditulis dalam Python.

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.

QGIS dengan panel AI Agent di sisi kanan. Peta menampilkan garis batas komune Lyon, jalur trem, dan sekolah dalam jarak 300 m dari sebuah halte, diberi label nama dan diwarnai sebagai sekolah dasar, college, dan lycée. Jawaban agen menampilkan kartu statistik berisi 80 sekolah (52 sekolah dasar, 14 college, 14 lycée) dan jarak ke halte terdekat 14,6 sampai 297,2 m, lalu sumbernya: sekolah Métropole de Lyon, halte dan jalur trem OpenStreetMap, batas Lyon, dan sebuah ekstrak GTFS.
AI Agent: 5 menit 35 detik, 80 sekolah, dari layer sekolah milik kota sendiri.

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:

TugasQGIS MCP, dengan Claude CodeAI Agent
Bangunan pusat kota bersejarah Porto menurut tipe, di atas basemap satelit1 menit 44 detik1 menit 21 detik
Sama, ditambah layout PDF A4 dengan judul, legenda, skala batang, dan panah utara2 menit 48 detik5 menit 26 detik
Bangunan di York yang berisiko banjir sungai, dari data Environment AgencyBelum selesai setelah 15 menit, tidak ada apa pun di petaBelum 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, dan ModuleNotFoundError sebagai 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_code menjalankan 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. Tanpa uv, 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 MCPAI Agent
Tempat Anda chatAplikasi di luar (Claude Desktop, Cursor, Claude Code)Panel di dalam QGIS
Yang diinstalPlugin, uv, klien MCP, satu entri konfigurasiSatu plugin
Setiap sesiMulai server di QGIS, biarkan kedua aplikasi terbukaBuka panel
ModelApa pun yang dipakai klien Anda, sesuai paket AndaSudah termasuk
Katalog data terbukaTidak ada190 sumber
Menjalankan PythonYa, tanpa bertanya secara defaultBertanya sebelum kode yang mengubah proyek
Undo satu permintaan utuhTidakYa, satu klik
HargaPlugin gratis, ditambah paket AI AndaPaket Free, lalu Pro seharga €49 per bulan
Paling cocok untukDeveloper yang sudah bekerja di Claude Code atau CursorPengguna 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

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.

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

Baca juga