Saltar al contenido
AI Agent
QGIS
Guía

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

Publicado el Actualizado el

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:

  1. Un cliente MCP: la app de IA donde escribes, como Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI o Gemini CLI.
  2. 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.
  3. 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.
  4. 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

RequisitoPara qué sirveCoste
QGIS 3.28 o posteriorMínimo del pluginGratis
Una app cliente MCPDonde chateas con el modeloPlan gratuito con límites diarios, o un plan de pago
uv (ejecutor de paquetes de Python)Arranca el servidor MCPGratis, un comando en el terminal para instalarlo
Un comando en el terminal o una línea en un archivo de configuraciónIndica al cliente dónde está el servidorGratis, pero a mano
El plugin QGIS MCPEl lado de QGIS del puenteGratis

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

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

  2. Instala uv

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

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

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

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

  6. 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, al mismo tiempo en el mismo equipo, cada una en un proyecto de QGIS nuevo: «En Lyon, Francia, encuentra las escuelas a menos de 300 metros de una parada de tranvía, muéstralas en un mapa con las líneas de tranvía y dime cuántas hay».

QGIS MCP, con Claude CodeAI Agent
Tiempo hasta la respuesta9 min 28 s5 min 35 s
Pasos10, de los cuales 6 fueron código de Python40, de los cuales 2 fueron código de Python
Datos que usóOpenStreetMap, descargado con Python que escribió el modeloLas capas oficiales de escuelas, collèges y lycées de la Métropole de Lyon, más las paradas y los trazados de tranvía de OpenStreetMap
Escuelas contadas8780 (52 primarias, 14 collèges, 14 lycées)

Los recuentos difieren porque las dos herramientas usaron datos distintos. QGIS MCP contó escuelas de OpenStreetMap cercanas a paradas de tranvía tomadas de un recuadro alrededor de Lyon, así que también cuentan algunas paradas justo fuera de la ciudad, y él mismo dijo que los 87 no estaban deduplicados. AI Agent usó los registros oficiales de escuelas de la ciudad y el límite del municipio de Lyon.

La mayor diferencia está en cómo llegaron. QGIS MCP no tiene una herramienta de datos, así que el modelo escribió Python para consultar los servidores Overpass de OpenStreetMap. Respondieron con errores (406, 504 y luego 502 dos veces), y reintentó. Ese Python se ejecutó en el hilo principal de QGIS, así que QGIS quedó bloqueado unos siete minutos, y el mapa siguió vacío hasta los 7 min 22 s.

QGIS tras la prueba con QGIS MCP en Lyon: puntos rojos para las escuelas a menos de 300 m de una parada de tranvía, líneas de tranvía azules y paradas de tranvía grises sobre fondo blanco, sin mapa base. El panel Capas lista schools_within_300m, tram_lines, tram_stops y una capa oculta schools_all.
QGIS MCP con Claude Code: 9 min 28 s, 87 escuelas, cada descarga escrita en Python.

AI Agent buscó primero en su catálogo de datos y cargó las capas oficiales de escuelas de la ciudad. Cuando el feed nacional de transporte no etiquetaba los tranvías de Lyon, pasó a OpenStreetMap para las paradas y los trazados de tranvía. Escribió Python dos veces, para medir la distancia de cada escuela a su parada más cercana.

QGIS con el panel de AI Agent a la derecha. El mapa muestra el contorno del municipio de Lyon, los trazados de tranvía y las escuelas a menos de 300 m de una parada, con su nombre y coloreadas como escuelas primarias, collèges y lycées. La respuesta del agente muestra una tarjeta de estadísticas con 80 escuelas (52 primarias, 14 collèges, 14 lycées) y distancias a la parada más cercana de 14.6 a 297.2 m, y después sus fuentes: escuelas de la Métropole de Lyon, paradas y trazados de tranvía de OpenStreetMap, el límite de Lyon y un extracto GTFS.
AI Agent: 5 min 35 s, 80 escuelas, a partir de las capas de escuelas de la propia ciudad.

Tres tareas más, y una en la que QGIS MCP fue más rápido

Una sola carrera prueba poco, así que cronometré otras tres tareas de la misma forma. No todas salen a nuestro favor:

TareaQGIS MCP, con Claude CodeAI Agent
Edificios del centro histórico de Oporto por tipo, sobre un mapa base de satélite1 min 44 s1 min 21 s
Lo mismo, más un diseño en PDF A4 con título, leyenda, barra de escala y flecha del norte2 min 48 s5 min 26 s
Edificios de York en riesgo de inundación fluvial, con datos de Environment AgencySin terminar tras 15 min, nada en el mapaSin terminar tras 15 min, parte de los datos de inundación cargados, sin recuento

Cuando los datos están a una descarga de OpenStreetMap, QGIS MCP aguanta el ritmo, y en el diseño en PDF fue unas dos veces más rápido. Su propia respuesta advertía de que exportó el PDF sin comprobar que las teselas de satélite se hubieran cargado. La diferencia aparece cuando el modelo tiene que encontrar y descargar los datos por sí mismo, como en Lyon. Ninguna de las dos herramientas terminó la tarea de inundaciones de York en 15 minutos. Una primera prueba en Oporto el 26 de septiembre le costó a QGIS MCP 8 min 29 s porque los servidores de descarga estaban saturados ese día, así que volví a cronometrarlo todo.

Cómo lo medimos. Mismo equipo, las dos herramientas funcionando a la vez, QGIS 3.44.15, proyecto nuevo y ajustes por defecto salvo el effort de AI Agent, en Medium. Una ejecución por herramienta, sin repeticiones: QGIS MCP 0.15.2 manejado por Claude Code con Claude Sonnet 5.5 y solo las herramientas de QGIS permitidas, y AI Agent 1.9.0 en modo Balanced. El tiempo de QGIS MCP es el de la propia ejecución de Claude Code, que deja fuera los 52 segundos que tardó el cliente en arrancar. El equipo estaba muy cargado y los servidores de OpenStreetMap fallaban para ambas herramientas durante la carrera de Lyon. Grabamos todas las ejecuciones.

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.

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 la prueba de Lyon, 6 de sus 10 pasos fueron Python, y las descargas bloquearon QGIS unos siete minutos.
  • 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.

Otras formas de conectar Claude con QGIS

El plugin de arriba es el que casi todas las guías tienen en mente, pero otros tres proyectos también ponen a Claude en QGIS. Leídos en sus propias páginas el 23 de octubre de 2026:

  • piatkowski/qgis-mcp: un proyecto distinto con el mismo nombre, pensado para Claude Desktop. Se instala desde un ZIP en su página de versiones de GitHub, no desde el administrador de complementos, su servidor necesita Python 3.12 o posterior y empieza a escuchar en el puerto 9876 en cuanto activas el plugin. El plugin de arriba también usa el puerto 9876, así que usa uno a la vez.
  • ClaudIA QGIS: derivado del plugin de arriba, con el puerto local sustituido por una conexión HTTPS a la comunidad agrônomo10X, así que no hay que instalar Python. Pide una cuenta de agrônomo10X, y su versión 0.2.3 del 15 de septiembre de 2026 está marcada como experimental.
  • QGIS Agent: un panel de chat dentro de QGIS con tu propia clave de LLM, y un servidor MCP local opcional que Claude Desktop o Cursor pueden manejar.

Una alternativa a QGIS MCP: 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. En los benchmarks GeoKTools y GeoExpertQueries de Google, Claude Sonnet 5.5 manejando QGIS con este plugin MCP (versión 0.15.1, en Claude Code) obtuvo 24.9 sobre 100 en 41 preguntas reservadas, y AI Agent en effort Low (GPT-6 Luna) obtuvo 43.8 (los resultados del benchmark).

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 190 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 Pro gratis durante 7 días: añade una tarjeta, cancela antes del final y no se cobra nada.

Prueba AI Agent gratis en QGIS, sin tarjeta

QGIS MCP frente a un agente dentro de QGIS

QGIS MCPAI Agent
Dónde chateasUna app externa (Claude Desktop, Cursor, Claude Code)Un panel dentro de QGIS
Qué instalasEl plugin, uv, un cliente MCP y una entrada de configuraciónUn solo plugin
Cada sesiónArrancar el servidor en QGIS y mantener abiertas las dos appsAbrir el panel
ModeloEl que use tu cliente, con tu planIncluido
Catálogo de datos abiertosNo190 fuentes
Ejecuta PythonSí, sin preguntar por defectoPregunta antes de ejecutar código que cambia el proyecto
Deshacer una petición completaNoSí, con un clic
PrecioPlugin gratuito, más tu plan de IAPlan Free, luego Pro a 49 € al mes
Ideal paraDesarrolladores que ya trabajan en Claude Code o CursorUsuarios 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 tarea de Lyon, AI Agent respondió en 5 min 35 s a partir de las capas oficiales de escuelas de la ciudad. QGIS MCP tardó 9 min 28 s y escribió Python en 6 de sus 10 pasos. En tareas más simples la diferencia se reduce, y en un diseño en PDF QGIS MCP fue más rápido.

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

Hazlo en QGIS pidiéndoselo

AI Agent realiza la tarea que describes, en tu propio proyecto de QGIS. Gratis, sin tarjeta.

Prueba AI Agent gratis
Escrito porYvann Barbot
·21 min read

Sigue leyendo