Se você usa Claude Code no dia a dia, já sabe o poder que um agente de IA tem para editar arquivos, refatorar código e automatizar tarefas no terminal. Mas e se ele pudesse também navegar pelo sistema de arquivos com precisão cirúrgica, abrir issues no GitHub, consultar bancos de dados PostgreSQL e ler planilhas Excel — tudo isso sem sair da CLI? É exatamente isso que as MCP tools Claude Code proporcionam.
O Model Context Protocol (MCP) permite conectar seu agente a ferramentas externas que expandem drasticamente o que ele consegue fazer. Neste guia, você vai conhecer as melhores MCP tools para o dia a dia de desenvolvimento no Windows: como instalar, configurar e usar cada uma delas em cenários reais. Não importa se você é veterano do Claude Code ou está dando os primeiros passos — este guia cobre desde o conceito básico até combinações avançadas de múltiplas ferramentas.
Sumário
- O que são MCP tools Claude Code e por que você precisa delas
- Filesystem: navegue e edite arquivos com segurança
- GitHub: gerencie repositórios sem sair do terminal
- PostgreSQL: consulte bancos de dados em linguagem natural
- SQLite: base de dados local leve e sem servidor
- Como instalar MCP tools no Windows (passo a passo)
- Combinações poderosas: usando várias MCP tools juntas
- FAQ
- Comece agora
O que são MCP tools Claude Code e por que você precisa delas
MCP tools são extensões que seguem o Model Context Protocol, um padrão aberto da Anthropic que permite que agentes de IA se conectem a serviços externos de forma padronizada. Pense em cada MCP tool como um "plugin" que dá ao Claude Code uma habilidade nova — ler arquivos, chamar APIs, executar consultas SQL — com comunicação via JSON-RPC.
Como funciona na prática
Quando você pede ao Claude Code algo como "leia o arquivo config.json na pasta src", ele normalmente tentaria adivinhar o caminho ou pedir mais informações. Com uma MCP tool de filesystem conectada, ele simplesmente chama a ferramenta, que retorna o conteúdo exato do arquivo. A diferença é sutil no comando, mas enorme no resultado: respostas precisas, sem suposições.
Por que usar MCP tools em vez de comandos manuais?
- Precisão: a ferramenta acessa o recurso real — arquivo, banco, repositório — não uma estimativa do modelo.
- Segurança: você controla quais ferramentas estão disponíveis e qual escopo cada uma tem.
- Reusabilidade: uma vez configurada, a MCP tool fica disponível em todos os projetos.
- Velocidade: o agente não precisa "pensar" sobre como acessar um recurso — ele simplesmente chama a ferramenta.
Imagem sugerida: Diagrama conceitual mostrando Claude Code conectado a várias MCP tools (filesystem, GitHub, PostgreSQL) via o protocolo MCP, com setas de requisição/resposta em JSON-RPC.
GitHub: gerencie repositórios sem sair do terminal
A MCP tool do GitHub é uma das mais poderosas para times de desenvolvimento. Ela conecta o Claude Code diretamente à API do GitHub, permitindo criar issues, revisar pull requests, gerenciar repositórios e consultar o código-fonte remoto — tudo por comando de voz ou texto no terminal.
O que ela faz
- Issues: criar, listar, fechar e comentar em issues.
- Pull requests: abrir PRs, revisar diffs, aprovar ou solicitar mudanças.
- Repositórios: criar, forkar, buscar e listar repositórios.
- Código: ler arquivos do repositório remoto sem clonar.
- Branches: criar, listar e mesclar branches.
- Commits: consultar histórico e diff de commits.
Quando usar
Em fluxos de desenvolvimento que envolvem GitHub: abrir um PR depois que o Claude Code termina uma feature, revisar o diff de um PR aberto por um colega, ou até criar uma issue para documentar um bug encontrado durante a análise de código.
Exemplo de uso
O Claude Code usa a MCP tool GitHub para buscar o diff do PR, analisa cada arquivo modificado, identifica padrões problemáticos (senhas hardcoded, SQL injection, falta de validação) e posta o review diretamente na thread do PR.
Configuração
Antes de configurar, gere um token de acesso pessoal no GitHub (Settings > Developer settings > Personal access tokens > Fine-grained tokens) com permissões de issues, pull requests e contents.
Dica de segurança
Use um token fine-grained vinculado apenas aos repositórios que o agente precisa acessar. Evite tokens clássicos com escopo irrestrito. Armazene o token em variável de ambiente do sistema (GITHUB_TOKEN) em vez de colocá-lo diretamente no arquivo de configuração.
Imagem sugerida: Pull request no GitHub com comentário automático gerado pelo Claude Code via MCP tool, apontando sugestões de melhoria no diff.
PostgreSQL: consulte bancos de dados em linguagem natural
Uma das MCP ferramentas essenciais para quem trabalha com backend é a tool de PostgreSQL. Ela permite que o Claude Code se conecte a um banco de dados PostgreSQL, explore o schema, execute consultas e analise resultados — tudo em linguagem natural.
O que ela faz
- Listar tabelas e schemas: explora a estrutura completa do banco.
- Executar consultas SELECT: com parâmetros e limites de segurança.
- Descrever tabelas: colunas, tipos, chaves estrangeiras e constraints.
- Analisar resultados: formata e sumariza dados retornados.
Quando usar
Sempre que você precisar extrair informações de um banco de dados PostgreSQL sem abrir um client SQL. Em vez de escrever uma query manualmente, você pede em português: "quantos usuários se cadastraram nos últimos 7 dias?" e o Claude Code gera a query, executa e retorna a resposta.
Exemplo de uso
Com a MCP tool PostgreSQL, o Claude Code executa as queries, processa os resultados e devolve um relatório organizado — sem você precisar digitar uma linha de SQL.
Configuração
Importante: nunca use credenciais de produção com permissão de escrita. Crie um usuário dedicado no banco com acesso read-only para o agente. A string de conexão pode ser armazenada em variável de ambiente.
Limitações de segurança
Por padrão, a ferramenta só permite comandos SELECT — operações de escrita (INSERT, UPDATE, DELETE, DROP) são bloqueadas. Isso evita que o agente modifique dados acidentalmente. Se você precisar de escrita, crie uma ferramenta customizada com validações adicionais.
Imagem sugerida: Terminal PowerShell mostrando Claude Code executando uma consulta SQL via MCP tool PostgreSQL, com o resultado formatado em tabela e a query gerada exibida acima.
SQLite: base de dados local leve e sem servidor
Se o PostgreSQL é o canhão, o SQLite é o canivete suíço das MCP tools recomendadas para Claude Code. Ideal para bancos locais, arquivos de configuração, caches e prototipagem rápida. Não precisa de servidor, não precisa de credenciais — só do arquivo .db.
O que ela faz
- Consultar bancos SQLite: qualquer query
SELECTem arquivos.db,.sqlite,.sqlite3. - Explorar schema: tabelas, índices, views e triggers.
- Analisar dados: agrupamentos, filtros e ordenações.
- Criar tabelas temporárias: para análises intermediárias sem modificar o banco original.
Quando usar
Projetos que usam SQLite como banco local (aplicações desktop, protótipos, testes), ou quando você precisa extrair dados de um arquivo .db sem instalar ferramentas externas.
Exemplo de uso
O Claude Code consulta o SQLite diretamente, sem precisar instalar o sqlite3-cli ou configurar conexão.
Configuração
Para múltiplos bancos, configure uma instância para cada arquivo ou use um servidor customizado que aceite o caminho como parâmetro.
Diferença prática entre PostgreSQL e SQLite
| Aspecto | PostgreSQL | SQLite |
|---|---|---|
| Servidor | Necessário (local ou remoto) | Nenhum (arquivo local) |
| Conexão | String de conexão com credenciais | Apenas o caminho do arquivo |
| Performance | Excelente em dados relacionais grandes | Ideal para bancos pequenos/médios |
| Escrita | Bloqueada por padrão (segurança) | Leitura apenas (recomendado) |
| Uso típico | Produção, dados compartilhados | Desenvolvimento, protótipos, caches |
Como instalar MCP tools no Windows (passo a passo)
Configurar MCP tools Claude Code no Windows é mais simples do que parece. O ecossistema foi projetado para funcionar com Node.js via npx, então não há dependências complexas ou compilações. Veja o passo a passo para instalar todas as ferramentas que vimos até aqui.
1. Verifique os pré-requisitos
Você precisa do Node.js (v18 ou superior) e do Claude Code instalados. Confirme no PowerShell:
Se o Claude Code não estiver instalado:
2. Localize o arquivo de configuração
O Claude Code no Windows lê a configuração de MCP tools em dois lugares:
- Global (todos os projetos):
%APPDATA%\Claude\config.json - Local (projeto específico):
claude.jsonna raiz do projeto
Para este guia, vamos usar o arquivo global. Crie ou edite:
3. Configure todas as tools de uma vez
Cole a configuração abaixo e ajuste os caminhos, tokens e strings de conexão conforme seu ambiente:
4. Teste a instalação
Abra o Claude Code no terminal e pergunte:
O Claude Code lista todas as ferramentas configuradas. Se alguma não aparecer, verifique o arquivo de configuração e os caminhos.
5. Debug de problemas comuns
| Problema | Causa provável | Solução |
|---|---|---|
| Tool não aparece na lista | Caminho do arquivo .db ou diretório incorreto | Use caminho absoluto com barras duplas (`\\`) |
| Erro de conexão PostgreSQL | String de conexão inválida ou banco offline | Teste com `psql` antes de configurar |
| GitHub retorna 401 | Token inválido ou expirado | Gere um novo token em github.com/settings/tokens |
| npx demora para iniciar | Cache npm vazio | Primeira execução baixa o pacote; as seguintes são instantâneas |
6. Dica adicional: variáveis de ambiente
Para não expor tokens e senhas no arquivo de configuração, use variáveis de ambiente do Windows:
Depois, no config.json, referencie as variáveis:
Imagem sugerida: Print do arquivo config.json aberto no Bloco de Notas ou VS Code, mostrando a configuração completa das 4 MCP tools lado a lado.
Combinações poderosas: usando várias MCP tools juntas
O verdadeiro potencial de estender Claude Code com MCP tools aparece quando você combina múltiplas ferramentas em um único fluxo de trabalho. O agente não está limitado a uma tool por vez — ele pode encadear chamadas para cumprir tarefas complexas.
Cenário 1: Auditoria de segurança de banco + repositório
O Claude Code usa a MCP tool PostgreSQL para escanear o schema do banco, depois a MCP tool GitHub para buscar no código remoto — e gera um relatório completo de vulnerabilidades.
Cenário 2: Deploy assistido
Em segundos, o Claude Code executa as quatro etapas e entrega um checklist de deploy. Sem MCP tools, você levaria minutos alternando entre terminal, navegador e client SQL.
Cenário 3: Análise de dados local
O agente consulta o SQLite, formata os dados, escreve o arquivo com a tool filesystem, e abre o pull request com a tool GitHub — tudo em sequência, sem intervenção manual.
Orquestrando com múltiplos agentes
Quando você combina MCP tools com múltiplos agentes de IA, o potencial cresce ainda mais. Imagine o Claude Code usando a tool de filesystem para analisar o código enquanto o Codex (conectado ao mesmo banco PostgreSQL) executa consultas de validação — ambos rodando em paralelo no mesmo projeto. É exatamente esse tipo de orquestração que o Orquestra foi projetado para suportar, com terminais independentes e contexto sincronizado entre agentes.
Imagem sugerida: Canvas do Orquestra mostrando três terminais lado a lado: Claude Code usando filesystem + GitHub, Codex consultando PostgreSQL, e um terceiro terminal exibindo o resultado consolidado.
FAQ
O que são MCP tools e como funcionam no Claude Code?
MCP tools são extensões baseadas no Model Context Protocol (MCP) que permitem ao Claude Code interagir com sistemas externos — arquivos, bancos de dados, APIs — de forma padronizada via JSON-RPC. Cada tool expõe funções específicas que o agente pode chamar quando necessário.
Quais são as melhores MCP tools para começar no Windows?
Filesystem é a mais essencial — ela dá ao Claude Code acesso estruturado a arquivos e diretórios. GitHub é indispensável para times que usam repositórios remotos. PostgreSQL e SQLite são excelentes para quem trabalha com dados. Todas rodam via npx no Windows sem configuração adicional.
Preciso instalar algo além do Node.js para usar MCP tools?
Não. As MCP tools oficiais da Anthropic são pacotes npm executados via npx. Com Node.js v18+ instalado, basta configurar o arquivo claude.json e as ferramentas serão baixadas e executadas automaticamente na primeira chamada.
MCP tools funcionam com outros agentes além do Claude Code?
Sim. O protocolo MCP é aberto e qualquer agente que implemente o lado cliente pode usar as mesmas ferramentas. O Orquestra, por exemplo, suporta MCP tools nativamente, permitindo compartilhar as mesmas extensões entre Claude Code, Codex e OpenCode no mesmo canvas.
É seguro dar acesso ao banco de dados via MCP tool?
Sim, desde que você tome precauções. Crie um usuário read-only no banco, nunca use credenciais de produção com permissão de escrita, e prefira bancos de staging ou desenvolvimento. A tool PostgreSQL bloqueia comandos de escrita por padrão. Com SQLite, a ferramenta opera em modo read-only.
Quantas MCP tools posso configurar ao mesmo tempo?
Quantas você quiser. Não há limite do protocolo. Na prática, recomenda-se começar com 3 a 5 ferramentas e adicionar conforme a necessidade. Cada tool adiciona latência na inicialização do Claude Code (já que os servidores precisam ser carregados), mas o impacto é mínimo com ferramentas leves como filesystem e SQLite.
Comece agora
As MCP tools Claude Code transformam seu agente de um assistente de código em um verdadeiro engenheiro de software — capaz de navegar pelo sistema de arquivos, gerenciar repositórios, consultar bancos de dados e orquestrar fluxos complexos, tudo pelo terminal do Windows.
Neste guia, você viu:
- Filesystem — navegação e edição segura de arquivos.
- GitHub — issues, PRs e repositórios sem abrir o navegador.
- PostgreSQL — consultas a bancos relacionais em linguagem natural.
- SQLite — análise de dados locais sem servidor.
- Instalação Windows — configuração passo a passo com exemplos reais.
- Combinações — fluxos multicamada que integram todas as ferramentas.
O próximo passo é levar essa orquestração para o próximo nível. Com o Orquestra, você conecta Claude Code, Codex e OpenCode no mesmo canvas, com MCP tools compartilhadas entre todos os agentes — multiplique a produtividade sem multiplicar a complexidade.
👉 Baixe o Orquestra para Windows 11 e comece seu teste gratuito de 7 dias.
👉 Conheça os planos para times que querem estender Claude Code com MCP tools e orquestrar agentes em escala.
Links internos recomendados
- MCP Server Windows — Crie ferramentas personalizadas para agentes de IA — tutorial completo de como criar seu próprio MCP server do zero
- Orquestração de Agentes de IA: Guia Definitivo para 2026 — conceitos fundamentais de orquestração multi-agente
- Claude Code vs OpenCode — Comparativo técnico para devs Windows — análise detalhada das diferenças entre os agentes
- Automação de Deploy com Agentes de IA — pipeline completo do commit à produção com agentes
- Docker no WSL 2 para Agentes de IA — configure o ambiente Docker ideal para deploys automatizados
Links externos recomendados
- Model Context Protocol (Anthropic) — documentação oficial do protocolo MCP
- MCP Servers Repository (GitHub) — diretório oficial de MCP servers mantido pela Anthropic
- Personal Access Tokens (GitHub) — página para criar tokens de acesso do GitHub
Imagens/GIFs sugeridos para o post
- Diagrama de arquitetura MCP: Claude Code conectado a várias tools (filesystem, GitHub, PostgreSQL, SQLite) com setas de comunicação JSON-RPC
- Filesystem tool: Terminal Windows com Claude Code listando arquivos de um diretório, resultado em tabela formatada
- GitHub PR review: Pull request no GitHub com comentário automático gerado pelo Claude Code via MCP tool
- PostgreSQL query: Terminal executando consulta SQL em linguagem natural, com resultado exibido em tabela
- Config.json: Arquivo de configuração aberto no VS Code ou Bloco de Notas com as 4 MCP tools configuradas
- Canvas Orquestra: Três terminais lado a lado no Orquestra: Claude Code com filesystem/GitHub, Codex com PostgreSQL, resultado consolidado
Posts relacionados
Pronto para orquestrar seus agentes?
Baixe o Orquestra para Windows 11 e comece a coordenar seus agentes de IA em um canvas infinito. Grátis por 7 dias.