Cómo conectar Claude con QGIS mediante QGIS MCP para trabajar en lenguaje natural

Escribir código PyQGIS para automatizar un geoproceso, buscar el algoritmo exacto en la Caja de Herramientas o recordar la sintaxis correcta de una expresión son tareas que forman parte del día a día de muchos técnicos SIG. Funcionan, pero consumen tiempo y concentración que podría dedicarse al análisis en sí.

Por eso, cuando aparece una integración que permite describir lo que quieres hacer directamente en lenguaje natural y ver cómo QGIS lo ejecuta solo, merece la pena prestarle atención. En este artículo explicamos qué es QGIS MCP, cómo conecta Claude con QGIS y qué posibilidades abre para el trabajo geoespacial profesional.

Qué es el Model Context Protocol (MCP)

MCP, o Model Context Protocol, es un estándar abierto desarrollado por Anthropic que define cómo los modelos de lenguaje pueden comunicarse con aplicaciones externas de forma estructurada. No es simplemente una API: es un protocolo bidireccional que permite a la IA recibir información de una herramienta externa y actuar sobre ella en tiempo real.

La diferencia con el uso habitual de un asistente como Claude es sustancial. Hasta ahora, el flujo habitual era: salir de QGIS, abrir el navegador o la app, describir el problema, copiar el código generado, volver a QGIS y ejecutarlo. Con MCP, ese ciclo desaparece. Claude opera directamente dentro del entorno de trabajo, con acceso al proyecto activo y capacidad de ejecutar acciones sobre él.

QGIS MCP es la implementación de este protocolo para QGIS. Su arquitectura:

Claude  ←→  Servidor MCP  ←→  Socket TCP  ←→  Plugin QGIS  ←→  API PyQGIS

Claude se comunica con un servidor MCP local, que a su vez se conecta mediante un socket TCP con un plugin instalado en QGIS. Ese plugin traduce las instrucciones del modelo en llamadas directas a la API de PyQGIS. El resultado es que lo que describes en lenguaje natural se convierte en acciones reales sobre tu proyecto.

¿Cuáles son los requisitos previos?

Para poner en marcha la integración se necesitan varios elementos. No hay configuraciones especialmente complejas, pero conviene tenerlos claros antes de empezar:

• QGIS 3.28 o superior, compatible también con QGIS 4.x.
• Python 3.12 o superior.
• uv, el gestor de paquetes Python utilizado para arrancar el servidor MCP.
• Claude Desktop (o Claude Code), la aplicación que permite configurar conexiones MCP de forma nativa.

Con estos cuatro elementos instalados, la configuración es directa.

Cómo se instala: pasos generales

El proceso de instalación se desarrolla en cuatro pasos. En este artículo nos quedamos con una visión general, ya que el procedimiento detallado, con todas las opciones de configuración y casos prácticos reales, forma parte de nuestro curso de IA Generativa para aplicaciones geográficas.

Qué se puede hacer con QGIS MCP

Una vez establecida la conexión, Claude tiene acceso a un conjunto amplio de operaciones sobre QGIS. Algunas de las más relevantes para el trabajo profesional:

• Crear y guardar proyectos con una instrucción en texto.
• Cargar capas vectoriales y ráster indicando su ruta o nombre.
• Ejecutar algoritmos de la Caja de Herramientas de Procesos, desde reproyecciones hasta análisis de redes o álgebra de mapas.
• Aplicar simbologías categorizada, graduada o basada en reglas, especificando el campo y los parámetros de clasificación.
• Editar entidades y campos, añadir geometrías o modificar atributos de capas existentes.
• Renderizar y exportar mapas a imagen o PDF.
• Ejecutar código PyQGIS directamente para operaciones más específicas o personalizadas.

Lo que convierte todo esto en algo útil de verdad es que Claude no trabaja con datos abstractos. Trabaja con el proyecto que tienes abierto, conoce las capas que has cargado y puede razonar sobre ellas antes de ejecutar cualquier acción.

Casos de uso para profesionales SIG

Donde QGIS MCP aporta más valor es en proyectos con carga analítica real, donde el técnico necesita combinar criterio profesional con capacidad de procesamiento. Algunos escenarios concretos:

Planificación territorial y urbanismo

Desde generar una capa de suelo urbanizable filtrada por varios criterios normativos simultáneos, hasta calcular edificabilidades por zona o identificar incompatibilidades entre usos del suelo y afecciones sectoriales. Claude puede encadenar esos geoprocesos en el orden correcto, aplicarlos sobre las capas del proyecto activo y devolver los resultados listos para su revisión técnica, sin que el analista tenga que abandonar el entorno de trabajo ni recordar la sintaxis exacta de cada herramienta.

Medio ambiente y biodiversidad

Calcular la superficie de hábitats afectada por un proyecto, detectar solapamientos entre figuras de protección, generar zonas de amortiguamiento alrededor de áreas críticas o extraer estadísticas de cobertura vegetal por unidad de paisaje son tareas habituales en estudios ambientales que implican encadenar varias herramientas. Con QGIS MCP es posible describir ese flujo en lenguaje natural y obtener los resultados directamente sobre las capas del proyecto, con la trazabilidad de cada operación ejecutada.

Riesgos naturales

Delimitar zonas inundables por período de retorno, calcular la exposición de elementos vulnerables dentro de cada escenario, estimar superficies forestales con alta carga de combustible o cruzar variables de peligrosidad para construir índices de riesgo compuesto son procesos que combinan múltiples capas y decisiones metodológicas. Claude puede ejecutar esa secuencia de operaciones, documentar los criterios aplicados y generar las capas de resultado en el formato que requiera el proyecto

Automatización de flujos repetitivos

Reproyecciones masivas, recortes por límite municipal, exportaciones a distintos formatos, generación de series de mapas temáticos. Tareas recurrentes en muchos proyectos que con QGIS MCP pueden resolverse con una instrucción clara, sin necesidad de escribir scripts cada vez.

Aprendizaje asistido

Este uso es especialmente interesante para quienes están profundizando en PyQGIS. Claude puede ejecutar un algoritmo y, al mismo tiempo, explicar qué hace exactamente, qué parámetros utiliza y por qué. El entorno se convierte en espacio de trabajo y de aprendizaje a la vez.

Un ejemplo para hacerse una idea

Imaginemos este prompt enviado a Claude una vez establecida la conexión:

«Tienes acceso a las herramientas de QGIS. Haz lo siguiente: comprueba la conexión con ping. Busca la capa vectorial municipios.shp con el nombre ‘Municipios’ que hay en el proyecto. Crea una simbología graduada con la rampa de color Reds por el campo ‘POBLACION’ con 5 clases.»

Claude ejecuta cada uno de esos pasos en secuencia, directamente sobre QGIS. No hace falta abrir ningún menú, buscar ningún algoritmo ni escribir una sola línea de código.

Una advertencia importante antes de empezar

QGIS MCP incluye una herramienta llamada execute_code que permite a Claude ejecutar código Python arbitrario dentro de QGIS. Esto es lo que lo hace tan potente, pero también lo que exige más atención por parte del usuario.

Conviene revisar siempre lo que Claude va a ejecutar antes de confirmarlo, especialmente en proyectos de producción con datos reales. La recomendación es trabajar con copias o proyectos de prueba durante las primeras sesiones, hasta familiarizarse con el tipo de operaciones que el modelo genera y el nivel de supervisión necesario.

Recursos del proyecto

• Repositorio oficial: https://github.com/nkarasiak/qgis-mcp
• Plugin oficial de QGIS: disponible desde el gestor de complementos buscando «QGIS MCP».

Conclusión

QGIS MCP no es un experimento ni una demostración de laboratorio. Es una integración funcional que cambia la forma de interactuar con QGIS: el lenguaje natural pasa a ser la interfaz principal, y Claude actúa como un operador que conoce el entorno, entiende el proyecto y ejecuta lo que se le pide.

No reemplaza al técnico SIG. Amplifica su capacidad: menos tiempo navegando menús y escribiendo código, más tiempo analizando, interpretando y tomando decisiones.

Si quieres aprender a configurar esta integración desde cero, trabajar con prompts optimizados para contextos geoespaciales reales y aplicarla en proyectos de planificación, medio ambiente o análisis de riesgos entre otros , en nuestro curso de IA Generativa para aplicaciones geográficas encontrarás el camino más directo para empezar con criterio técnico.

Etiquetas: claude, IA, mcp, Plugins, pyqgis, qgis, sig