Tudo isso utilizando linguagem natural.<\/p>\n
<\/p>\n
Pr\u00e9-requisitos<\/h1>\n
Antes de come\u00e7ar, voc\u00ea precisar\u00e1 ter:<\/p>\n
- \n
- QGIS instalado<\/li>\n
- Conta no Claude AI<\/li>\n
- Claude Desktop<\/li>\n
- Python instalado<\/li>\n<\/ul>\n
<\/p>\n
Etapa 1 \u2014 Criar uma conta no Claude<\/h1>\n
Acesse: https:\/\/claude.ai<\/a><\/p>\n
Clique em Sign Up<\/strong> e crie sua conta.<\/p>\n
Ap\u00f3s a cria\u00e7\u00e3o, fa\u00e7a login normalmente.<\/p>\n
<\/p>\n
Etapa 2 \u2014 Instalar o Claude Desktop<\/h1>\n
Baixe o Claude Desktop diretamente do site oficial: https:\/\/claude.ai\/download<\/a> e selecione a vers\u00e3o para Windows.<\/p>\n
Ap\u00f3s a instala\u00e7\u00e3o:<\/p>\n
- \n
- Abra o Claude Desktop.<\/li>\n
- Fa\u00e7a login com sua conta.<\/li>\n
- Verifique se o aplicativo abre normalmente.<\/li>\n<\/ol>\n
Feche o Claude antes de continuar.<\/p>\n
<\/p>\n
Etapa 3 \u2014 Instalar o UV<\/h1>\n
O QGIS MCP utiliza o UV para executar o servidor MCP.<\/p>\n
Abra o Prompt de Comando do Windows e execute:<\/p>\n
pip install uv<\/pre>\n
Ap\u00f3s a instala\u00e7\u00e3o, valide:<\/p>\n
uv --version<\/pre>\n
ou<\/p>\n
uvx --version<\/pre>\n
O resultado dever\u00e1 ser semelhante a:<\/p>\n
uvx 0.11.21<\/pre>\n
Tamb\u00e9m \u00e9 interessante verificar onde o execut\u00e1vel foi instalado:<\/p>\n
where uvx<\/pre>\n
Exemplo:<\/p>\n
C:\\Users\\Fernando\\.local\\bin\\uvx.exe<\/pre>\n
Guarde esse caminho, pois ele ser\u00e1 utilizado na configura\u00e7\u00e3o do Claude.<\/p>\n
<\/p>\n
Etapa 4 \u2014 Instalar o plugin QGIS MCP<\/h1>\n
Abra o QGIS.<\/p>\n
Acesse:<\/p>\n
Complementos \u2192 Gerenciar e Instalar Complementos<\/pre>\n
Pesquise por:<\/p>\n
QGIS MCP<\/pre>\n
Instale o plugin.<\/p>\n
![\"\"](\"https:\/\/www.fernandoquadro.com.br\/html\/wp-content\/uploads\/2026\/06\/mcp_qgis_plugin.png\")
<\/p>\nAp\u00f3s a instala\u00e7\u00e3o:<\/p>\n
- \n
- Ative o plugin.<\/li>\n
![\"\"](\"https:\/\/www.fernandoquadro.com.br\/html\/wp-content\/uploads\/2026\/06\/mcp_qgis.png\")
<\/p>\n - Verifique se o servidor est\u00e1 rodando.<\/li>\n
![\"\"](\"https:\/\/www.fernandoquadro.com.br\/html\/wp-content\/uploads\/2026\/06\/mcp_qgis_9876.png\")
<\/p>\n<\/ol>\nO plugin iniciar\u00e1 um servi\u00e7o local que permitir\u00e1 ao Claude acessar o QGIS.<\/p>\n
<\/p>\n
Etapa 5 \u2014 Configurar o Claude Desktop<\/h1>\n
O Claude Desktop utiliza um arquivo JSON para registrar servidores MCP.<\/p>\n
Localize o arquivo de configura\u00e7\u00e3o do Claude.<\/p>\n
![\"\"](\"https:\/\/www.fernandoquadro.com.br\/html\/wp-content\/uploads\/2026\/06\/claude_config.png\")
<\/p>\nAo abrir a tela de configura\u00e7\u00f5es, v\u00e1 na op\u00e7\u00e3o Developer<\/strong> (Desenvolvedor), e clique no bot\u00e3o Editar Config<\/strong>.<\/p>\n
![\"\"](\"https:\/\/www.fernandoquadro.com.br\/html\/wp-content\/uploads\/2026\/06\/claude_config_dev.png\")
<\/p>\nO Claude ir\u00e1 abrir uma tela do Windows Explorer com o arquivo claude_desktop_config.json<\/strong> selecionado. Voc\u00ea dever editar esse arquivo e inserir a seguinte configura\u00e7\u00e3o:<\/p>\n
{\r\n \"mcpServers\": {\r\n \"qgis\": {\r\n \"command\": \"C:\\\\Users\\\\SEU_USUARIO\\\\.local\\\\bin\\\\uvx.exe\",\r\n \"args\": [\r\n \"--from\",\r\n \"https:\/\/github.com\/nkarasiak\/qgis-mcp\/archive\/refs\/heads\/main.zip\",\r\n \"qgis-mcp-server\"\r\n ],\r\n \"env\": {\r\n\t\t\"PATH\": \"C:\\\\Users\\\\SEU_USUARIO\\\\.local\\\\bin;C:\\\\Windows\\\\System32;C:\\\\Windows\"\r\n }\r\n }\r\n }\r\n}<\/pre>\nImportante:<\/strong><\/p>\n
Substitua o caminho do comando pelo caminho retornado pelo comando:<\/p>\n
where uvx<\/pre>\n
Exemplo:<\/p>\n
\"command\": \"C:\\\\Users\\\\Fernando\\\\.local\\\\bin\\\\uvx.exe\"<\/pre>\n
Salve o arquivo.<\/p>\n
<\/p>\n
Etapa 6 \u2014 Reiniciar os componentes<\/h1>\n
Ap\u00f3s salvar o JSON:<\/p>\n
- \n
- Feche completamente o Claude Desktop.<\/li>\n
- Abra o QGIS.<\/li>\n
- Verifique se o plugin QGIS MCP est\u00e1 ativo.<\/li>\n
- Abra novamente o Claude Desktop.<\/li>\n<\/ol>\n
Caso tudo esteja correto, o Claude dever\u00e1 carregar automaticamente o servidor MCP do QGIS.<\/p>\n
<\/p>\n
Etapa 7 \u2014 Testar a comunica\u00e7\u00e3o<\/h1>\n
Abra um projeto qualquer no QGIS.<\/p>\n
Em seguida fa\u00e7a perguntas ao Claude como:<\/p>\n
Liste todas as camadas abertas no QGIS.<\/pre>\n
ou<\/p>\n
Qual \u00e9 o sistema de coordenadas da camada munic\u00edpios?<\/pre>\n
ou ainda:<\/p>\n
Mostre os atributos da camada escolas.<\/pre>\n
Se o MCP estiver funcionando corretamente, o Claude responder\u00e1 utilizando informa\u00e7\u00f5es diretamente do QGIS.<\/p>\n
![\"\"](\"https:\/\/www.fernandoquadro.com.br\/html\/wp-content\/uploads\/2026\/06\/claude_qgis.png\")
<\/p>\n<\/p>\n
Diagn\u00f3stico de problemas<\/h1>\n
Erro: Could not attach to MCP server qgis<\/h4>\n
Esse erro normalmente indica que:<\/p>\n
- \n
- O UV n\u00e3o est\u00e1 instalado.<\/li>\n
- O caminho do uvx.exe est\u00e1 incorreto.<\/li>\n
- O JSON est\u00e1 com erro de sintaxe.<\/li>\n
- O plugin QGIS MCP n\u00e3o est\u00e1 ativo.<\/li>\n<\/ul>\n
<\/p>\n
Testando manualmente o servidor MCP<\/h2>\n
Abra o Prompt de Comando:<\/p>\n
C:\\Users\\SEU_USUARIO\\.local\\bin\\uvx.exe --from \"https:\/\/github.com\/nkarasiak\/qgis-mcp\/archive\/refs\/heads\/main.zip\" qgis-mcp-server<\/pre>\n
Se tudo estiver correto, dever\u00e1 aparecer algo semelhante a:<\/p>\n
QgisMCPServer starting up\r\nwill connect to QGIS at localhost:9876<\/pre>\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Prezado Leitor, A integra\u00e7\u00e3o entre Intelig\u00eancia Artificial e Sistemas de Informa\u00e7\u00e3o Geogr\u00e1fica (SIG) est\u00e1 evoluindo rapidamente. Hoje j\u00e1 \u00e9 poss\u00edvel conectar o Claude AI diretamente ao QGIS atrav\u00e9s do protocolo MCP (Model Context Protocol), permitindo que a IA consulte camadas,… Continue Reading →<\/a><\/p>\n","protected":false},"author":275,"featured_media":10338,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-10329","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-diversos"],"_links":{"self":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts\/10329","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/users\/275"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/comments?post=10329"}],"version-history":[{"count":16,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts\/10329\/revisions"}],"predecessor-version":[{"id":10352,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts\/10329\/revisions\/10352"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/media\/10338"}],"wp:attachment":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/media?parent=10329"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/categories?post=10329"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/tags?post=10329"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- Ative o plugin.<\/li>\n