QGIS MCPとは?設定方法・制限・簡単な代替手段
公開日 更新日
QGIS MCPは、無料のQGISプラグインと、パソコン上で動く小さなプログラムを組み合わせて、QGISの外にあるAIアプリ(主にClaude DesktopやClaude Code)からQGISを操作できるようにする仕組みです。AIアプリに指示を入力すると、ローカル接続を通じてQGISにコマンドが送られ、QGISがそれを実行します。レイヤの読み込み、プロセシングツールの実行、地図のスタイル設定、Pythonコードの実行まで行えます。

アイデアは優れていて、プラグインもよくできています。公式のQGISリポジトリにあるバージョンはNicolas Karasiakが保守していて、2026年9月26日時点のダウンロード数は52,575回でした。ただし、多くのチュートリアルは、動かすまでにどれだけ手間がかかるか、どこで行き詰まるかには触れていません。そこで、ゼロからセットアップし、同じタスクをQGIS MCPと、QGIS内で動くエージェントの両方に実行させてみました。後者は当社が開発しているAI Agentです。この点を踏まえて結論を読んでください。
MCPとは
MCP(Model Context Protocol)は、AIアプリが外部のツールを使えるようにするオープンな規格で、Anthropicが提唱しました。公式の紹介ページは、これを「AIアプリケーションのためのUSB-Cポート」と表現しています。AIアプリがクライアント、ツールを提供する側がサーバーです。QGIS MCPは、QGISの操作をツールとして提供するサーバーにあたります。規格自体が、リスクをはっきり書いています。「ツールは任意のコード実行にあたり、十分な注意をもって扱わなければならない。」
QGIS MCPのしくみ
次の4つを、同時にインストールして動かす必要があります。
- MCPクライアント:入力を行うAIアプリ。Claude Desktop、Claude Code、Cursor、VS Code、Codex CLI、Gemini CLIなどです。
- MCPサーバー:クライアントがバックグラウンドで起動する小さなPythonプログラム。Pythonプログラムをインストールして実行するツール
uvを介して起動するので、先にuvを入れておきます。 - QGIS MCPプラグイン:QGIS内で、ローカルのネットワークポート(9876番)にコマンドが届くのを待ち受けます。ツールバーのボタンからRun MCPをクリックして起動します。
- QGIS本体:プロジェクトを開いた状態にしておきます。
指示を入力すると、AIモデルがQGISのツールを選び、サーバーがその呼び出しをプラグインに渡し、プラグインがQGISで実行して結果を返します。モデルが画面を見ているわけではありません。地図が見えるのは、QGISに地図画像を要求したときだけです。
始める前に必要なもの
| 必要なもの | 理由 | 費用 |
|---|---|---|
| QGIS 3.28以降 | プラグインの最低要件 | 無料 |
| MCPクライアントアプリ | モデルとやり取りする場所 | 1日の利用上限付きの無料枠、または有料プラン |
uv(Pythonパッケージの実行ツール) | MCPサーバーを起動する | 無料。インストールはターミナルでコマンド1つ |
| ターミナルのコマンド、または設定ファイルへの追記 | サーバーの場所をクライアントに伝える | 無料。ただし手作業 |
| QGIS MCPプラグイン | 接続のQGIS側 | 無料 |
広く読まれているセットアップ記事には、有料のClaude Proアカウントが必要と書かれています。これは誤りです。AnthropicのローカルのMCPサーバーに関するドキュメントに、必要なプランの指定はありません。実際にGIS系のブロガーが2026年8月にClaudeの無料枠でQGIS MCPを動かし、1日のメッセージ上限にだけ引っかかったと報告しています。ChatGPTはもっと難しくなります。OpenAIのヘルプセンターによると、接続できるのはインターネット上のMCPサーバーだけで、手元のパソコン上のサーバーには接続できません。しかも必要な開発者モードは有料プラン向けです。
QGIS MCPのセットアップ(所要時間を計測)
2026年9月26日に、QGIS 3.44へQGIS MCP 0.15.0をインストールし、全ステップを記録しました。プラグインの紹介ページにも、はっきり書かれています。「このプラグインはセットアップの半分にすぎません。MCPクライアントがQGISと通信するために実行する、qgis-mcp MCPサーバーも必要です。」
プラグインをインストールする
「プラグイン」→「プラグインの管理とインストール」を開き、QGIS MCPを検索して「プラグインをインストール」をクリックします。ここは簡単で、再起動なしで2.7秒で読み込まれました。
uvをインストールする
サーバーは
uvを通じて動きますが、WindowsにもmacOSにも標準では入っていません。ターミナルでコマンドを1つ実行してインストールします。MCPクライアントを用意する
Claude Code、Claude Desktop、Cursor、Codex、Gemini CLI、またはMCPに対応したほかのアプリです。アカウントとプランはそのアプリごとに必要です。
クライアントをQGISにつなぐ
プラグインのConfiguratorに、ターミナルに貼り付けるコマンドが表示されます。たとえば
claude mcp add -s user qgis -- uvx ... qgis-mcp-serverのようなものです。クライアントによっては、設定ファイルに1行追加する方式になります。QGISでサーバーを起動する
プラグインのツールバーボタンからRun MCPをクリックします。起動時、QGISのログに「Token authentication disabled (open)」と記録されます。
最初のメッセージを送る
最初の呼び出しで約90MBのサーバーをダウンロードしてから接続します。今回のテストでは16秒かかり、クライアントにはQGISのツールが125個見えていました。
下のスクリーンショットのConfiguratorで、使うクライアントを選び、ターミナル用のコマンドをコピーします。

今回の所要時間は約3分でしたが、uvとクライアントは導入済みで、クリック操作もスクリプトに任せていました。初めて行う人は、ドキュメントを読み、uvとクライアントをインストールし、コマンドを入力することになります。
一部は毎日の作業として戻ってきます。QGISを再起動すると、Configuratorで自動起動にチェックを入れていない限り、サーバーは停止したままです。そうなると、AIアプリには「Error executing tool ping」としか表示されません。「Run MCPをもう一度クリックする」という対処法は、自分で推測するしかありません。
同じタスクを両方で実行する
2つのツールに同じ依頼を、同じパソコンで同時に、それぞれ新しいQGISプロジェクトで出しました。「フランスのリヨンで、トラム停留所から300メートル以内にある学校を探し、トラム路線とあわせて地図に表示して、何校あるか教えてください。」
| QGIS MCP(Claude Code使用) | AI Agent | |
|---|---|---|
| 答えが出るまでの時間 | 9分28秒 | 5分35秒 |
| ステップ数 | 10件(うち6件はPythonコード) | 40件(うち2件はPythonコード) |
| 使ったデータ | OpenStreetMap。自分で書いたPythonでダウンロード | Métropole de Lyonの公式の小学校・中学校・高校のレイヤと、OpenStreetMapのトラム停留所・線路 |
| 数えた学校数 | 87校 | 80校(小学校52校、中学校14校、高校14校) |
数が違うのは、2つのツールが別のデータを使ったからです。QGIS MCPは、リヨンの周囲に取った矩形から得たトラム停留所の近くにある、OpenStreetMapの学校を数えました。そのため、市の外のすぐ近くにある停留所もいくつか含まれ、87校は重複を除いていない数だと、モデル自身が書いていました。AI Agentは、市の公式の学校台帳と、リヨン市の境界を使いました。
そこに至る過程のほうが、より大きな違いです。QGIS MCPにはデータ取得用のツールがないため、モデルはOpenStreetMapのOverpassサーバーに問い合わせるPythonを書きました。サーバーはエラー(406、504、そして502が2回)を返し、モデルはリトライしました。そのPythonはQGISのメインスレッドで動いたため、QGISは約7分間固まり、地図は7分22秒まで空のままでした。

AI Agentは、まずデータカタログを検索し、市の公式の学校レイヤを読み込みました。国の公共交通フィードでリヨンのトラムを区別できなかったため、トラムの停留所と線路にはOpenStreetMapに切り替えました。Pythonを書いたのは2回で、各学校から最寄りの停留所までの距離を測るためです。

ほかの3つのタスク。QGIS MCPのほうが速かったものもあります
1回の比較だけでは判断できないので、同じ方法でほかに3つのタスクを計測しました。すべてが当社に有利な結果ではありません。
| タスク | QGIS MCP(Claude Code使用) | AI Agent |
|---|---|---|
| ポルト歴史地区の建物を種類別に色分けし、衛星画像のベースマップを追加 | 1分44秒 | 1分21秒 |
| 上と同じ内容に、タイトル、凡例、スケールバー、方位記号を入れたA4のPDFレイアウトを追加 | 2分48秒 | 5分26秒 |
| ヨークで河川の洪水リスクがある建物(Environment Agencyのデータ) | 15分たっても終わらず、地図には何も表示されない | 15分たっても終わらず、洪水データの一部は読み込めたが、件数は出ない |
データがOpenStreetMapのダウンロード1回で手に入るなら、QGIS MCPも遜色なく動き、PDFレイアウトでは約2倍速くなりました。ただし、その回答自身が、衛星タイルが読み込まれたか確認せずにPDFを書き出したと警告していました。差が開くのは、リヨンのように、モデルがデータを自分で探してダウンロードしなければならないときです。ヨークの洪水タスクは、どちらのツールも15分では終わりませんでした。9月26日の最初のポルトの実行では、その日はダウンロードサーバーが過負荷だったためQGIS MCPに8分29秒かかったので、すべてを計測し直しました。
計測方法。 同じパソコンで両方のツールを同時に動かし、QGIS 3.44.15、新規プロジェクト、既定の設定で実行しました。ただしAI Agentのeffortだけは、Mediumにしています。実行は1回ずつで、やり直しはしていません。QGIS MCP 0.15.2はClaude Sonnet 5.5のClaude Codeから、QGISのツールだけを許可して実行し、AI Agentは1.9.0をBalancedモードで実行しました。QGIS MCPの時間はClaude Code自体の実行時間で、クライアントの起動にかかった52秒は含みません。リヨンの比較中は、パソコンの負荷が高く、OpenStreetMapのサーバーが両方のツールに対してエラーを返していました。すべての実行を録画しています。
同じ依頼は、ご自身のQGISでも数分で試せます。プラグインをインストールしてログインし、パネルに貼り付けるだけです。
QGIS MCPの弱点
実際に遭遇した、または文書に書かれていた制約を、出典とともにまとめます。
- チャットがQGISの外にある。 2つのウィンドウを行き来することになります。モデルはツールの結果をもとに作業し、地図が見えるのは、QGISに地図画像を要求したときだけです。
- 動く部品が4つある。 何も起きないとき、原因はクライアントの設定、
uv、サーバー、ポート、プラグインのどこにもありえます。プロジェクトのトラブルシューティングのページには、よくあるエラーとして「No response from QGIS」、Connection refused、ModuleNotFoundErrorが挙げられています。 - Windowsの落とし穴。 READMEには、Microsoft StoreからインストールしたClaude Desktopはサーバーをサンドボックス内で実行するため、通常の設定が通らない、という注意書きがあります。ほかの環境で動く設定が、ここでは失敗します。
- 任意のPythonが動き、既定ではパスワードがない。
execute_codeツールは、モデルが書いたPyQGIS(QGISのPythonコード)を何でも実行します。READMEにもこうあります。「既定ではソケットに認証はありません。ポートに到達できるマシン上のどのプロセスも、QGISを操作できます(任意のPyQGISを実行するexecute_codeを含む)。」フォークのひとつ、QGIS Agent MCPは、主にこのツールを取り除くために存在します。 - 独自のデータ機能がない。 QGISは操作できますが、データの検索とダウンロードはモデル任せで、たいていはPythonを書いて行います。リヨンのテストでは、10ステップのうち6件がPythonで、ダウンロードによってQGISが約7分間固まりました。
- 依頼全体を元に戻せない。 QGISの「元に戻す」が対象にするのは編集で、追加したレイヤや書き出したファイルは含まれません。
- スターが最も多いリポジトリは、保守されているものではない。 GitHubの元のリポジトリjjsantos01/qgis_mcpはスターが1,099個ありますが、2025年10月1日以降コードの更新がなく、「Broken plugin for QGIS version 4.01」というIssueが未解決のままです。保守されているのはnkarasiak/qgis-mcpで、QGISのプラグインリポジトリにあるのはこちらです。
ネット上の情報で誤っているところ
「Claude Proが必要」。 ローカルのMCPサーバーは、1日の利用上限の範囲内であればClaudeの無料プランでも動きます。有料プランが条件になっているのはChatGPTですが、そもそもChatGPTは手元のパソコン上のサーバーに直接つなげません。
「設定を編集したらパソコンを再起動する」。 再起動が必要なのはクライアントアプリだけです。Windowsでは、システムトレイに常駐し続けるので、完全に終了していることを確認してください。
「スターが最も多いリポジトリをインストールする」。 代わりにQGISのプラグインマネージャからインストールしてください。保守されているバージョンが入ります。
QGISにClaudeをつなぐ、ほかの方法
上のプラグインは多くのガイドが指すものですが、ClaudeをQGISに入れるプロジェクトはほかに3つあります。2026年10月23日に各ページで確認した内容です。
- piatkowski/qgis-mcp: 同じ名前の別プロジェクトで、Claude Desktop向けに作られています。プラグインマネージャではなく、GitHubのリリースページにあるZIPからインストールします。サーバーにはPython 3.12以降が必要で、プラグインを有効にするとすぐポート9876で待ち受けを始めます。上のプラグインもポート9876を使うので、同時に動かせるのは一方だけです。
- ClaudIA QGIS: 上のプラグインから派生したもので、ローカルのポートをHTTPS経由のagrônomo10Xコミュニティへの接続に置き換えているため、インストールするPythonはありません。agrônomo10Xのアカウントが必要で、2026年9月15日公開の0.2.3は実験版と表示されています。
- QGIS Agent: 自分のLLMキーで動くQGIS内のチャットパネルです。任意のローカルMCPサーバーが付き、Claude DesktopやCursorから操作できます。
QGIS MCPの代わりになる方法:QGIS内で動くエージェント
当社はAI Agentを開発しています。このセクションは自社プラグインについての話です。QGIS MCPと同じ仕事を、QGISの中から行います。チャットは地図の隣にドッキングしたパネルで、モデルはプラグインに含まれています。GoogleのGeoKToolsとGeoExpertQueriesのベンチマークでは、このMCPプラグイン(バージョン0.15.1、Claude Code)経由でQGISを操作したClaude Sonnet 5.5が、ホールドアウトの41問に対して100点満点中24.9点、Low effort(GPT-6 Luna)のAI Agentが43.8点でした(ベンチマークの結果)。
毎日の使い勝手で効いてくる違いは次のとおりです。
- インストールは1回だけ。 「プラグイン」→「プラグインの管理とインストール」を開き、AI Agent by TerraLabを検索してインストールし、ログインします。
uvも、設定ファイルも、別のアプリも、セッションごとのサーバー起動も不要です。 - プロジェクトを把握している。 レイヤ名、フィールド、CRS、領域、選択範囲が依頼のたびに渡され、自分の作業結果を確かめるために地図も描画します。
- データが組み込み済み。 OpenStreetMapからSentinel-2、各国の地図作成機関まで、190種類のオープンデータソースのカタログがあるので、モデルがダウンロード用のコードを書く必要はありません。
- 先に確認する。 既定の設定では、削除や上書きの前に止まります。プロジェクトを変更するPythonは、必ずクリックでの許可が必要です。
- メッセージ単位で元に戻せる。 メッセージごとに復元ポイントが作られ、クリック1回でプロジェクトをその時点に戻せます。
インターネット接続が必要です。送信されるのはプロジェクトの説明で、データファイルは送りません。送信先はEU内にあるサービスです。クレジットカード不要の無料プランがあり、1回のメッセージは、何ステップかかっても1回のタスクとして数えられます。Proを7日間無料でお試しいただけます。カードを登録し、期間が終わる前に解約すれば、料金は請求されません。
QGIS MCPとQGIS内のエージェントの比較
| QGIS MCP | AI Agent | |
|---|---|---|
| チャットする場所 | 外部のアプリ(Claude Desktop、Cursor、Claude Code) | QGIS内のパネル |
| インストールするもの | プラグイン、uv、MCPクライアント、設定の記述 | プラグイン1つ |
| セッションごとの作業 | QGISでサーバーを起動し、2つのアプリを開いたままにする | パネルを開く |
| モデル | クライアントが使うもの(ご自身のプランで利用) | 含まれる |
| オープンデータのカタログ | なし | 190種類 |
| Pythonの実行 | する。既定では確認なし | プロジェクトを変更するコードは先に確認 |
| 依頼全体の取り消し | できない | できる(クリック1回) |
| 料金 | プラグインは無料。別途AIのプラン代 | 無料プラン、Proは月額€49 |
| 向いている人 | すでにClaude CodeやCursorで作業している開発者 | 結果をQGISで受け取りたいGISユーザー |
どちらを使うべきか
すでにClaude CodeやCursorで作業していて、Pythonを書き、QGISをそこで使えるツールのひとつに加えたいなら、QGIS MCPが向いています。すでに支払っているAIプランに追加費用はかかりません。GISの作業を入力して、ターミナルもuvも別のアプリも使わずにプロジェクトで結果を受け取りたいなら、QGIS内で動くエージェントのほうが、設定も保守も少なくて済みます。私の知るGISユーザーの多くは、こちらに当てはまります。
まとめ
QGIS MCPは、Claude DesktopのようなQGISの外にあるAIアプリを、ローカル接続でQGISにつなぎ、そのアプリのモデルがQGISのツールとPythonを実行できるようにします。
動かすには4つの部品が同時に必要です。クライアントアプリ、uvとMCPサーバー、サーバーを起動したQGIS MCPプラグイン、そしてQGISです。
QGIS側のインストールは数秒で終わります。残りはQGISの外での作業です。uvとAIアプリのインストール、ターミナルのコマンド、そして再起動のたびにRun MCPをクリックし直すことです。
リヨンのタスクで、AI Agentは市の公式の学校レイヤを使い、5分35秒で答えを出しました。QGIS MCPは9分28秒かかり、10ステップのうち6件でPythonを書きました。簡単なタスクでは差は縮まり、PDFレイアウトではQGIS MCPのほうが速くなりました。
ChatGPTはローカルのMCPサーバーに直接つなげません。Claudeの無料プランは、1日の利用上限の範囲内で動きます。
AI Agentのような、QGIS内で動くエージェントなら、同じ仕事をプラグイン1つで行えます。モデル、データカタログ、クリック1回で戻せる機能が含まれています。
よくある質問
AIアプリがModel Context Protocolを通じてQGISを操作できるようにする、QGISプラグインとローカルのMCPサーバーです。アプリ(主にClaude DesktopやClaude Code)でチャットすると、モデルがQGISのツールを呼び出し、レイヤの読み込み、プロセシングの実行、スタイル設定、地図の描画、Pythonの実行を行います。
プラグインマネージャからQGIS MCPプラグインをインストールして「Run MCP」をクリックし、uvをインストールします。そのうえで、Claude Desktopの設定ファイルにQGIS MCPサーバーを追加するか、Claude Codeでclaude mcp addコマンドを実行し、クライアントを再起動します。別の方法として、モデルを内蔵し、QGISの中で動くエージェントプラグイン(たとえばAI Agent)を使えば、クライアントもuvも設定ファイルも不要です。
直接は使えません。OpenAIのヘルプセンターによると、ChatGPTが接続できるのはインターネット上のMCPサーバーです。QGIS MCPのようにパソコン上にあるサーバーを使うには、外から届くようにするトンネルが必要になります。MCPに必須の開発者モードも、有料のChatGPTプランに限られます。
QGIS内で、モデルが書いたPythonを何でも実行できます。READMEにあるとおり、ローカルのソケットには既定で認証がありません。信頼できるマシンで使い、ほかの人と共有しているマシンでは共有シークレットのトークンを設定し、使い終わったらサーバーを止め、大事なプロジェクトはバックアップを取ってください。
プロジェクトのトラブルシューティングガイドによると、よくある原因は次のとおりです。QGISでサーバーが起動していない(Connection refused、Run MCPをクリックする)、uvが未インストールまたは見つからない(ModuleNotFoundError)、ポートが9876番ではない。QGISを再起動すると、自動起動にチェックを入れていない限りサーバーはまた停止します。Windowsで、Microsoft StoreからインストールしたClaude Desktopを使っている場合は、設定に--directory形式が必要です。
あります。エージェントプラグインは、外部のアプリもローカルのサーバーも使わず、チャットパネルとしてQGISの中で動きます。2026年9月の時点で、公式リポジトリに38個のエージェント・アシスタント系プラグインがあることを確認しました。当社のAI Agentは、モデル、190種類のオープンデータソース、クリック1回で戻せる機能を備え、無料プランもあります。
QGISのAIエージェントとはでは、MCPブリッジも含め、公式リポジトリにある38個のエージェント・アシスタント系プラグインをすべて数えています。AI Agentガイドでは、実際の実行10件をプロンプトとあわせて紹介しています。PyQGISでは、チャットボットが書いたコードが1回で動く割合を測っています。より広い分野の比較は、QGIS AIのハブにまとめています。


