コンテンツへスキップ
AI Agent
QGIS
ガイド

QGIS MCPとは?設定方法・制限・簡単な代替手段

公開日 更新日

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

2つの構成を上下に比較した図。上段のQGIS MCPは、インストール、設定、起動が必要な4つの部品で構成される。Claude Desktop、Claude Code、Cursorなど独自のプランを持つAIクライアントが、stdioでMCPサーバー(uvのuvx qgis-mcp-serverで起動するPythonプロセス)と通信し、MCPサーバーがTCPポート9876でQGIS MCPプラグイン(QGIS内のソケットサーバーで、セッションのたびに「Run MCP」をクリックする)と通信し、プラグインがQGISプロジェクトを操作する。下段のAI Agentはプラグイン1つで構成される。QGISにドッキングしたAI Agentパネル(プラグインマネージャからインストール)がレイヤ、フィールド、CRS、領域、選択範囲を把握し、HTTPSでエージェントサービス(EU内でモデルを実行、APIキーもクライアントアプリも不要)と通信し、QGISプロジェクトを操作する。
上:QGIS MCPで同時に動かす必要がある4つの部品。下:QGIS内で動くエージェントプラグイン(ここでは当社のもの)。

アイデアは優れていて、プラグインもよくできています。公式の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つを、同時にインストールして動かす必要があります。

  1. MCPクライアント:入力を行うAIアプリ。Claude Desktop、Claude Code、Cursor、VS Code、Codex CLI、Gemini CLIなどです。
  2. MCPサーバー:クライアントがバックグラウンドで起動する小さなPythonプログラム。Pythonプログラムをインストールして実行するツールuvを介して起動するので、先にuvを入れておきます。
  3. QGIS MCPプラグイン:QGIS内で、ローカルのネットワークポート(9876番)にコマンドが届くのを待ち受けます。ツールバーのボタンからRun MCPをクリックして起動します。
  4. 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サーバーも必要です。」

  1. プラグインをインストールする

    「プラグイン」→「プラグインの管理とインストール」を開き、QGIS MCPを検索して「プラグインをインストール」をクリックします。ここは簡単で、再起動なしで2.7秒で読み込まれました。

  2. uvをインストールする

    サーバーはuvを通じて動きますが、WindowsにもmacOSにも標準では入っていません。ターミナルでコマンドを1つ実行してインストールします。

  3. MCPクライアントを用意する

    Claude Code、Claude Desktop、Cursor、Codex、Gemini CLI、またはMCPに対応したほかのアプリです。アカウントとプランはそのアプリごとに必要です。

  4. クライアントをQGISにつなぐ

    プラグインのConfiguratorに、ターミナルに貼り付けるコマンドが表示されます。たとえばclaude mcp add -s user qgis -- uvx ... qgis-mcp-serverのようなものです。クライアントによっては、設定ファイルに1行追加する方式になります。

  5. QGISでサーバーを起動する

    プラグインのツールバーボタンからRun MCPをクリックします。起動時、QGISのログに「Token authentication disabled (open)」と記録されます。

  6. 最初のメッセージを送る

    最初の呼び出しで約90MBのサーバーをダウンロードしてから接続します。今回のテストでは16秒かかり、クライアントにはQGISのツールが125個見えていました。

下のスクリーンショットのConfiguratorで、使うクライアントを選び、ターミナル用のコマンドをコピーします。

左:Nicolas Karasiak作のQGIS MCP 0.15.0のプラグインマネージャのページ。387票、ダウンロード52,575回。説明には、このプラグインはセットアップの半分にすぎず、qgis-mcp MCPサーバーも必要と書かれている。右:プラグインのSetup and Configuratorウィンドウ。クライアントにclaude-codeを選択し、ステータスはServer running on port 9876、その下にclaude mcp addで始まるターミナル用コマンドが表示されている。
プラグインのページとConfigurator。QGIS側は短時間で終わり、残りはターミナルと別のアプリで行います。

今回の所要時間は約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秒まで空のままでした。

QGIS MCPの実行後のリヨンのQGIS。トラム停留所から300 m以内の学校が赤い点、トラムの線路が青い線、トラム停留所が灰色の点で、白い背景に表示され、ベースマップはない。レイヤパネルには、schools_within_300m、tram_lines、tram_stops、非表示のschools_allレイヤが並んでいる。
Claude CodeでのQGIS MCP:9分28秒、学校87校、ダウンロードはすべてPythonで記述。

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

右側にAI Agentパネルを開いたQGIS。地図にはリヨン市の輪郭、トラムの線路、停留所から300 m以内の学校が表示され、学校名のラベルが付き、小学校、中学校、高校で色分けされている。エージェントの回答には、学校80校(小学校52校、中学校14校、高校14校)と、最寄りの停留所までの距離14.6〜297.2 mを示す統計カードがあり、その下に情報源として、Métropole de Lyonの学校、OpenStreetMapのトラム停留所と線路、リヨンの境界、GTFSの抜粋が並んでいる。
AI Agent:5分35秒、学校80校、市自身の学校レイヤを使用。

ほかの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でAI Agentを無料で試す。カード不要

QGIS MCPとQGIS内のエージェントの比較

QGIS MCPAI 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回で戻せる機能が含まれています。

よくある質問

QGISのAIエージェントとはでは、MCPブリッジも含め、公式リポジトリにある38個のエージェント・アシスタント系プラグインをすべて数えています。AI Agentガイドでは、実際の実行10件をプロンプトとあわせて紹介しています。PyQGISでは、チャットボットが書いたコードが1回で動く割合を測っています。より広い分野の比較は、QGIS AIのハブにまとめています。

QGISでの作業は、頼むだけで完了

AI Agentが、あなたのQGISプロジェクト上で、指示したタスクを実行します。無料、カード不要。

AI Agentを無料で試す
作成者Yvann Barbot
·3 min read

関連記事

並べて書き出した2枚のA4印刷レイアウト。左はチャットボットの最初の回答で、空の地図フレームの周りにタイトル、凡例、方位記号があり、「エラーなしで実行されたが、地図フレームは空」という文字が添えられている。右はAI Agentによるアヌシーの学校のレイアウトで、地区、色分けされた学校、凡例、縮尺バーがあり、「メッセージ1回」という文字が添えられている。
AI AgentQGISガイド

QGISでChatGPTは使える?3つの実タスクで検証

ChatGPTはPyQGISコードを書けますが、プロジェクトを見られないため推測で動きます。3つの実タスクで全スクリプトをQGISで実行し、エラーなしで空の地図が出た理由と対処法をまとめました。

Yvann BarbotYvann Barbot
·