Aller au contenu principal
Version: 1.1.3

Installer le MCP QGIS

Le MCP QGIS connecte un assistant IA (Claude, ChatGPT via clients compatibles, Cursor, etc.) directement à QGIS Desktop. Vous décrivez ce que vous voulez en langage naturel — « charge ce GeoPackage et applique les styles », « sélectionne le stationnement payant de la rue X », « exporte une mise en page A3 » — et l'assistant le fait dans QGIS.

Configurations vérifiées le 9 juin 2026 (2026-06-09)

Les commandes et fichiers de configuration ci-dessous ont été vérifiés à cette date. Les clients IA évoluent vite : en cas d'écart, référez-vous au dépôt du serveur MCP (liens en bas de page).

Pourquoi le MCP, et pourquoi c'est important​

QGIS est puissant mais dense : des centaines de menus, d'algorithmes de traitement et d'options de style. Le MCP transforme cette complexité en conversation.

  • Accélération : charger un dataset, appliquer un style .qml, lancer un traitement ou bâtir une carte se fait en une phrase, sans chercher dans les menus ni écrire du PyQGIS à la main.
  • Onboarding : un nouvel utilisateur devient productif immédiatement — l'assistant connaît QGIS à sa place.
  • Tâches répétitives : les manipulations fastidieuses (jointures, filtres, exports en série) sont déléguées.
  • Couplé à notre documentation : associez le MCP à notre assistant IA et à nos fichiers llms.txt — l'assistant connaît alors le schéma de vos données CartograFit et sait exactement quels champs manipuler.

En clair : le MCP fait passer QGIS d'un outil que l'on pilote à la souris à un outil que l'on pilote à la voix de votre assistant. C'est un gain de temps considérable sur l'exploration et la préparation de données.

Prérequis​

  • QGIS 3.28 ou plus récent (compatible jusqu'aux versions 4.x).
  • uv — le gestionnaire de paquets Python qui fournit la commande uvx.
  • Un client IA compatible MCP (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex CLI, Gemini CLI…).

Étape 1 — Installer le plugin QGIS​

Le plugin crée un petit serveur à l'intérieur de QGIS (socket TCP, port 9876 par défaut) auquel le client IA se connecte.

  1. Ouvrez QGIS.
  2. Menu Extensions → Installer/Gérer les extensions.
  3. Cherchez QGIS MCP, installez l'extension, puis redémarrez QGIS.
  4. Ouvrez le panneau QGIS MCP et cliquez sur Start Server.
Installation alternative (dépôt source)

Vous pouvez aussi cloner le dépôt et lancer le script d'installation, qui pose le plugin et configure votre client automatiquement :

git clone https://github.com/nkarasiak/qgis-mcp.git
cd qgis-mcp
python install.py

Options utiles : --clients claude-desktop,cursor, --profile <profil QGIS>, --uninstall.

Étape 2 — Connecter votre assistant IA​

Le serveur MCP se lance via uvx (fourni par uv). Choisissez la procédure correspondant à votre client.

Claude Code​

claude mcp add -s user qgis -- uvx --from git+https://github.com/nkarasiak/qgis-mcp qgis-mcp-server

Claude Desktop · Cursor · VS Code · Windsurf​

Ajoutez ce bloc au fichier de configuration MCP de votre client :

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/nkarasiak/qgis-mcp",
        "qgis-mcp-server"
      ]
    }
  }
}

Emplacement du fichier Claude Desktop : ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows).

Codex CLI​

codex mcp add qgis -- uvx --from git+https://github.com/nkarasiak/qgis-mcp qgis-mcp-server

Gemini CLI​

Dans ~/.gemini/settings.json :

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nkarasiak/qgis-mcp", "qgis-mcp-server"]
    }
  }
}

Variables d'environnement (optionnel)​

VariableDéfautRôle
QGIS_MCP_PORT9876Port du socket QGIS
QGIS_MCP_HOSTlocalhostHôte du socket
QGIS_MCP_TOOL_MODEgranulargranular (jeu d'outils détaillé) ou compound (jeu condensé)

Étape 3 — Vérifier la connexion​

  1. QGIS ouvert, plugin Start Server actif.
  2. Démarrez (ou redémarrez) votre client IA — il doit afficher les outils QGIS.
  3. Demandez par exemple : « Pingue QGIS » ou « Donne-moi les infos de l'installation QGIS ».

Exemple de flux CartograFit​

Une fois connecté, un cas d'usage typique :

  1. Téléchargez un dataset GeoPackage depuis la plateforme (voir Télécharger vos données).
  2. « Charge ce fichier .gpkg et applique les styles intégrés. »
  3. « Sélectionne les zones de stationnement payant le long de la rue X. »
  4. « Croise la couche stationnement avec mes propres données et exporte une mise en page A3 prête à imprimer. »

L'assistant enchaîne le chargement, le stylage, le filtrage et l'export — pendant que vous gardez la main sur le résultat.

Sécurité

Le MCP QGIS peut exécuter du code PyQGIS arbitraire en local pour piloter QGIS. Ne connectez que des clients IA de confiance, et gardez le serveur arrêté quand vous ne l'utilisez pas.

Sources​

✉️Besoin d'aide pour connecter QGIS ?