O que é QGIS MCP?
O QGIS MCP, mantido por Nicolas Karasiak, conecta um cliente MCP a um QGIS Desktop em execução por meio de um plugin do QGIS. O plugin, instalado pelo próprio gerenciador de complementos do QGIS, roda um servidor de sockets TCP dentro do loop de eventos do QGIS na porta 9876 do localhost; o servidor MCP, executado com uvx a partir do arquivo do GitHub, transforma chamadas de ferramentas em comandos PyQGIS. Ele suporta do QGIS 3.28 ao 4.x e documenta a configuração para Claude Code, Codex, Gemini CLI, Cursor, VS Code, Claude Desktop e cerca de dez outros clientes.
Este é o servidor de QGIS com manutenção ativa. O mais conhecido jjsantos01/qgis_mcp, com cerca de 1.140 estrelas, não recebe commits desde 1º de outubro de 2025. O nkarasiak/qgis-mcp foi criado em março de 2026, tem cerca de 403 estrelas e lançou a v0.15.2 em 17 de outubro de 2026. O plugin é GPL v2 ou posterior e o servidor MCP, MIT.
Como instalar QGIS MCP
uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-serverQGIS MCP vale a pena?
O QGIS MCP vai muito além das demos de "carregue uma camada e renderize" em que a maioria dos servidores de SIG para. Suas 125 ferramentas cobrem projetos, camadas, edição de feições com commit e rollback, calculadora de campos, estilos, conexões PostgreSQL e SQL, calculadora raster e estatísticas zonais, toda a caixa de ferramentas Processing, incluindo modelos e tarefas em segundo plano, layouts de impressão e atlas, além de checkpoints que fazem um snapshot da sessão antes que um agente a altere. As ferramentas trazem anotações readOnly, destructive e idempotent, então um cliente que as respeita pede confirmação antes de apagar feições.
O design mostra atenção ao custo de contexto. No modo granular padrão a lista de ferramentas é grande; definir QGIS_MCP_TOOL_MODE=compound a agrupa em 27 ferramentas que recebem uma ação e parâmetros, com todos os comandos ainda acessíveis. Um único servidor também pode operar várias janelas do QGIS em portas diferentes, cada uma com sua própria conexão e lock, embora isso não funcione no modo compound, e o servidor se recusa a iniciar em vez de enviar escritas para a janela errada.
O risco está em uma ferramenta. A execute_code roda PyQGIS arbitrário e, por padrão, o socket não tem autenticação: ele escuta no localhost, mas qualquer processo local que alcance a porta 9876 pode operar o QGIS. Um segredo compartilhado QGIS_MCP_TOKEN fecha esse acesso a outros usuários, e o plugin se recusa a escutar em um endereço que não seja de loopback sem ele, o que é o padrão correto. A linha de instalação baixa o arquivo da branch main do GitHub em vez de um pacote com versão fixa, então uma atualização na main muda o que roda na próxima atualização.
Diante do servidor mais antigo de jjsantos01, a escolha não é difícil: aquele projeto tem mais estrelas e nenhum commit em treze meses, enquanto este publica correções a cada poucas semanas e tem uma única issue aberta. O limite é o mesmo de toda ponte com o QGIS: o modelo precisa conhecer bem PyQGIS e os nomes dos algoritmos do Processing, e um CRS errado ou uma reprojeção silenciosa são tão fáceis de cometer para um agente quanto para um analista júnior.
Onde ele se destaca
Uma analista de planejamento em uma prefeitura
Produzir uma série de mapas de lotes para cada distrito a partir de um modelo
Peça ao agente que carregue as camadas de lotes e distritos, monte um layout com mapa, legenda e barra de escala, configure um atlas por distrito e use export_atlas para PDF. Gratuito; o ganho é a hora de ajustes de layout economizada por série.
Um consultor ambiental avaliando áreas para um cliente
Calcular estatísticas de cobertura do solo para 40 áreas candidatas
Peça zonal_statistics de um raster de cobertura do solo sobre os polígonos das áreas e exporte a tabela. Crie um checkpoint antes, para que um cálculo de campo errado possa ser revertido.
Um desenvolvedor de SIG que escreve plugins para o QGIS
Fazer um agente de programação testar mudanças no plugin contra um QGIS em execução
Use reload_plugin e get_message_log a partir do Claude Code para iterar sem reiniciar o QGIS. Defina QGIS_MCP_TOKEN em uma estação de trabalho compartilhada, já que, sem isso, a execute_code fica acessível a qualquer processo local.
Antes de decidir
- Configuração
- Instale o plugin QGIS MCP pelo gerenciador de complementos do QGIS, reinicie o QGIS e clique em Start Server; depois adicione uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server ao cliente. A ferramenta ping retorna pong quando os dois lados estão conectados; diagnose verifica as versões após atualizações.
- Integrações
- 125 ferramentas para projeto, camadas, feições, edição, estilos, conexões, renderização, processamento, layouts, atlas, consultas e sistema, ou 27 no modo compound. Streamable HTTP está disponível via QGIS_MCP_TRANSPORT, e QGIS_MCP_INSTANCES opera várias janelas do QGIS.
- Dados e privacidade
- Tudo roda localmente; dados do mapa e atributos vão para o seu provedor de modelos pelo cliente. O socket em localhost:9876 não tem autenticação, a menos que QGIS_MCP_TOKEN seja definido, e a execute_code roda PyQGIS arbitrário. Camadas web e conexões PostgreSQL buscam dados externos que o modelo depois lê.
- Custo em escala
- Gratuito. O custo real são os tokens: a lista granular de 125 ferramentas pesa em toda sessão, e o modo compound a reduz a 27 ferramentas.
- Limites
- Um servidor mais novo conversando com um plugin mais antigo retorna erros até que ambos sejam atualizados; várias instâncias exigem o modo granular. Processamentos longos informam o progresso pelo logging do MCP em vez de bloquear o cliente.
O que é bom
- 125 ferramentas, incluindo Processing, layouts, atlas e SQL
- O modo compound reduz a lista a 27 ferramentas
- Anotações de ferramentas destrutivas e checkpoints de sessão
- Autenticação por token opcional; sem ela, recusa escutar na rede
O que não é
- execute_code roda PyQGIS arbitrário
- Sem autenticação no socket local por padrão
- Instala a partir do arquivo da branch main, sem versão fixa
- As versões do plugin e do servidor precisam andar juntas
Ideal para
Analistas de SIG e planejadores urbanos que querem que um agente execute fluxos de trabalho repetíveis do QGIS no próprio desktop.
Alternativas ao QGIS MCP
QGIS MCP: perguntas frequentes
- QGIS MCP vale a pena?
- Uma ponte com o QGIS completa e bem construída, que cobre trabalho real de SIG, do processamento aos atlas, desde que você respeite a ferramenta de código arbitrário que vem junto. Damos nota 4.0 de 5.
- Quanto custa QGIS MCP?
- Gratuito e de código aberto (servidor MCP MIT, plugin do QGIS GPL-2.0-or-later). O próprio QGIS é gratuito.
- Quais são as desvantagens de QGIS MCP?
- execute_code roda PyQGIS arbitrário; sem autenticação no socket local por padrão; instala a partir do arquivo da branch main, sem versão fixa; as versões do plugin e do servidor precisam andar juntas.
- Para quem QGIS MCP é indicado?
- Analistas de SIG e planejadores urbanos que querem que um agente execute fluxos de trabalho repetíveis do QGIS no próprio desktop.
- Quanto custa QGIS MCP para uma equipe ou em produção?
- Gratuito. O custo real são os tokens: a lista granular de 125 ferramentas pesa em toda sessão, e o modo compound a reduz a 27 ferramentas.
- QGIS MCP é seguro para dados da empresa?
- Tudo roda localmente; dados do mapa e atributos vão para o seu provedor de modelos pelo cliente. O socket em localhost:9876 não tem autenticação, a menos que QGIS_MCP_TOKEN seja definido, e a execute_code roda PyQGIS arbitrário. Camadas web e conexões PostgreSQL buscam dados externos que o modelo depois lê.
- Quais são as melhores alternativas ao QGIS MCP?
- As alternativas mais próximas que analisamos são Google Maps Grounding Lite e MCP for Blender.
Respostas verificadas em 31 de out. de 2026.