QGIS MCP : installation, limites et alternative simple
Publié le Mis à jour 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, en même temps sur le même ordinateur, chacun dans un projet QGIS vierge : « À Lyon, en France, trouve les écoles à moins de 300 mètres d’un arrêt de tram, montre-les sur une carte avec les lignes de tram, et dis-moi combien il y en a. »
| QGIS MCP, avec Claude Code | AI Agent | |
|---|---|---|
| Temps jusqu’à la réponse | 9 min 28 s | 5 min 35 s |
| Étapes | 10, dont 6 en code Python | 40, dont 2 en code Python |
| Données utilisées | OpenStreetMap, téléchargées par du Python qu’il a écrit | Les couches officielles d’écoles, de collèges et de lycées de la Métropole de Lyon, plus les arrêts et les voies de tram d’OpenStreetMap |
| Écoles comptées | 87 | 80 (52 écoles primaires, 14 collèges, 14 lycées) |
Les décomptes diffèrent parce que les deux outils ont utilisé des données différentes. QGIS MCP a compté les écoles OpenStreetMap proches d’arrêts de tram pris dans un rectangle autour de Lyon : quelques arrêts juste en dehors de la ville comptent donc aussi, et il a lui-même précisé que les 87 n’étaient pas dédoublonnés. AI Agent a utilisé les registres officiels des écoles de la ville et le périmètre de la commune de Lyon.
La manière d’y arriver est la différence la plus marquante. QGIS MCP n’a aucun outil de données : le modèle a donc écrit du Python pour interroger les serveurs Overpass d’OpenStreetMap. Ils ont répondu par des erreurs (406, 504, puis 502 deux fois), et il a réessayé. Ce Python s’exécutait dans le fil principal de QGIS, qui est donc resté gelé environ sept minutes, et la carte est restée vide jusqu’à 7 min 22 s.

AI Agent a d’abord cherché dans son catalogue de données et chargé les couches officielles d’écoles de la ville. Quand le flux national de transport en commun ne nommait pas les trams de Lyon, il est passé à OpenStreetMap pour les arrêts et les voies de tram. Il a écrit du Python deux fois, pour mesurer la distance de chaque école à son arrêt le plus proche.

Trois autres tâches, dont une où QGIS MCP a été plus rapide
Une course ne prouve pas grand-chose, j’ai donc chronométré trois autres tâches de la même façon. Elles ne tournent pas toutes à notre avantage :
| Tâche | QGIS MCP, avec Claude Code | AI Agent |
|---|---|---|
| Bâtiments du centre historique de Porto par type, sur un fond de carte satellite | 1 min 44 s | 1 min 21 s |
| La même tâche, plus une mise en page PDF A4 avec titre, légende, barre d’échelle et flèche du nord | 2 min 48 s | 5 min 26 s |
| Bâtiments de York exposés au risque d’inondation fluviale, avec les données de l’Environment Agency | Pas terminé après 15 min, rien sur la carte | Pas terminé après 15 min, une partie des données d’inondation chargée, aucun décompte |
Quand les données sont à un téléchargement OpenStreetMap de distance, QGIS MCP suit le rythme, et sur la mise en page PDF il a été environ deux fois plus rapide. Sa propre réponse prévenait qu’il avait exporté le PDF sans vérifier que les tuiles satellite étaient chargées. L’écart se creuse quand le modèle doit trouver et télécharger lui-même les données, comme à Lyon. Aucun des deux outils n’a terminé la tâche d’inondation à York en 15 minutes. Un premier essai à Porto, le 26 septembre, a pris 8 min 29 s à QGIS MCP parce que les serveurs de téléchargement étaient surchargés ce jour-là, j’ai donc tout chronométré de nouveau.
Comment nous avons mesuré. Même ordinateur, les deux outils lancés en même temps, QGIS 3.44.15, projet vierge et réglages par défaut, sauf l’effort d’AI Agent, réglé sur Medium. Une exécution chacun, sans nouvel essai : QGIS MCP 0.15.2 piloté par Claude Code sur Claude Sonnet 5.5 avec seulement les outils QGIS autorisés, et AI Agent 1.9.0 en mode Balanced. Le temps de QGIS MCP est la durée d’exécution de Claude Code elle-même, qui laisse de côté les 52 secondes mises par le client à démarrer. L’ordinateur était très chargé et les serveurs OpenStreetMap échouaient pour les deux outils pendant la course de Lyon. Nous avons filmé chaque 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.
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 du test de Lyon, 6 de ses 10 étapes étaient du Python, et les téléchargements ont gelé QGIS pendant environ sept minutes.
- 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.
Autres façons de connecter Claude à QGIS
Le plugin présenté plus haut est celui dont parlent la plupart des guides, mais trois autres projets mettent aussi Claude dans QGIS. Lus sur leurs propres pages le 23 octobre 2026 :
- piatkowski/qgis-mcp : un projet distinct portant le même nom, conçu pour Claude Desktop. Il s’installe depuis un ZIP de sa page de versions GitHub, pas depuis le gestionnaire d’extensions, exige Python 3.12 ou ultérieur pour son serveur, et écoute sur le port 9876 dès que le plugin est activé. Le plugin présenté plus haut utilise lui aussi le port 9876 : n’en lancez donc qu’un à la fois.
- ClaudIA QGIS : dérivé du plugin présenté plus haut, avec le port local remplacé par une connexion HTTPS à la communauté agrônomo10X, donc sans Python à installer. Il demande un compte agrônomo10X, et sa version 0.2.3 du 15 septembre 2026 est marquée expérimentale.
- QGIS Agent : un panneau de chat dans QGIS avec votre propre clé LLM, et un serveur MCP local facultatif que Claude Desktop ou Cursor peuvent piloter.
Une alternative à QGIS MCP : 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. Sur les benchmarks GeoKTools et GeoExpertQueries de Google, Claude Sonnet 5.5 pilotant QGIS avec ce plugin MCP (version 0.15.1, dans Claude Code) a obtenu 24,9 sur 100 sur 41 questions mises de côté, et AI Agent en effort Low (GPT-6 Luna) 43,8 (les résultats du benchmark).
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 190 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 Pro gratuitement pendant 7 jours : ajoutez une carte bancaire, annulez avant la fin et rien n'est facturé.
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 | 190 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 tâche de Lyon, AI Agent a répondu en 5 min 35 s à partir des couches d’écoles officielles de la ville. QGIS MCP a pris 9 min 28 s et a écrit du Python pour 6 de ses 10 étapes. Sur des tâches plus simples, l’écart se réduit, et sur une mise en page PDF QGIS MCP a été plus rapide.
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
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.
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.
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.
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.
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.
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, 190 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.
À lire ensuiteClaude et QGIS : 3 façons de les connecter, testées sur une même tâche
Faites-le dans QGIS en le demandant
AI Agent réalise la tâche que vous décrivez, dans votre propre projet QGIS. Gratuit, sans carte bancaire.


