QGIS MCP: qué es, cómo configurarlo y alternativa

QGIS MCP es un plugin gratuito de QGIS más un pequeño programa en tu equipo que permiten que una app de IA externa a QGIS, normalmente Claude Desktop o Claude Code, controle QGIS. Escribes en la app de IA, ella envía órdenes a QGIS por una conexión local y QGIS las ejecuta: cargar capas, usar herramientas de Procesos, dar estilo al mapa o ejecutar código de Python.

Dos filas comparan arquitecturas. Fila superior, QGIS MCP, cuatro piezas que hay que instalar, configurar y arrancar: un cliente de IA como Claude Desktop, Claude Code o Cursor, con su propio plan, que habla por stdio con un servidor MCP, un proceso de Python lanzado con uv mediante uvx qgis-mcp-server, que habla por TCP en el puerto 9876 con el plugin QGIS MCP, un servidor de sockets dentro de QGIS donde haces clic en Run MCP en cada sesión, que maneja tu proyecto de QGIS. Fila inferior, AI Agent, un solo plugin: el panel de AI Agent acoplado en QGIS, instalado desde el administrador de complementos, que ve capas, campos, SRC, extensión y selección, y habla por HTTPS con un servicio de agente que ejecuta el modelo en la UE, sin clave de API ni app cliente, y que maneja tu proyecto de QGIS. — Arriba: las cuatro piezas que QGIS MCP necesita tener en marcha a la vez. Abajo: un plugin de agente que vive dentro de QGIS, en este caso el nuestro.

La idea es buena y el plugin está bien hecho. Nicolas Karasiak mantiene la versión del repositorio oficial de QGIS, que sumaba 52 575 descargas el 26 de septiembre de 2026. Lo que los tutoriales se saltan es cuánto cuesta ponerlo en marcha y dónde se queda corto. Lo configuré desde cero y luego di la misma tarea a QGIS MCP y a un agente que vive dentro de QGIS. Construimos ese segundo, AI Agent, así que lee mis conclusiones con eso en mente.

Qué es MCP, en un párrafo

MCP, el Model Context Protocol, es un estándar abierto impulsado por Anthropic que permite a las apps de IA usar herramientas externas. La introducción oficial lo describe como «un puerto USB-C para aplicaciones de IA». La app de IA es el cliente. Un servidor le ofrece herramientas. QGIS MCP es un servidor cuyas herramientas son acciones de QGIS. El propio protocolo advierte del riesgo: «Las herramientas representan ejecución de código arbitrario y deben tratarse con la debida precaución».

Cómo funciona QGIS MCP

Hay que instalar cuatro piezas y tenerlas en marcha al mismo tiempo:

Un cliente MCP: la app de IA donde escribes, como Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI o Gemini CLI.
El servidor MCP: un pequeño programa de Python que el cliente arranca en segundo plano con uv, una herramienta que instala y ejecuta programas de Python. Primero hay que instalar uv.
El plugin QGIS MCP: dentro de QGIS, escucha órdenes en un puerto de red local, el 9876. Lo arrancas con Run MCP en el botón de su barra de herramientas.
QGIS, con tu proyecto abierto.

Cuando escribes una petición, el modelo de IA elige una herramienta de QGIS, el servidor pasa la llamada al plugin, y el plugin la ejecuta en QGIS y devuelve el resultado. El modelo no ve tu pantalla. Solo ve el mapa cuando le pide a QGIS una imagen de él.

Qué necesitas antes de empezar

Requisito	Para qué sirve	Coste
QGIS 3.28 o posterior	Mínimo del plugin	Gratis
Una app cliente MCP	Donde chateas con el modelo	Plan gratuito con límites diarios, o un plan de pago
`uv` (ejecutor de paquetes de Python)	Arranca el servidor MCP	Gratis, un comando en el terminal para instalarlo
Un comando en el terminal o una línea en un archivo de configuración	Indica al cliente dónde está el servidor	Gratis, pero a mano
El plugin QGIS MCP	El lado de QGIS del puente	Gratis

Una guía de instalación muy leída dice que necesitas una cuenta de Claude Pro de pago. No es así. La documentación de Anthropic sobre servidores MCP locales no menciona ningún plan, y un bloguero SIG usó QGIS MCP con el plan gratuito de Claude en agosto de 2026, y solo chocó con el límite diario de mensajes. Con ChatGPT es más difícil. El centro de ayuda de OpenAI indica que solo se conecta a servidores MCP en internet, no a uno en tu equipo, y que el modo desarrollador que exige es para planes de pago.

Configurar QGIS MCP, con tiempos

Instalé QGIS MCP 0.15.0 en QGIS 3.44 el 26 de septiembre de 2026 y anoté cada paso. La página del propio plugin lo dice sin rodeos: «Este plugin es solo la mitad de la configuración. También necesitas el servidor MCP qgis-mcp, que tu cliente MCP ejecuta para comunicarse con QGIS».

Instala el plugin

Complementos > Administrar e instalar complementos, busca QGIS MCP y haz clic en Instalar complemento. Esta parte es rápida: se cargó en 2.7 segundos, sin reiniciar.

Instala uv

El servidor se ejecuta con uv, que Windows y macOS no incluyen. Se instala con un comando en el terminal.

Consigue un cliente MCP

Claude Code, Claude Desktop, Cursor, Codex, Gemini CLI u otra app que hable MCP, con su propia cuenta y su propio plan.

Conecta el cliente con QGIS

El Configurator del plugin muestra un comando para pegar en el terminal, como claude mcp add -s user qgis -- uvx ... qgis-mcp-server. Algunos clientes necesitan en cambio que añadas una línea a un archivo de configuración.

Arranca el servidor en QGIS

Haz clic en Run MCP en el botón del plugin de la barra de herramientas. Al arrancar, QGIS registra «Token authentication disabled (open)».

Envía un primer mensaje

La primera llamada descarga el servidor, unos 90 MB, y después se conecta. En mi prueba tardó 16 segundos y el cliente vio 125 herramientas de QGIS.

El Configurator de la captura siguiente es donde eliges tu cliente y copias el comando para el terminal.

Izquierda: la página del administrador de complementos de QGIS para QGIS MCP 0.15.0 de Nicolas Karasiak, con 387 votos y 52 575 descargas, y una descripción que dice que el plugin es solo la mitad de la configuración y que también hace falta el servidor MCP qgis-mcp. Derecha: la ventana Setup y Configurator del plugin con claude-code seleccionado como cliente, el estado Server running on port 9876 y un comando para ejecutar en el terminal que empieza por claude mcp add. — La página del plugin y su Configurator. El lado de QGIS es rápido; el resto ocurre en un terminal y en otra app.

Mi prueba duró unos tres minutos, pero uv y un cliente ya estaban instalados y un script hacía los clics. La primera vez, además, hay que leer la documentación, instalar uv y un cliente, y escribir el comando.

Una parte se repite cada día. Tras reiniciar QGIS, el servidor queda apagado salvo que marques el inicio automático en el Configurator. Entonces la app de IA solo responde «Error executing tool ping» y tienes que adivinar que la solución es volver a hacer clic en Run MCP.

La misma tarea, de las dos formas

Di la misma petición a ambas herramientas, en un proyecto de QGIS nuevo: «Carga los edificios del centro histórico de Oporto, Portugal, desde OpenStreetMap, coloréalos por tipo de edificio, añade debajo un mapa base de satélite y dime cuántos edificios hay».

	QGIS MCP, con Claude Code	AI Agent
Tiempo hasta la respuesta	8 min 29 s	1 min 11 s
Acciones	28, de las cuales 17 fueron código de Python	15, ninguna de Python
Zona que usó	Un rectángulo que dibujó, que incluye también la orilla al otro lado del río	El límite del centro histórico cartografiado en OpenStreetMap
Edificios contados	4445	1914
Recuento comprobado a mano	Correcto para su rectángulo	Correcto para el límite

Los dos recuentos son correctos para la zona que eligió cada herramienta, y por eso difieren. Lo que cambia es cómo llegaron. QGIS MCP no tiene una herramienta de datos, así que el modelo escribió Python para descargar los datos de OpenStreetMap. Cuando los servidores de descarga iban lentos, sus reintentos bloqueaban QGIS hasta un minuto seguido. En su favor, detectó por sí mismo un fallo suyo que había descartado 37 edificios, y lo corrigió.

Mapa de QGIS del centro de Oporto tras la prueba con QGIS MCP: 4445 edificios de OpenStreetMap coloreados en nueve clases, como residencial, comercial, público y religioso, sobre imágenes de satélite nítidas, que cubren ambas orillas del río Duero. El panel Capas lista Porto buildings (OSM) y Satellite (Esri World Imagery). — QGIS MCP con Claude Code: 8 min 29 s, 28 acciones, un rectángulo que cruza el río.

AI Agent usó su herramienta integrada de OpenStreetMap, buscó el límite real del centro histórico, cortó los edificios con él y les dio estilo, sin escribir código. Su mapa base de satélite es más borroso con este zoom que el que eligió QGIS MCP.

QGIS con el panel de AI Agent a la derecha. El mapa muestra el centro histórico de Oporto delimitado en blanco, con edificios coloreados por tipo sobre imágenes de satélite. La respuesta del agente dice que cargó y coloreó los edificios según su tipo de edificio de OpenStreetMap con imágenes de satélite debajo, cortados con el límite del centro histórico, y cuenta 1914 edificios distintos en 26 valores de etiqueta, 1602 de ellos con building=yes. Debajo: 5 fuentes y 15 acciones. — AI Agent: 1 min 11 s, 15 acciones, cortado con el límite real del centro histórico.

Cómo lo medimos. Mismo equipo, QGIS 3.44.7, misma petición, proyecto nuevo y ajustes por defecto, con QGIS MCP 0.15.0 manejado por Claude Code con Claude Sonnet, y AI Agent 1.4.1. Comprobamos nosotros ambos recuentos: contra OpenStreetMap para el rectángulo y contando la capa final para el límite. Los servidores de descarga estaban saturados durante la prueba de QGIS MCP, lo que le costó tiempo, y un primer intento con AI Agent hizo fallar QGIS, un fallo que tenemos registrado, así que sus cifras salen de la repetición.

Puedes enviar la misma petición en tu propio QGIS en unos minutos: instala el plugin, inicia sesión y pégala en el panel.

Prueba AI Agent gratis en QGIS, sin tarjeta

Dónde se queda corto QGIS MCP

Estos son los límites que encontré o que están documentados, cada uno con su fuente:

El chat está fuera de QGIS. Cambias entre dos ventanas. El modelo trabaja con resultados de herramientas y solo ve el mapa cuando le pide a QGIS una imagen.
Cuatro piezas móviles. Cuando no pasa nada, el fallo puede estar en los ajustes del cliente, en uv, en el servidor, en el puerto o en el plugin. La página de solución de problemas del proyecto lista «No response from QGIS», Connection refused y ModuleNotFoundError como los errores habituales.
Una trampa en Windows. El README avisa de que Claude Desktop instalado desde Microsoft Store ejecuta los servidores en un entorno aislado que rompe la configuración habitual, así que una configuración que funciona en otros sitios falla ahí.
Cualquier Python, sin contraseña por defecto. La herramienta execute_code ejecuta cualquier PyQGIS (el código de Python de QGIS) que escriba el modelo. El README lo dice: «Por defecto el socket no tiene autenticación... cualquier proceso del equipo que pueda alcanzar el puerto puede manejar QGIS (incluido execute_code, que ejecuta PyQGIS arbitrario)». Una bifurcación, QGIS Agent MCP, existe sobre todo para quitar esa herramienta.
Sin datos propios. Maneja QGIS, pero encontrar y descargar datos depende del modelo, normalmente escribiendo Python. En mi prueba, 17 de sus 28 acciones fueron Python, y sus reintentos de descarga bloquearon QGIS entre 40 y 62 segundos seguidos.
Sin deshacer una petición completa. El deshacer de QGIS cubre ediciones, no capas añadidas ni archivos escritos.
La copia con más estrellas no es la que se mantiene. El original en GitHub, jjsantos01/qgis_mcp, tiene 1099 estrellas, ningún cambio de código desde el 1 de octubre de 2025 y una incidencia abierta titulada «Broken plugin for QGIS version 4.01». La versión mantenida, nkarasiak/qgis-mcp, es la del repositorio de plugins de QGIS.

Lo que la web cuenta mal

«Necesitas Claude Pro». Los servidores MCP locales funcionan con el plan gratuito de Claude, dentro de sus límites diarios. El requisito de plan de pago está en ChatGPT, que de todos modos no puede conectarse directamente a un servidor en tu equipo.

«Reinicia el equipo después de editar la configuración». Basta con reiniciar la app cliente. En Windows, comprueba que se haya cerrado del todo, porque sigue ejecutándose en la bandeja del sistema.

«Instala el repositorio con más estrellas». Instala desde el administrador de complementos de QGIS, que te da la versión mantenida.

La opción más sencilla: un agente dentro de QGIS

Construimos AI Agent, así que esta sección trata de nuestro propio plugin. Hace el mismo trabajo que QGIS MCP desde dentro de QGIS: el chat es un panel acoplado junto a tu mapa y el modelo viene con el plugin.

Las diferencias que importan en el día a día:

Una sola instalación. Complementos > Administrar e instalar complementos, busca AI Agent by TerraLab, instala e inicia sesión. Sin uv, sin archivo de configuración, sin app aparte, sin servidor que arrancar en cada sesión.
Ve tu proyecto. Los nombres de capa, los campos, el SRC, la extensión y la selección acompañan cada petición, y renderiza el mapa para comprobar su propio trabajo.
Datos integrados. Un catálogo de 55 fuentes de datos abiertos, de OpenStreetMap a Sentinel-2 y organismos cartográficos nacionales, para que el modelo no tenga que escribir código de descarga.
Pregunta primero. Con el ajuste por defecto se detiene antes de borrar o sobrescribir, y el Python que cambia tu proyecto siempre necesita tu clic.
Deshacer por mensaje. Cada mensaje deja un punto de restauración y un clic devuelve el proyecto a él.

Necesita conexión a internet y envía una descripción de tu proyecto, nunca tus archivos de datos, a un servicio alojado en la UE. Hay un plan Free sin tarjeta, y un mensaje cuenta como una tarea sin importar cuántos pasos requiera.

Prueba AI Agent gratis en QGIS, sin tarjeta

QGIS MCP frente a un agente dentro de QGIS

	QGIS MCP	AI Agent
Dónde chateas	Una app externa (Claude Desktop, Cursor, Claude Code)	Un panel dentro de QGIS
Qué instalas	El plugin, `uv`, un cliente MCP y una entrada de configuración	Un solo plugin
Cada sesión	Arrancar el servidor en QGIS y mantener abiertas las dos apps	Abrir el panel
Modelo	El que use tu cliente, con tu plan	Incluido
Catálogo de datos abiertos	No	55 fuentes
Ejecuta Python	Sí, sin preguntar por defecto	Pregunta antes de ejecutar código que cambia el proyecto
Deshacer una petición completa	No	Sí, con un clic
Precio	Plugin gratuito, más tu plan de IA	Plan Free, luego Pro a 49 € al mes
Ideal para	Desarrolladores que ya trabajan en Claude Code o Cursor	Usuarios SIG que quieren el resultado en QGIS

¿Cuál deberías usar?

Si ya trabajas en Claude Code o Cursor, escribes Python y quieres QGIS como una herramienta más ahí, QGIS MCP encaja bien, y no cuesta nada además del plan de IA que ya pagas. Si quieres escribir una tarea SIG y obtener el resultado en tu proyecto, sin terminal, sin uv y sin una segunda app, un agente dentro de QGIS llega con menos que configurar y mantener. Ese segundo caso es el de la mayoría de los usuarios SIG que conozco.

Qué recordar

QGIS MCP conecta una app de IA externa a QGIS, como Claude Desktop, mediante una conexión local, de modo que el modelo de la app pueda ejecutar herramientas de QGIS y Python.

Necesita cuatro piezas en marcha a la vez: la app cliente, uv y el servidor MCP, el plugin QGIS MCP con su servidor arrancado, y QGIS.

El lado de QGIS se instala en segundos. El resto ocurre fuera de QGIS: instalar uv, una app de IA, un comando en el terminal y volver a hacer clic en Run MCP tras cada reinicio.

En la misma tarea de Oporto, AI Agent respondió en 1 min 11 s con 15 acciones y sin código. QGIS MCP tardó 8 min 29 s y escribió Python en 17 de sus 28 acciones.

ChatGPT no puede usar directamente un servidor MCP local. El plan gratuito de Claude funciona, dentro de sus límites diarios.

Un agente dentro de QGIS, como AI Agent, hace el mismo trabajo desde un solo plugin, con el modelo, un catálogo de datos y deshacer con un clic incluidos.

Preguntas frecuentes

¿Qué es QGIS MCP?

Un plugin de QGIS y un servidor MCP local que permiten a una app de IA controlar QGIS mediante el Model Context Protocol. Chateas en la app, normalmente Claude Desktop o Claude Code, y el modelo llama a herramientas de QGIS: cargar capas, ejecutar Procesos, dar estilo, renderizar el mapa y ejecutar Python.

¿Cómo conecto Claude con QGIS?

Instala el plugin QGIS MCP desde el administrador de complementos y haz clic en Run MCP, instala uv, y después añade el servidor QGIS MCP al archivo de configuración de Claude Desktop, o ejecuta el comando claude mcp add en Claude Code, y reinicia el cliente. O instala un plugin de agente que se ejecute dentro de QGIS con su propio modelo, como AI Agent, que te ahorra el cliente, uv y la configuración.

¿Puede ChatGPT usar QGIS MCP?

No directamente. El centro de ayuda de OpenAI indica que ChatGPT se conecta a servidores MCP en internet, así que un servidor en tu equipo, como QGIS MCP, necesitaría un túnel para ser accesible. El modo desarrollador, que MCP exige, está limitado a los planes de pago de ChatGPT.

¿Es seguro QGIS MCP?

Puede ejecutar dentro de QGIS cualquier Python que escriba el modelo y, por defecto, el socket local no tiene autenticación, como indica su README. Úsalo en un equipo de confianza, define el token de secreto compartido si otras personas usan el equipo, detén el servidor cuando termines y guarda copias de seguridad de los proyectos importantes.

¿Por qué QGIS MCP no se conecta?

Las causas habituales, según la guía de solución de problemas del proyecto: el servidor no está arrancado en QGIS (Connection refused, haz clic en Run MCP), uv no está instalado o no se encuentra (ModuleNotFoundError), o el puerto no es el 9876. Tras reiniciar QGIS, el servidor vuelve a estar apagado salvo que esté marcado el inicio automático. En Windows, una instalación de Claude Desktop desde Microsoft Store necesita la forma --directory de la configuración.

¿Hay una alternativa a QGIS MCP?

Sí. Los plugins de agente se ejecutan dentro de QGIS como un panel de chat, sin app externa ni servidor local. En septiembre de 2026 contamos 38 plugins de agente y asistente en el repositorio oficial. El nuestro, AI Agent, incluye el modelo, 55 fuentes de datos abiertos y deshacer con un clic, con un plan Free.

Qué es un agente de IA en QGIS cuenta los 38 plugins de agente y asistente del repositorio oficial, puentes MCP incluidos. La guía de AI Agent muestra diez ejecuciones reales con sus prompts, y PyQGIS mide con qué frecuencia el código escrito por un chatbot funciona a la primera. El centro de IA para QGIS compara el resto del panorama.