Claude en QGIS: 3 formas de conectarlos, probadas en la misma tarea
Publicado el
No existe un plugin oficial de Anthropic para QGIS. Tienes tres formas principales de usar Claude con QGIS: conectar Claude Desktop o Claude Code mediante un servidor MCP de QGIS, pedirle a Claude que escriba código PyQGIS que pegas en la consola de Python, o instalar un plugin de agente dentro de QGIS.
El 7 de noviembre de 2026 probé cómo resuelve Claude una tarea real: cargar los distritos y las escuelas de OpenStreetMap de Pune, en la India, contar las escuelas por polígono y aplicar un estilo de coropletas. Ninguno de los dos scripts PyQGIS que escribió Claude Sonnet 5.5 funcionó tal cual, aunque uno salió bien en 44 a 48 segundos después de que cambiara la URL de su servidor de datos. Un agente dentro de QGIS terminó el mismo prompt en 45 a 63 segundos en dos ejecuciones seguidas.

¿Qué formas hay de usar Claude con QGIS?
Conectar Claude a QGIS significa o bien darle al modelo de Anthropic un puente para que ejecute herramientas dentro de tu proyecto abierto, o bien copiar scripts PyQGIS entre una ventana de chat y la consola de Python de QGIS. Una tercera vía se salta el puente y pone un panel de agente de IA directamente dentro de QGIS.
La mayoría de los tutoriales solo muestran el puente del Model Context Protocol (MCP). Antes de instalar herramientas de línea de comandos extra o editar archivos de configuración, conviene ver qué exige cada una de las tres vías y qué pasa cuando les das el mismo trabajo.
| Vía 1: Claude + MCP de QGIS | Vía 2: Claude escribe PyQGIS | Vía 3: un agente dentro de QGIS | |
|---|---|---|---|
| Pasos de instalación | 5 pasos (instalar el plugin, uv, el cliente, la configuración, clic en Run MCP en cada sesión) | 0 pasos de instalación (3 clics por tarea para abrir el editor, pegar y ejecutar) | 3 pasos (instalar desde el administrador de complementos de QGIS, abrir el panel, iniciar sesión) |
| Qué necesitas | Claude Desktop (gratis o de pago) o Claude Code (plan de pago), más uv y un servidor local | Cualquier chat de Claude, sin software extra | QGIS 3.28+ y una cuenta gratuita (sin clave de API ni tarjeta) |
| Quién ejecuta el código | Claude lanza herramientas a través del puerto MCP local | Tú pegas y ejecutas el script en la consola de Python | El plugin ejecuta las herramientas de QGIS y revisa el mapa por sí mismo |
| ¿Ve tu proyecto? | Sí, cuando el servidor MCP está en marcha | No, salvo que escribas en el prompt los nombres de tus capas y el SRC | Sí, lee las capas abiertas, los campos y la extensión del mapa |
| Deshacer | Limpieza manual en QGIS | Limpieza manual en QGIS | Botón Deshacer cambios de un clic en cada respuesta |
| Resultado en la tarea de Pune | No se ejecutó en Pune (9 min 28 s en una tarea comparable de escuelas en Lyon) | 0 de 2 scripts funcionaron tal cual; 1 funcionó en 44 a 48 s tras editar una URL (447 escuelas en 14 talukas) | 2 de 2 ejecuciones aprobadas en 63 s y ~45 s (256 escuelas en 58 distritos de la ciudad) |
Si quieres hacer esta tarea a mano sin IA, la vía gratuita en QGIS lleva cuatro pasos: descarga los límites y los puntos amenity=school con Vectorial > QuickOSM > QuickOSM..., ejecuta Vectorial > Herramientas de análisis > Contar puntos en polígono... (native:countpointsinpolygon) y pon Propiedades de la capa > Simbología en Graduado sobre el nuevo campo de recuento.
¿Hay un plugin de Claude en el repositorio de QGIS?
No existe ningún plugin oficial de Anthropic en el repositorio de complementos de QGIS. Cuando revisé el índice del repositorio el 7 de noviembre de 2026 (4399 plugins para QGIS 3.44 y 1697 para QGIS 4.0), 45 plugins contenían la palabra "claude" en sus metadatos, pero 36 de ellos solo mencionaban a Claude como asistente de programación o tenían un autor llamado Claude.
Solo nueve plugins de la comunidad conectan de verdad un modelo o una suscripción de Claude con QGIS:
- QGIS MCP (de Nicolas Karasiak, v0.15.2, 77 002 descargas a 7 de noviembre de 2026): abre un puerto local para que Claude Desktop, Claude Code o Cursor ejecuten 125 herramientas dentro de QGIS.
- WAI QGIS MCP (v0.3.0, 753 descargas): se conecta a Claude Desktop con un único archivo de extensión
.mcpb, así que no tienes que instalar Node.js tú mismo. - QGIS Agent (de bunkmr, v2.4.15, 3783 descargas), QGIS Agent Mcp (v0.5.0, 3210 descargas), QGIS Salah MCP (v1.1.1, 2037 descargas) y ClaudIA QGIS (v0.4.6, 784 descargas): otros servidores de socket MCP o paneles que usan tu propia clave de API.
- LandTalk.AI (v1.5.0, 5927 descargas) y AI Copilot (v1.8.0, 2098 descargas): paneles de chat multimodelo que aceptan claves de Claude, OpenAI o Gemini.
- Mapsuke (de MIERUNE, v1.6.0, 1242 descargas, actualizado el 30 de octubre de 2026): un panel de chat dentro de QGIS 3.44+ que funciona con tu sesión de Claude Code o Codex sin servidor MCP, siempre que tengas instalada la CLI de Claude Code.
El plan de Claude que necesitas depende de cómo te conectes. Según las páginas de comparación de planes de Anthropic (consultadas el 7 de noviembre de 2026), el chat de Claude Desktop está disponible en el plan Free además de en Pro, Max, Ultra, Team y Enterprise, y puedes añadir un servidor MCP local desde Settings > Developer > Edit Config o con Desktop Extensions. Claude Code, la herramienta de línea de comandos en la que se apoyan plugins como Mapsuke y los flujos de trabajo por CLI, no está incluido en el plan Free y requiere una suscripción Pro, Max o Ultra.
La prueba: mapear las escuelas por distrito en Pune
Todos los tutoriales que leí para el análisis de la SERP probaban Claude con un archivo que el autor ya tenía en el disco. En el trabajo SIG real, a menudo le pides a la herramienta que descargue datos abiertos de una ciudad que nunca ha visto.
Escribí los criterios de éxito antes de ejecutar nada, el 7 de noviembre de 2026. El prompt era una sola frase:
Load the districts of Pune, India and the schools from OpenStreetMap, count schools per district and make a choropleth.
(En español: carga los distritos de Pune, India, y las escuelas de OpenStreetMap, cuenta las escuelas por distrito y haz un mapa de coropletas.)
Elegí Pune a propósito porque "districts of Pune" es ambiguo. Pune es un distrito de Maharashtra dividido en 14 subdistritos (talukas o tehsils), mientras que la ciudad de Pune se divide en 15 oficinas administrativas de distrito y 58 distritos electorales. Un buen flujo de trabajo o bien pregunta a qué límite te refieres, o bien dice con claridad cuál ha cargado.
Vía 2: pedirle a Claude código PyQGIS para pegar
Para la vía de copiar y pegar, ejecuté Claude Sonnet 5.5 (claude-sonnet-5-5 a través de Claude Code 2.1.306, con todas las herramientas y el acceso web desactivados, igual que una ventana de chat normal) dos veces con exactamente el mismo prompt, añadiendo solo "I use QGIS. Write the PyQGIS code I can paste in the QGIS Python console for this task". Si nunca has usado la consola, nuestra guía de PyQGIS explica cómo se ejecutan ahí los scripts.
Claude tardó 77 segundos en generar el primer script, de 134 líneas, y 67 segundos en el segundo, de 108 líneas. Las dos respuestas señalaron que "districts" es ambiguo, eligieron admin_level=6 (los 14 talukas del distrito de Pune) y explicaron cómo cambiar el nivel en el código. La segunda respuesta incluso añadió al final una advertencia honesta: «No lo he ejecutado, así que la primera ejecución es la prueba».
Ningún script funcionó tal cual en QGIS 3.44.15:
- La respuesta 1 falló al cabo de 1 segundo con
URLError: <urlopen error [Errno 61] Connection refused>. El script llamaba al principal servidor público de Overpass (overpass-api.de), que esa mañana rechazaba las conexiones desde nuestra IP. - La respuesta 2 falló en la línea 3, antes de hacer ninguna llamada de red. Lanzó
ImportError: cannot import name 'QgsClassificationNaturalBreaks' from 'qgis.core'.

En QGIS 3.44, la clase de cortes naturales se llama QgsClassificationJenks, no QgsClassificationNaturalBreaks. Como un chatbot sin herramientas no puede probar sus propios imports con tu versión de QGIS, un solo nombre de clase inventado detiene todo el script. Vimos exactamente el mismo patrón de adivinar a ciegas cuando probamos ChatGPT para QGIS con tres tareas en Annecy.
Para ver si el primer script de Claude era correcto por lo demás, cambié una constante en la respuesta 1, sustituyendo overpass-api.de por el espejo francés overpass.openstreetmap.fr, y lo ejecuté tres veces con el árbol de capas vacío. Con un servidor que funcionaba, terminó en 48, 44 y 45 segundos.

Las cuentas de la respuesta 1 eran correctas: cargó 14 polígonos de talukas y 447 escuelas, y cuando recalculé por mi cuenta los recuentos de punto en polígono, las 447 escuelas coincidían con el campo n_schools sin ninguna discrepancia (246 en Pune City Subdistrict, 75 en Haveli, 55 en Mulshi, hasta 0 en Indapur, Velhe y Ambegaon). Aun así, el mapa tenía asperezas que alguien tiene que pulir a mano: la leyenda por cuantiles mostraba cortes decimales como 0,0000 - 1,2000 para recuentos de escuelas que son números enteros, y las etiquetas del centro se solapaban con el zoom por defecto.
Vía 1: conectar Claude Desktop o Claude Code mediante el MCP de QGIS
Darle a Claude un servidor MCP de QGIS resuelve el problema de trabajar a ciegas: Claude puede inspeccionar tus capas, ejecutar execute_code, ver el traceback del error y volver a intentarlo.
No repetí la prueba del servidor MCP en Pune porque el servidor público de Overpass rechazaba nuestra red esa mañana y habría bloqueado las mismas llamadas a OpenStreetMap. En su lugar, ya habíamos medido Claude Sonnet 5.5 manejando QGIS MCP (v0.15.0 a 0.15.2) en Claude Code en cuatro tareas reales y en un benchmark de 41 preguntas, a finales de septiembre y en octubre de 2026:
- La instalación lleva 5 pasos y unos 3 minutos una vez que tienes
uvy un cliente instalados, más 16 segundos en la primera llamada mientras descarga un servidor de 90 MB que expone 125 herramientas. Cada vez que reinicias QGIS, tienes que acordarte de volver a hacer clic en Run MCP, o Claude devuelveError executing tool ping. Nuestra guía de instalación y prueba de QGIS MCP recorre cada paso y cada archivo de configuración. - En una tarea de escuelas comparable en Lyon (contar las escuelas a menos de 300 m de una parada de tranvía), Claude + QGIS MCP obtuvo el recuento correcto (87 escuelas) en 9 minutos 28 segundos. Seis de sus diez pasos eran Python en bruto, y QGIS se quedó congelado unos 7 minutos mientras el script recibía errores 406, 504 y 502 de Overpass.
- Cuando los datos ya están limpios, el MCP es rápido. En una tarea de edificios y composición de impresión en Oporto, Claude + QGIS MCP terminó en 2 minutos 48 segundos, por delante de los 5 minutos 26 segundos de nuestro propio agente.
- En el benchmark GeoExpertQueries de Google (41 tareas reservadas), Claude Sonnet 5.5 con QGIS MCP en Claude Code obtuvo 24,9 sobre 100, frente a 43,8 de AI Agent con esfuerzo Low (consulta los resultados completos del benchmark).
Si ya pagas Claude Pro o Max y pasas el día en Claude Code, el MCP no te cuesta nada más y te da total libertad para combinar scripts de shell, archivos locales y QGIS en una misma terminal.
Vía 3: usar un plugin de agente dentro de QGIS
Desarrollamos AI Agent, así que esta sección trata de nuestro propio plugin. En lugar de conectar una aplicación externa con QGIS, acopla un panel de chat justo al lado del lienzo del mapa, lee el estado de tu proyecto, tira de un catálogo de datos integrado (unas 90 fuentes y 2800 conjuntos de datos, además de OpenStreetMap y Overture Maps), revisa una imagen renderizada del mapa antes de responder y pone un botón Deshacer cambios bajo cada respuesta.
Ejecuté dos veces la misma frase sobre Pune en QGIS 3.44.15 (permisos Balanced, esfuerzo Medium).
En la primera ejecución, a los 11 segundos, el panel se detuvo y mostró una tarjeta de aclaración que preguntaba «¿Qué subdivisiones de Pune deben usarse para contar las escuelas?» con dos opciones en las que hacer clic: Pune city wards y Pune district tehsils. Al elegir Pune city wards, el tiempo total desde el clic en Enviar fue de 63 segundos, en 15 pasos.

En la segunda ejecución, en un chat nuevo, no hizo la pregunta: indicó en su respuesta que usaba los 58 distritos electorales de Pune como distritos de la ciudad y terminó en unos 45 segundos (16 pasos), con los distritos en una paleta naranja.

¿Por qué funcionaron las dos ejecuciones mientras los scripts pegados chocaban con errores de conexión? Porque el agente no llamó al saturado endpoint overpass-api.de desde un script en bruto: obtuvo los distritos electorales de 2022 de DataMeet y descargó las 256 escuelas (108 nodos y 148 vías, convirtiendo las escuelas en polígono en puntos de superficie) con sus herramientas de datos integradas. Cuando hice una comprobación independiente de punto en polígono sobre las dos salidas, los 256 puntos de escuelas caían dentro de los 58 distritos, sin ninguna discrepancia con el campo de atributos schools.
También mantuvo ordenado el árbol de capas, guardando tres capas intermedias en un grupo oculto Working layers, y me recordó en la respuesta que OpenStreetMap no es un censo oficial de escuelas. Mi única queja: entre la ejecución 1 y la 2 cambió de criterio sobre si preguntarme lo de distritos o tehsils, o decidir por su cuenta.
Prueba AI Agent gratis en QGIS, sin tarjeta
¿Qué vía deberías elegir?
En mi propio trabajo, sigo usando Claude a secas en un navegador o una terminal cuando escribo un script de Procesos reutilizable o depuro un plugin propio repartido en veinte archivos. Ahí quieres leer el Python, hacer commit en Git y ejecutarlo fuera de la interfaz. Solo acuérdate de pegar en el prompt tu versión de QGIS, los nombres de las capas, los nombres de los campos y el SRC, y cuenta con tener que arreglar un import o dos.
Elige Claude + MCP de QGIS si ya tienes una suscripción de pago a Claude, te manejas bien con uv y los archivos de configuración JSON, y quieres combinar operaciones con archivos locales y llamadas a QGIS en Claude Desktop o Claude Code. No cuesta nada sobre tu plan actual y es rápido cuando tus capas de datos ya están cargadas.
Elige un agente dentro de QGIS cuando quieras el mapa y los números sin tener que vigilar tracebacks de Python, timeouts de Overpass o puertos caídos. Para un analista con una fecha de entrega o un equipo que necesita una simbología coherente, las fuentes de datos citadas y un Deshacer de un clic, tener el agente y el catálogo de datos integrados en QGIS es lo que más tiempo ahorra. Puedes leer en qué se diferencia la arquitectura en nuestra guía sobre qué es un agente de IA en QGIS, o ver todas las herramientas actuales en el hub de IA para QGIS.
Cómo lo medimos. Todas las ejecuciones de Pune se hicieron el 7 de noviembre de 2026 entre las 10:29 y las 11:03, hora de París, en macOS con QGIS 3.44.15-Solothurn (Qt 5.15.19). Los criterios de éxito se escribieron a las 10:14, antes del primer prompt. Claude Sonnet 5.5 (claude-sonnet-5-5) se llamó a través de Claude Code 2.1.306 (claude -p --safe-mode --tools "" --model sonnet) en un directorio vacío, sin servidores MCP ni acceso web; los dos scripts devueltos se ejecutaron en el Python de QGIS y se comprobaron con un script independiente de punto en polígono. AI Agent 1.9.4 (modo Balanced, esfuerzo Medium) se ejecutó dos veces con la misma frase en proyectos limpios. Había otras sesiones de QGIS abiertas en el mismo Mac durante las pruebas, así que los tiempos son más lentos que en una máquina en reposo. Dos ejecuciones por vía en una sola tarea son una muestra pequeña, y el rechazo de conexión de overpass-api.de se observó desde una sola red, una sola mañana.
Preguntas frecuentes
¿Hay un plugin oficial de Claude para QGIS?
No. Anthropic no publica ningún plugin para QGIS. A 7 de noviembre de 2026, el repositorio de complementos de QGIS tiene nueve plugins de la comunidad que conectan Claude con QGIS, ya sea mediante un servidor local de Model Context Protocol (MCP) (como QGIS MCP y WAI QGIS MCP), con tu propia clave de API o con una sesión local de Claude Code (Mapsuke). Como alternativa, AI Agent se instala directamente desde el administrador de complementos de QGIS, con el modelo de IA y el catálogo de datos integrados.
¿Puede Claude Desktop controlar QGIS gratis?
Sí, con límites. Según la documentación de planes de Anthropic, el chat de Claude Desktop está disponible en el plan Free y admite servidores MCP locales mediante claude_desktop_config.json o Desktop Extensions (.mcpb). Ejecutar Claude Code desde la terminal requiere un plan de pago Claude Pro, Max o Ultra.
¿Puede Claude escribir código PyQGIS que funcione en QGIS 3.44?
Sí, Claude Sonnet 5.5 escribe PyQGIS bien estructurado, pero como no puede ver tu instalación de QGIS ni probar su propio código, a veces inventa nombres de clases o depende de servidores externos que fallan. En nuestra prueba con dos muestras en QGIS 3.44.15, un script falló con ImportError en QgsClassificationNaturalBreaks (la clase real es QgsClassificationJenks) y el otro falló hasta que cambiamos la URL de su API de Overpass.
¿Cuál es la forma más fácil de usar IA dentro de QGIS sin configurar un MCP?
Instala un plugin de agente integrado desde Complementos > Administrar e instalar complementos en QGIS. Con AI Agent no hay entorno de Python, gestor de paquetes uv ni archivo de configuración que mantener: inicias sesión gratis, tienes 5 tareas al mes (300 en Pro) y escribes tu petición en el panel acoplado.
Hazlo en QGIS pidiéndoselo
AI Agent realiza la tarea que describes, en tu propio proyecto de QGIS. Gratis, sin tarjeta.
. Tienes tres formas principales de usar Claude con QGIS: conectar Claude Desktop o Claude Code mediante un servidor MCP de QGIS, pedirle a Claude que escriba código PyQGIS que pegas en la consola de Python, o instalar un plugin de agente dentro de QGIS.

