Aller au contenu
AI Agent
QGIS
Guide

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.

Deux rangées comparent les architectures. Rangée du haut, QGIS MCP, quatre éléments à installer, configurer et démarrer : un client IA comme Claude Desktop, Claude Code ou Cursor, avec son propre abonnement, qui parle en stdio à un serveur MCP, un processus Python lancé via uv avec uvx qgis-mcp-server, qui parle en TCP sur le port 9876 au plugin QGIS MCP, un serveur de socket dans QGIS où l’on clique sur Run MCP à chaque session, lequel pilote votre projet QGIS. Rangée du bas, AI Agent, un seul plugin : le panneau AI Agent ancré dans QGIS, installé depuis le gestionnaire d’extensions, qui voit les couches, les champs, le SCR, l’emprise et la sélection, et parle en HTTPS à un service d’agent qui fait tourner le modèle en Europe, sans clé API ni appli cliente, lequel pilote votre projet QGIS.
En haut : les quatre éléments dont QGIS MCP a besoin en même temps. En bas : un plugin d’agent qui vit dans QGIS, ici le nôtre.

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 :

  1. Un client MCP : l’appli d’IA dans laquelle vous écrivez, comme Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI ou Gemini CLI.
  2. 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’abord uv.
  3. 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.
  4. 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érequisPourquoiCoût
QGIS 3.28 ou plus récentVersion minimale du pluginGratuit
Une appli cliente MCPL’endroit où vous discutez avec le modèleOffre gratuite avec limites quotidiennes, ou abonnement payant
uv (lanceur de paquets Python)Démarre le serveur MCPGratuit, une commande à taper dans un terminal
Une commande de terminal ou une ligne dans un fichier de configurationIndique au client où se trouve le serveurGratuit, mais à la main
Le plugin QGIS MCPLe côté QGIS du pontGratuit

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

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

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

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

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

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

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

À gauche : la page de QGIS MCP 0.15.0 dans le gestionnaire d’extensions de QGIS, par Nicolas Karasiak, 387 votes et 52 575 téléchargements, avec une description indiquant que le plugin n’est qu’une moitié de l’installation et qu’il faut aussi le serveur MCP qgis-mcp. À droite : la fenêtre Setup and Configurator du plugin avec claude-code sélectionné comme client, l’état Server running on port 9876 et une commande à lancer dans votre terminal, qui commence par claude mcp add.
La page du plugin et son Configurator. Le côté QGIS est rapide ; le reste se passe dans un terminal et dans une autre appli.

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 CodeAI Agent
Temps jusqu’à la réponse9 min 28 s5 min 35 s
Étapes10, dont 6 en code Python40, dont 2 en code Python
Données utiliséesOpenStreetMap, téléchargées par du Python qu’il a écritLes 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ées8780 (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.

QGIS après l’exécution de QGIS MCP à Lyon : des points rouges pour les écoles à moins de 300 m d’un arrêt de tram, des lignes de tram bleues et des arrêts de tram gris sur fond blanc, sans fond de carte. Le panneau Couches liste schools_within_300m, tram_lines, tram_stops et une couche schools_all masquée.
QGIS MCP avec Claude Code : 9 min 28 s, 87 écoles, chaque téléchargement écrit en Python.

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.

QGIS avec le panneau AI Agent à droite. La carte montre le contour de la commune de Lyon, les voies de tram et les écoles à moins de 300 m d’un arrêt, étiquetées par nom et colorées en écoles primaires, collèges et lycées. La réponse de l’agent affiche une fiche de statistiques avec 80 écoles (52 primaires, 14 collèges, 14 lycées) et des distances à l’arrêt le plus proche de 14,6 à 297,2 m, puis ses sources : les écoles de la Métropole de Lyon, les arrêts et les voies de tram d’OpenStreetMap, le périmètre de Lyon et un extrait GTFS.
AI Agent : 5 min 35 s, 80 écoles, à partir des couches d’écoles de la ville.

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âcheQGIS MCP, avec Claude CodeAI Agent
Bâtiments du centre historique de Porto par type, sur un fond de carte satellite1 min 44 s1 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 nord2 min 48 s5 min 26 s
Bâtiments de York exposés au risque d’inondation fluviale, avec les données de l’Environment AgencyPas terminé après 15 min, rien sur la cartePas 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 refused et ModuleNotFoundError comme 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_code exé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 MCPAI Agent
Où vous discutezUne appli extérieure (Claude Desktop, Cursor, Claude Code)Un panneau dans QGIS
Ce que vous installezLe plugin, uv, un client MCP, une entrée de configurationUn seul plugin
À chaque sessionDémarrer le serveur dans QGIS, garder les deux applis ouvertesOuvrir le panneau
ModèleCelui de votre client, avec votre abonnementInclus
Catalogue de données ouvertesNon190 sources
Exécute du PythonOui, sans demander par défautDemande avant le code qui modifie le projet
Annuler toute une demandeNonOui, en un clic
PrixPlugin gratuit, plus votre abonnement d’IAOffre gratuite, puis Pro à 49 € par mois
Idéal pourLes développeurs qui travaillent déjà dans Claude Code ou CursorLes 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

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.

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.

Essayer AI Agent gratuitement

À lire ensuite