QGIS MCP : installation, limites et alternative simple
Publié le
QGIS MCP est un plugin QGIS gratuit, associé à un petit programme sur votre ordinateur, qui permet à une appli d’IA extérieure à QGIS, le plus souvent Claude Desktop ou Claude Code, de piloter QGIS. Vous écrivez dans l’appli d’IA, elle envoie des commandes à QGIS par une connexion locale, et QGIS les exécute : charger des couches, lancer des outils de traitement, styler la carte ou exécuter du code Python.
L’idée est bonne et le plugin est soigné. Nicolas Karasiak maintient la version du dépôt officiel de QGIS, qui comptait 52 575 téléchargements le 26 septembre 2026. Ce que les tutoriels passent sous silence : tout ce qu’il faut pour le faire fonctionner, et là où il s’arrête. Je l’ai installé de zéro, puis j’ai confié la même tâche à QGIS MCP et à un agent qui vit dans QGIS. Nous développons ce second outil, AI Agent : gardez-le en tête en lisant mes conclusions.
Qu’est-ce que MCP, en un paragraphe
MCP, le Model Context Protocol, est un standard ouvert lancé par Anthropic qui permet aux applis d’IA d’utiliser des outils extérieurs. L’introduction officielle le décrit comme « un port USB-C pour les applications d’IA ». L’appli d’IA s’appelle le client. Un serveur lui propose des outils. QGIS MCP est un serveur dont les outils sont des actions QGIS. Le protocole énonce le risque sans détour : « Les outils représentent de l’exécution de code arbitraire et doivent être traités avec la plus grande prudence. »
Comment fonctionne QGIS MCP
Quatre éléments doivent être installés et actifs en même temps :
- Un client MCP : l’appli d’IA dans laquelle vous écrivez, comme Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI ou Gemini CLI.
- Le serveur MCP : un petit programme Python que le client lance en arrière-plan avec
uv, un outil qui installe et exécute des programmes Python. Vous installez d’aborduv. - Le plugin QGIS MCP : dans QGIS, il écoute les commandes sur un port réseau local, le 9876. Vous cliquez sur Run MCP dans le bouton de sa barre d’outils pour le démarrer.
- QGIS lui-même, avec votre projet ouvert.
Quand vous écrivez une demande, le modèle d’IA choisit un outil QGIS, le serveur transmet l’appel au plugin, et le plugin l’exécute dans QGIS puis renvoie le résultat. Le modèle ne voit pas votre écran. Il ne voit la carte que lorsqu’il demande une image à QGIS.
Ce qu’il faut avant de commencer
| Prérequis | Pourquoi | Coût |
|---|---|---|
| QGIS 3.28 ou plus récent | Version minimale du plugin | Gratuit |
| Une appli cliente MCP | L’endroit où vous discutez avec le modèle | Offre gratuite avec limites quotidiennes, ou abonnement payant |
uv (lanceur de paquets Python) | Démarre le serveur MCP | Gratuit, une commande à taper dans un terminal |
| Une commande de terminal ou une ligne dans un fichier de configuration | Indique au client où se trouve le serveur | Gratuit, mais à la main |
| Le plugin QGIS MCP | Le côté QGIS du pont | Gratuit |
Un guide d’installation très lu affirme qu’il faut un compte Claude Pro payant. Ce n’est pas vrai. La documentation d’Anthropic sur les serveurs MCP locaux ne cite aucune offre, et un blogueur SIG a fait tourner QGIS MCP avec l’offre gratuite de Claude en août 2026, en butant seulement sur la limite quotidienne de messages. ChatGPT est plus compliqué. Le centre d’aide d’OpenAI indique qu’il ne se connecte qu’à des serveurs MCP situés sur Internet, pas à un serveur sur votre ordinateur, et que le mode développeur nécessaire est réservé aux offres payantes.
Installer QGIS MCP, chronomètre en main
J’ai installé QGIS MCP 0.15.0 sur QGIS 3.44 le 26 septembre 2026 en notant chaque étape. La page du plugin est franche sur ce point : « Ce plugin n’est qu’une moitié de l’installation. Il vous faut aussi le serveur MCP qgis-mcp, que votre client MCP exécute pour communiquer avec QGIS. »
Installer le plugin
Extensions > Installer/Gérer les extensions, recherchez QGIS MCP, puis Installer l’extension. Cette étape est rapide : il s’est chargé en 2,7 secondes, sans redémarrage.
Installer uv
Le serveur tourne grâce à uv, que Windows et macOS ne fournissent pas. Vous l’installez avec une seule commande dans un terminal.
Choisir un client MCP
Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI ou une autre appli compatible MCP, avec son propre compte et son offre.
Connecter le client à QGIS
Le Configurator du plugin affiche une commande à coller dans votre terminal, par exemple claude mcp add -s user qgis -- uvx ... qgis-mcp-server. Certains clients demandent plutôt d’ajouter une ligne dans un fichier de paramètres.
Démarrer le serveur dans QGIS
Cliquez sur Run MCP dans le bouton de barre d’outils du plugin. QGIS écrit « Token authentication disabled (open) » dans ses journaux au démarrage.
Envoyer un premier message
Le premier appel télécharge le serveur, environ 90 MB, puis se connecte. Cela a pris 16 secondes lors de mon test, et le client a vu 125 outils QGIS.
Le Configurator, sur la capture ci-dessous, est l’endroit où l’on choisit son client et où l’on copie la commande du terminal.
Mon essai a duré environ trois minutes, mais uv et un client étaient déjà installés et un script faisait les clics. La première fois, il faut aussi lire la documentation, installer uv et un client, puis taper la commande.
Une partie revient chaque jour. Après un redémarrage de QGIS, le serveur reste arrêté sauf si vous cochez le démarrage automatique dans le Configurator. L’appli d’IA affiche alors seulement « Error executing tool ping », et c’est à vous de deviner qu’il faut recliquer sur Run MCP.
La même tâche, des deux façons
J’ai donné la même demande aux deux outils, dans un projet QGIS vierge : « Charge les bâtiments du centre historique de Porto, au Portugal, depuis OpenStreetMap, colore-les par type de bâtiment, ajoute un fond de carte satellite en dessous et dis-moi combien il y a de bâtiments. »
| QGIS MCP, avec Claude Code | AI Agent | |
|---|---|---|
| Temps jusqu’à la réponse | 8 min 29 s | 1 min 11 s |
| Actions | 28, dont 17 en code Python | 15, aucune en Python |
| Zone utilisée | Un rectangle qu’il a dessiné, qui englobe aussi la rive d’en face | Le périmètre du centre historique cartographié dans OpenStreetMap |
| Bâtiments comptés | 4 445 | 1 914 |
| Décompte vérifié à la main | Correct pour son rectangle | Correct pour le périmètre |
Les deux décomptes sont justes pour la zone que chaque outil a choisie, ce qui explique l’écart. Ce qui diffère, c’est la manière d’y arriver. QGIS MCP n’a aucun outil de données : le modèle a donc écrit du code Python pour télécharger les données OpenStreetMap. Quand les serveurs de téléchargement étaient lents, ses nouvelles tentatives ont gelé QGIS jusqu’à une minute d’affilée. À sa décharge, il a repéré lui-même un bug qui avait fait perdre 37 bâtiments, et l’a corrigé.
AI Agent a utilisé son outil OpenStreetMap intégré, a cherché le vrai périmètre du centre historique, y a découpé les bâtiments et leur a appliqué un style, sans écrire de code. Son fond de carte satellite est moins net à ce niveau de zoom que celui choisi par QGIS MCP.
Comment nous avons mesuré. Même ordinateur, QGIS 3.44.7, même demande, projet vierge et réglages par défaut, avec QGIS MCP 0.15.0 piloté par Claude Code sur Claude Sonnet, et AI Agent 1.4.1. Nous avons vérifié nous-mêmes les deux décomptes, par rapport à OpenStreetMap pour le rectangle et en comptant la couche finale pour le périmètre. Les serveurs de téléchargement étaient surchargés pendant l’essai de QGIS MCP, ce qui lui a coûté du temps, et une première tentative d’AI Agent a fait planter QGIS, un bug que nous avons consigné : ses chiffres viennent donc de la seconde exécution.
Vous pouvez envoyer la même demande dans votre propre QGIS en quelques minutes : installez le plugin, connectez-vous et collez-la dans le panneau.
Essayez AI Agent gratuitement dans QGIS, sans carte bancaire
Les limites de QGIS MCP
Voici les limites que j’ai rencontrées ou trouvées documentées, chacune avec sa source :
- Le chat est hors de QGIS. Vous passez d’une fenêtre à l’autre. Le modèle travaille à partir des résultats des outils et ne voit la carte que s’il demande une image à QGIS.
- Quatre pièces mobiles. Quand rien ne se passe, la panne peut venir des paramètres du client, de
uv, du serveur, du port ou du plugin. La page de dépannage du projet cite « No response from QGIS »,Connection refusedetModuleNotFoundErrorcomme erreurs habituelles. - Un piège sous Windows. Le README prévient que Claude Desktop installé depuis le Microsoft Store exécute les serveurs dans un bac à sable qui casse l’installation habituelle : une configuration qui marche ailleurs échoue donc ici.
- Du Python quelconque, sans mot de passe par défaut. L’outil
execute_codeexécute n’importe quel PyQGIS (le code Python de QGIS) écrit par le modèle. Le README le dit : « Par défaut, le socket n’a aucune authentification… tout processus de la machine qui peut atteindre le port peut piloter QGIS (y compris execute_code, qui exécute du PyQGIS arbitraire). » Un fork, QGIS Agent MCP, existe surtout pour retirer cet outil. - Aucune donnée en propre. Il pilote QGIS, mais trouver et télécharger les données revient au modèle, le plus souvent en écrivant du Python. Lors de mon test, 17 de ses 28 actions étaient du Python, et ses nouvelles tentatives de téléchargement ont gelé QGIS pendant 40 à 62 secondes d’affilée.
- Pas d’annulation pour toute une demande. L’annulation de QGIS couvre les modifications, pas les couches ajoutées ni les fichiers écrits.
- La copie la plus étoilée n’est pas celle qui est maintenue. L’original sur GitHub, jjsantos01/qgis_mcp, compte 1 099 étoiles, n’a reçu aucune modification de code depuis le 1er octobre 2025 et affiche un ticket ouvert intitulé « Broken plugin for QGIS version 4.01 ». La version maintenue, nkarasiak/qgis-mcp, est celle du dépôt de plugins QGIS.
Ce que le web raconte de travers
« Il faut Claude Pro. » Les serveurs MCP locaux fonctionnent avec l’offre gratuite de Claude, dans la limite de ses plafonds quotidiens. Le verrou de l’offre payante concerne ChatGPT, qui ne peut de toute façon pas joindre directement un serveur sur votre ordinateur.
« Redémarrez votre ordinateur après avoir modifié la configuration. » Il suffit de redémarrer l’appli cliente. Sous Windows, vérifiez qu’elle est bien fermée, car elle continue de tourner dans la zone de notification.
« Installez le dépôt qui a le plus d’étoiles. » Installez plutôt depuis le gestionnaire d’extensions de QGIS, qui vous donne la version maintenue.
L’option plus simple : un agent dans QGIS
Nous développons AI Agent : cette section parle donc de notre propre plugin. Il fait le même travail que QGIS MCP depuis l’intérieur de QGIS : le chat est un panneau ancré à côté de votre carte, et le modèle est fourni avec le plugin.
Les différences qui comptent au quotidien :
- Une seule installation. Extensions > Installer/Gérer les extensions, recherchez AI Agent by TerraLab, installez, connectez-vous. Pas de
uv, pas de fichier de configuration, pas d’appli séparée, pas de serveur à démarrer à chaque session. - Il voit votre projet. Les noms de couches, les champs, le SCR, l’emprise et la sélection accompagnent chaque demande, et il génère un rendu de la carte pour vérifier son propre travail.
- Les données sont intégrées. Un catalogue de 55 sources de données ouvertes, d’OpenStreetMap à Sentinel-2 et aux agences cartographiques nationales : le modèle n’a pas à écrire de code de téléchargement.
- Il demande d’abord. Avec le réglage par défaut, il s’arrête avant de supprimer ou d’écraser, et le code Python qui modifie votre projet exige toujours votre clic.
- Annulation par message. Chaque message laisse un point de restauration, et un clic ramène le projet à cet état.
Il faut une connexion Internet, et il envoie à un service hébergé dans l’UE une description de votre projet, jamais vos fichiers de données. Il existe une offre gratuite sans carte bancaire, et un message compte pour une exécution, quel que soit le nombre d’étapes.
Essayez AI Agent gratuitement dans QGIS, sans carte bancaire
QGIS MCP ou agent dans QGIS : le comparatif
| QGIS MCP | AI Agent | |
|---|---|---|
| Où vous discutez | Une appli extérieure (Claude Desktop, Cursor, Claude Code) | Un panneau dans QGIS |
| Ce que vous installez | Le plugin, uv, un client MCP, une entrée de configuration | Un seul plugin |
| À chaque session | Démarrer le serveur dans QGIS, garder les deux applis ouvertes | Ouvrir le panneau |
| Modèle | Celui de votre client, avec votre abonnement | Inclus |
| Catalogue de données ouvertes | Non | 55 sources |
| Exécute du Python | Oui, sans demander par défaut | Demande avant le code qui modifie le projet |
| Annuler toute une demande | Non | Oui, en un clic |
| Prix | Plugin gratuit, plus votre abonnement d’IA | Offre gratuite, puis Pro à 49 € par mois |
| Idéal pour | Les développeurs qui travaillent déjà dans Claude Code ou Cursor | Les utilisateurs de SIG qui veulent le résultat dans QGIS |
Lequel choisir ?
Si vous travaillez déjà dans Claude Code ou Cursor, si vous écrivez du Python et si vous voulez QGIS comme un outil de plus là-dedans, QGIS MCP convient bien, et il ne coûte rien de plus que l’abonnement d’IA que vous payez déjà. Si vous voulez décrire une tâche SIG et obtenir le résultat dans votre projet, sans terminal, sans uv ni seconde appli, un agent dans QGIS y arrive avec moins de choses à installer et à entretenir. C’est le cas de la plupart des utilisateurs de SIG que je connais.
À retenir
QGIS MCP relie une appli d’IA extérieure à QGIS, comme Claude Desktop, à QGIS par une connexion locale, de sorte que le modèle de l’appli puisse exécuter des outils QGIS et du Python.
Il faut quatre éléments actifs ensemble : l’appli cliente, uv et le serveur MCP, le plugin QGIS MCP avec son serveur démarré, et QGIS.
Le côté QGIS s’installe en quelques secondes. Le reste se passe hors de QGIS : installer uv, une appli d’IA, une commande de terminal, et recliquer sur Run MCP après chaque redémarrage.
Sur la même tâche à Porto, AI Agent a répondu en 1 min 11 s avec 15 actions et aucune ligne de code. QGIS MCP a pris 8 min 29 s et a écrit du Python pour 17 de ses 28 actions.
ChatGPT ne peut pas utiliser directement un serveur MCP local. L’offre gratuite de Claude fonctionne, dans la limite de ses plafonds quotidiens.
Un agent dans QGIS, comme AI Agent, fait le même travail depuis un seul plugin, avec le modèle, un catalogue de données et l’annulation en un clic inclus.
Questions fréquentes
Qu’est-ce que QGIS MCP ?
Un plugin QGIS et un serveur MCP local qui permettent à une appli d’IA de piloter QGIS grâce au Model Context Protocol. Vous discutez dans l’appli, le plus souvent Claude Desktop ou Claude Code, et le modèle appelle des outils QGIS : charger des couches, lancer des traitements, appliquer un style, générer le rendu de la carte et exécuter du Python.
Comment connecter Claude à QGIS ?
Installez le plugin QGIS MCP depuis le gestionnaire d’extensions et cliquez sur Run MCP, installez uv, puis ajoutez le serveur QGIS MCP au fichier de configuration de Claude Desktop, ou lancez la commande claude mcp add dans Claude Code, et redémarrez le client. Ou installez un plugin d’agent qui tourne dans QGIS avec son propre modèle, comme AI Agent, qui se passe de client, de uv et de configuration.
ChatGPT peut-il utiliser QGIS MCP ?
Pas directement. Le centre d’aide d’OpenAI indique que ChatGPT se connecte à des serveurs MCP situés sur Internet : un serveur sur votre ordinateur, comme QGIS MCP, exigerait donc un tunnel pour être joignable. Le mode développeur, requis par MCP, est réservé aux offres payantes de ChatGPT.
QGIS MCP est-il sûr ?
Il peut exécuter dans QGIS n’importe quel code Python écrit par le modèle, et par défaut le socket local n’a aucune authentification, comme l’indique son README. Utilisez-le sur une machine de confiance, définissez le jeton de secret partagé si d’autres personnes utilisent la machine, arrêtez le serveur quand vous avez fini et sauvegardez vos projets importants.
Pourquoi QGIS MCP ne se connecte-t-il pas ?
Les causes habituelles, d’après le guide de dépannage du projet : le serveur n’est pas démarré dans QGIS (Connection refused, cliquez sur Run MCP), uv n’est pas installé ou introuvable (ModuleNotFoundError), ou le port n’est pas le 9876. Après un redémarrage de QGIS, le serveur est de nouveau arrêté sauf si le démarrage automatique est coché. Sous Windows, une installation de Claude Desktop depuis le Microsoft Store demande la forme --directory de la configuration.
Existe-t-il une alternative à QGIS MCP ?
Oui. Les plugins d’agent tournent dans QGIS sous forme de panneau de chat, sans appli extérieure ni serveur local. Nous avons compté 38 plugins d’agent et d’assistant dans le dépôt officiel en septembre 2026. Le nôtre, AI Agent, inclut le modèle, 55 sources de données ouvertes et l’annulation en un clic, avec une offre gratuite.
Ce qu’est un agent IA dans QGIS recense les 38 plugins d’agent et d’assistant du dépôt officiel, ponts MCP compris. Le guide d’AI Agent présente dix exécutions réelles avec leurs prompts, et PyQGIS mesure la fréquence à laquelle le code écrit par un chatbot s’exécute du premier coup. Le hub QGIS IA compare l’ensemble du domaine.
