Claude no QGIS: 3 formas de conectar, testadas na mesma tarefa

Não existe plugin oficial da Anthropic para o QGIS. Você tem três formas principais de usar o Claude com o QGIS: conectar o Claude Desktop ou o Claude Code por um servidor QGIS MCP, pedir ao Claude um código PyQGIS para colar no Terminal Python, ou instalar um plugin de agente dentro do QGIS.

Em 7 de novembro de 2026, testei como o Claude se sai numa tarefa real: carregar os distritos e as escolas do OpenStreetMap de Pune, na Índia, contar as escolas por polígono e aplicar um estilo coroplético. Nenhum dos dois scripts PyQGIS que o Claude Sonnet 5.5 escreveu rodou como foi colado, embora um tenha funcionado em 44 a 48 segundos depois que troquei a URL do servidor de dados. Um agente dentro do QGIS terminou o mesmo prompt em 45 a 63 segundos, em duas execuções seguidas.

Quais são as formas de usar o Claude com o QGIS?

Conectar o Claude ao QGIS significa dar ao modelo da Anthropic uma ponte para ele rodar ferramentas dentro do seu projeto aberto, ou copiar scripts PyQGIS entre uma janela de chat e o Terminal Python do QGIS. Um terceiro caminho dispensa a ponte e coloca um painel de agente de IA direto dentro do QGIS.

A maioria dos tutoriais só mostra a ponte pelo Model Context Protocol (MCP). Antes de instalar ferramentas de linha de comando extras ou editar arquivos de configuração, vale ver o que cada um dos três caminhos exige e o que acontece quando todos recebem o mesmo trabalho.

Se quiser fazer a tarefa à mão, sem IA, o caminho gratuito no QGIS tem quatro etapas: baixe os limites e os pontos amenity=school com Vetor > QuickOSM > QuickOSM..., rode Vetor > Ferramentas de Análise > Contar Pontos em Polígono... (native:countpointsinpolygon) e defina Propriedades da Camada > Simbologia como Graduado no novo campo de contagem.

Existe um plugin do Claude no repositório do QGIS?

Não existe plugin oficial da Anthropic no repositório de complementos do QGIS. Quando consultei o índice do repositório em 7 de novembro de 2026 (4.399 plugins para o QGIS 3.44 e 1.697 para o QGIS 4.0), 45 plugins tinham a palavra "claude" nos metadados, mas 36 deles só citavam o Claude como assistente de programação ou tinham um autor chamado Claude.

Só nove plugins da comunidade conectam de fato um modelo ou uma assinatura do Claude ao QGIS:

• QGIS MCP (de Nicolas Karasiak, v0.15.2, 77.002 downloads em 7 de novembro de 2026): abre uma porta local para que o Claude Desktop, o Claude Code ou o Cursor rodem 125 ferramentas dentro do QGIS.
• WAI QGIS MCP (v0.3.0, 753 downloads): conecta ao Claude Desktop por um único arquivo de extensão .mcpb, sem que você precise instalar o Node.js.
• QGIS Agent (de bunkmr, v2.4.15, 3.783 downloads), QGIS Agent Mcp (v0.5.0, 3.210 downloads), QGIS Salah MCP (v1.1.1, 2.037 downloads) e ClaudIA QGIS (v0.4.6, 784 downloads): outros servidores de socket MCP ou painéis que usam a sua própria chave de API.
• LandTalk.AI (v1.5.0, 5.927 downloads) e AI Copilot (v1.8.0, 2.098 downloads): painéis de chat multimodelo que aceitam chaves do Claude, da OpenAI ou do Gemini.
• Mapsuke (da MIERUNE, v1.6.0, 1.242 downloads, atualizado em 30 de outubro de 2026): um painel de chat dentro do QGIS 3.44+ que roda com o seu login atual do Claude Code ou do Codex, sem servidor MCP, desde que você tenha a CLI do Claude Code instalada.

O plano do Claude de que você precisa depende de como você se conecta. Segundo as páginas de comparação de planos da Anthropic (lidas em 7 de novembro de 2026), o chat do Claude Desktop está disponível no plano Free, além de Pro, Max, Ultra, Team e Enterprise, e você pode ligar um servidor MCP local em Settings > Developer > Edit Config ou pelas Desktop Extensions. O Claude Code, a ferramenta de linha de comando da qual dependem plugins como o Mapsuke e os fluxos pela CLI, não está incluído no plano Free e exige uma assinatura Pro, Max ou Ultra.

O teste: mapear escolas por distrito em Pune

Todos os tutoriais que li para o mapa de lacunas da busca testavam o Claude com um arquivo que o autor já tinha no disco. No trabalho real com SIG, muitas vezes você pede à ferramenta que busque dados abertos de uma cidade que ela nunca viu.

Escrevi os critérios de sucesso antes de rodar qualquer coisa, em 7 de novembro de 2026. O prompt era uma única frase:

Load the districts of Pune, India and the schools from OpenStreetMap, count schools per district and make a choropleth.

Escolhi Pune de propósito, porque "distritos de Pune" é ambíguo. Pune é um distrito de Maharashtra dividido em 14 subdistritos (talukas ou tehsils), enquanto a cidade de Pune é dividida em 15 escritórios administrativos regionais e 58 distritos eleitorais. Um bom fluxo de trabalho ou pergunta qual limite você quer, ou diz com clareza qual carregou.

Caminho 2: pedir ao Claude um código PyQGIS para colar

Para o caminho de copiar e colar, rodei o Claude Sonnet 5.5 (claude-sonnet-5-5 pelo Claude Code 2.1.306, com todas as ferramentas e o acesso à web desligados, como numa janela de chat simples) duas vezes com exatamente o mesmo prompt, acrescentando só "I use QGIS. Write the PyQGIS code I can paste in the QGIS Python console for this task". Se você nunca usou o terminal, nosso guia de PyQGIS explica como os scripts rodam ali.

O Claude levou 77 segundos para gerar o primeiro script, de 134 linhas, e 67 segundos para o segundo, de 108 linhas. As duas respostas observaram que "districts" é ambíguo, escolheram admin_level=6 (as 14 talukas do distrito de Pune) e explicaram como mudar o nível no código. A segunda resposta ainda acrescentou um aviso honesto no fim: "I haven't run it, so the first run is the test."

Nenhum dos scripts rodou como foi colado no QGIS 3.44.15:

1. A resposta 1 falhou depois de 1 segundo com URLError: <urlopen error [Errno 61] Connection refused>. O script chamava o principal servidor Overpass público (overpass-api.de), que naquela manhã recusava conexões do nosso IP.
2. A resposta 2 falhou na linha 3, antes de qualquer chamada de rede. Ela gerou ImportError: cannot import name 'QgsClassificationNaturalBreaks' from 'qgis.core'.

No QGIS 3.44, a classe de quebras naturais se chama QgsClassificationJenks, não QgsClassificationNaturalBreaks. Como um chatbot sem ferramentas não consegue testar os próprios imports na sua versão do QGIS, um único nome de classe inventado derruba o script inteiro. Vimos exatamente o mesmo padrão de chute às cegas quando testamos o ChatGPT no QGIS em três tarefas em Annecy.

Para ver se o primeiro script do Claude estava correto no resto, mudei uma constante na resposta 1, trocando overpass-api.de pelo espelho francês overpass.openstreetmap.fr, e rodei três vezes numa árvore de camadas limpa. Com um servidor funcionando, ele terminou em 48, 44 e 45 segundos.

A conta da resposta 1 estava certa: ela carregou 14 polígonos de talukas e 447 escolas, e quando recalculei as contagens de ponto em polígono de forma independente, as 447 escolas bateram com o campo n_schools, sem nenhuma divergência (246 em Pune City Subdistrict, 75 em Haveli, 55 em Mulshi, até 0 em Indapur, Velhe e Ambegaon). Mesmo assim, o mapa tinha arestas que alguém precisa aparar: a legenda por quantis mostrava quebras decimais como 0,0000 - 1,2000 para contagens inteiras de escolas, e os rótulos do centro se sobrepunham no zoom padrão.

Caminho 1: conectar o Claude Desktop ou o Claude Code pelo QGIS MCP

Dar ao Claude um servidor QGIS MCP resolve o problema da cegueira: o Claude pode inspecionar suas camadas, rodar execute_code, ver o traceback do erro e tentar de novo.

Não rodei o servidor MCP de novo em Pune porque o servidor Overpass público recusava a nossa rede naquela manhã e teria bloqueado as mesmas chamadas ao OpenStreetMap. Em vez disso, já tínhamos medido o Claude Sonnet 5.5 controlando o QGIS MCP (v0.15.0 a 0.15.2) no Claude Code em quatro tarefas reais e num benchmark de 41 questões, no fim de setembro e em outubro de 2026:

• A configuração leva 5 etapas e cerca de 3 minutos depois que você tem o uv e um cliente instalados, mais 16 segundos na primeira chamada, enquanto ele baixa um servidor de 90 MB que expõe 125 ferramentas. Toda vez que você reinicia o QGIS, precisa lembrar de clicar em Run MCP de novo, ou o Claude devolve Error executing tool ping. Nosso guia de instalação e teste do QGIS MCP mostra cada etapa e cada arquivo de configuração.
• Numa tarefa comparável de escolas em Lyon (contar as escolas a até 300 m de uma parada de bonde), o Claude + QGIS MCP chegou à contagem certa (87 escolas) em 9 minutos e 28 segundos. Seis das suas dez etapas eram Python puro, e o QGIS travou por cerca de 7 minutos enquanto o script recebia erros 406, 504 e 502 do Overpass.
• Quando os dados já estão limpos, o MCP é rápido. Numa tarefa de edificações e layout de impressão no Porto, o Claude + QGIS MCP terminou em 2 minutos e 48 segundos, à frente dos 5 minutos e 26 segundos do nosso próprio agente.
• No benchmark GeoExpertQueries do Google (41 tarefas reservadas), o Claude Sonnet 5.5 com QGIS MCP no Claude Code fez 24,9 de 100, contra 43,8 do AI Agent no esforço Low (veja os resultados completos do benchmark).

Se você já paga o Claude Pro ou Max e passa o dia no Claude Code, o MCP não custa nada a mais e dá liberdade total para combinar scripts de shell, arquivos locais e o QGIS num só terminal.

Caminho 3: usar um plugin de agente dentro do QGIS

Nós desenvolvemos o AI Agent, então esta seção fala do nosso próprio plugin. Em vez de ligar um app externo ao QGIS, ele acopla um painel de conversa ao lado da tela do mapa, lê o estado do projeto, busca dados num catálogo embutido (cerca de 90 fontes e 2.800 conjuntos de dados, mais o OpenStreetMap e o Overture Maps), confere uma imagem renderizada do mapa antes de responder e coloca um botão Undo changes embaixo de cada resposta.

Rodei exatamente a mesma frase sobre Pune duas vezes no QGIS 3.44.15 (permissões Balanced, esforço Medium).

Na primeira execução, depois de 11 segundos, o painel parou e mostrou um cartão de esclarecimento perguntando "Which subdivisions of Pune should the school counts use?", com duas opções clicáveis: Pune city wards e Pune district tehsils. Ao escolher Pune city wards, o tempo total, do clique em Enviar ao fim, foi de 63 segundos em 15 etapas.

Na segunda execução, num chat novo, ele não fez a pergunta; disse na resposta que estava usando os 58 distritos eleitorais de Pune como os distritos da cidade e terminou em cerca de 45 segundos (16 etapas), com os distritos numa paleta laranja.

Por que as duas execuções deram certo enquanto os scripts colados batiam em erros de conexão? Porque o agente não chamou o endpoint sobrecarregado overpass-api.de a partir de um script bruto; ele buscou os distritos eleitorais de 2022 no DataMeet e as 256 escolas (108 nós e 148 vias, convertendo as escolas em polígono em pontos de superfície) pelas suas ferramentas de dados embutidas. Quando rodei uma conferência independente de ponto em polígono nos dois resultados, os 256 pontos de escolas ficaram dentro dos 58 distritos eleitorais, sem nenhuma divergência com o campo de atributo schools.

Ele também manteve a árvore de camadas organizada, guardando três camadas intermediárias num grupo oculto Working layers, e me lembrou na resposta que o OpenStreetMap não é um censo escolar oficial. Minha única queixa: entre a execução 1 e a execução 2, ele mudou de ideia sobre perguntar se eu queria distritos eleitorais ou tehsils, ou decidir sozinho.

Teste o AI Agent grátis no QGIS, sem cartão

Qual caminho escolher?

No meu próprio trabalho, ainda uso o Claude puro no navegador ou no terminal quando estou escrevendo um script de Processamento reutilizável ou depurando um plugin personalizado espalhado por vinte arquivos. Nesses casos, você quer ler o Python, fazer o commit no Git e rodar fora da interface. Só lembre de colar no prompt a versão do QGIS, os nomes das camadas, os nomes dos campos e o SRC, e conte com corrigir um ou dois imports.

Escolha Claude + QGIS MCP se você já tem uma assinatura paga do Claude, se sente à vontade com o uv e com arquivos de configuração JSON e quer misturar operações em arquivos locais com chamadas ao QGIS no Claude Desktop ou no Claude Code. Não custa nada além do plano que você já tem e é rápido quando as camadas de dados já estão carregadas.

Escolha um agente dentro do QGIS quando quiser o mapa e os números sem ficar vigiando tracebacks de Python, timeouts do Overpass ou portas quebradas. Para um analista com prazo apertado ou uma equipe que precisa de simbologia consistente, citação das fontes de dados e um Desfazer com um clique, ter o agente e o catálogo de dados dentro do QGIS é o que mais economiza tempo. Você pode ler como a arquitetura difere no nosso guia sobre o que é um agente de IA no QGIS, ou ver todas as ferramentas atuais no hub de IA do QGIS.

Como medimos. Todas as execuções de Pune aconteceram em 7 de novembro de 2026, entre 10h29 e 11h03, horário de Paris, em macOS com o QGIS 3.44.15-Solothurn (Qt 5.15.19). Os critérios de sucesso foram escritos às 10h14, antes do primeiro prompt. O Claude Sonnet 5.5 (claude-sonnet-5-5) foi chamado pelo Claude Code 2.1.306 (claude -p --safe-mode --tools "" --model sonnet) num diretório vazio, sem servidores MCP nem acesso à web; os dois scripts devolvidos foram executados no Python do QGIS e conferidos com um script independente de ponto em polígono. O AI Agent 1.9.4 (modo Balanced, esforço Medium) rodou duas vezes com a mesma frase em projetos limpos. Outras sessões do QGIS rodavam no mesmo Mac durante os testes, então os tempos são mais lentos do que numa máquina ociosa. Duas execuções por caminho numa única tarefa são uma amostra pequena, e a recusa de conexão do overpass-api.de foi observada a partir de uma rede, numa manhã.

Perguntas frequentes

Existe um plugin oficial do Claude para o QGIS?

Não. A Anthropic não publica um plugin para o QGIS. Em 7 de novembro de 2026, o repositório de complementos do QGIS tinha nove plugins da comunidade que conectam o Claude ao QGIS, seja por um servidor local de Model Context Protocol (MCP) (como o QGIS MCP e o WAI QGIS MCP), pela sua própria chave de API ou por um login local do Claude Code (Mapsuke). Como alternativa, o AI Agent se instala direto pelo gerenciador de complementos do QGIS, com o modelo de IA e o catálogo de dados já incluídos.

O Claude Desktop consegue controlar o QGIS de graça?

Sim, com limites. Segundo a documentação de planos da Anthropic, o chat do Claude Desktop está disponível no plano Free e aceita servidores MCP locais pelo claude_desktop_config.json ou pelas Desktop Extensions (.mcpb). Rodar o Claude Code no terminal exige um plano pago Claude Pro, Max ou Ultra.

O Claude consegue escrever código PyQGIS que roda no QGIS 3.44?

Sim, o Claude Sonnet 5.5 escreve PyQGIS bem estruturado, mas como não enxerga a sua instalação do QGIS nem testa o próprio código, às vezes inventa nomes de classes ou depende de servidores externos que falham. No nosso teste com duas amostras no QGIS 3.44.15, um script falhou com ImportError em QgsClassificationNaturalBreaks (a classe real é QgsClassificationJenks) e o outro falhou até trocarmos a URL da API do Overpass.

Qual é o jeito mais fácil de usar IA dentro do QGIS sem configurar MCP?

Instale um plugin de agente integrado em Complementos > Gerenciar e Instalar Complementos no QGIS. Com o AI Agent, não há ambiente Python, gerenciador de pacotes uv nem arquivo de configuração para manter: você entra de graça, ganha 5 tarefas por mês (300 no Pro) e digita o pedido no painel acoplado.

Teste o AI Agent grátis