QGIS MCP: cara instal, batasan, dan alternatifnya

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:

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

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

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, di proyek QGIS yang baru: “Load the buildings of the historic centre of Porto, Portugal from OpenStreetMap, colour them by building type, add a satellite basemap underneath, and tell me how many buildings there are.” (muat bangunan di pusat kota bersejarah Porto, Portugal dari OpenStreetMap, beri warna menurut tipe bangunan, tambahkan basemap satelit di bawahnya, dan beri tahu berapa jumlah bangunannya).

Kedua angka itu benar untuk area yang dipilih masing-masing tool, itulah sebabnya hasilnya berbeda. Yang berbeda adalah cara mencapainya. QGIS MCP tidak punya tool data, jadi modelnya menulis Python untuk mengunduh data OpenStreetMap. Saat server unduhan lambat, percobaan ulangnya membekukan QGIS hingga satu menit setiap kali. Sisi baiknya, model itu menemukan bug-nya sendiri yang menghilangkan 37 bangunan, lalu memperbaikinya.

AI Agent memakai tool OpenStreetMap bawaannya, mencari batas asli pusat kota bersejarah, memotong bangunan dengan batas itu, lalu mengatur simbologinya, tanpa menulis kode sama sekali. Basemap satelitnya lebih buram pada zoom ini dibandingkan pilihan QGIS MCP.

Cara kami mengukur. Komputer yang sama, QGIS 3.44.7, permintaan yang sama, proyek baru dengan pengaturan default, QGIS MCP 0.15.0 yang dikendalikan Claude Code dengan Claude Sonnet, dan AI Agent 1.4.1. Kami memeriksa kedua hitungan sendiri, terhadap OpenStreetMap untuk persegi panjang dan dengan menghitung layer akhir untuk batas. Server unduhan sedang kelebihan beban saat QGIS MCP dijalankan, sehingga waktunya bertambah, dan percobaan pertama AI Agent membuat QGIS crash, bug yang sudah kami catat, jadi angkanya berasal dari percobaan ulang.

Anda bisa mengirim permintaan yang sama di QGIS Anda sendiri dalam beberapa menit: instal plugin, masuk, lalu tempel permintaannya di panel.

Coba AI Agent gratis di QGIS, tanpa kartu

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 saya, 17 dari 28 aksinya adalah Python, dan percobaan ulang unduhannya membekukan QGIS selama 40 sampai 62 detik setiap kali.
• 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.

Alternatif yang lebih mudah: 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.

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 55 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 AI Agent gratis di QGIS, tanpa kartu

QGIS MCP vs agen di dalam QGIS, berdampingan

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 Porto yang sama, AI Agent menjawab dalam 1 menit 11 detik dengan 15 aksi dan tanpa kode. QGIS MCP butuh 8 menit 29 detik dan menulis Python untuk 17 dari 28 aksinya.

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

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.

Bagaimana cara menghubungkan Claude ke QGIS?

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.

Apakah ChatGPT bisa memakai QGIS MCP?

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.

Apakah QGIS MCP aman?

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.

Kenapa QGIS MCP tidak bisa terhubung?

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.

Adakah alternatif untuk QGIS MCP?

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