📁 O que o Filesystem MCP Faz
🎯 Acesso Expandido ao Sistema de Arquivos
O Filesystem MCP expande o acesso do Claude Code para alem do diretorio onde ele foi iniciado. Por padrao, o Claude so le e escreve arquivos dentro do diretorio atual. Com o Filesystem MCP, ele pode acessar qualquer caminho que voce autorizar no momento da instalacao.
- • read_file: Le conteudo de qualquer arquivo nos caminhos autorizados
- • write_file: Escreve ou cria arquivos nos caminhos permitidos
- • list_directory: Lista conteudo de diretorios fora do projeto
- • search_files: Busca por padrao em arquivos de outros diretorios
📊 Por Que Expandir o Acesso
- Copiar configs e componentes entre projetos sem sair do Claude
- Acessar templates globais que vivem fora do repo atual
- Trabalhar com monorepos ou projetos distribuidos em multiplos diretorios
💡 Dica Pratica
O Filesystem MCP e especialmente util para quem trabalha com multiplos projetos. Em vez de fechar o Claude, navegar para outro diretorio e reabrir, voce simplesmente pede 'leia o componente Button de ~/projetos/outro-repo/src/components/Button.tsx'. Cross-repo sem trocar de sessao.
✓ O que FAZER
- ✓ Usar para acessar arquivos fora do diretorio atual
- ✓ Configurar caminhos especificos e limitados
- ✓ Manter sempre conectado (overhead baixo)
✗ O que NAO fazer
- ✗ Expor a raiz do sistema (/)
- ✗ Expor diretorios sensiveis (~/.ssh, ~/.aws)
- ✗ Usar quando os arquivos estao no diretorio atual (desnecessario)
🏆 Por Que e High-Value
🎯 Maximo Beneficio, Minimo Custo
O Filesystem MCP tem a melhor relacao custo-beneficio de todos os MCPs: apenas ~500 tokens de overhead por mensagem para acesso completo a qualquer diretorio autorizado. E o unico MCP onde a recomendacao e 'mantenha sempre ligado'.
- • ~500 tokens de overhead = menos que um paragrafo de texto
- • Habilita workflow cross-repo sem trocar de sessao
- • ROI altissimo: custo insignificante, beneficio constante
📊 Comparacao de ROI
- Filesystem: 500 tokens → acesso a todo sistema de arquivos = ROI ALTO
- GitHub: 2.000 tokens → acesso a issues/PRs = ROI moderado (so quando trabalhando com GitHub)
- Browser: 5.000 tokens → acesso web = ROI variavel (alto para UI, zero para backend)
💡 Dica Pratica
Pense no Filesystem como o 'MCP que paga seu proprio custo'. Os 500 tokens de overhead sao recuperados na primeira vez que voce evita trocar de sessao para acessar outro diretorio. A partir dai, e lucro puro em produtividade.
✓ O que FAZER
- ✓ Manter Filesystem sempre conectado
- ✓ Usar como seu MCP 'fixo' e rotacionar os outros
- ✓ Calcular o tempo economizado vs 500 tokens de custo
✗ O que NAO fazer
- ✗ Desconectar por economia de tokens (custo negligenciavel)
- ✗ Tratar com o mesmo criterio de MCPs caros (Browser)
- ✗ Hesitar em instalar por medo de overhead
⚙️ Comando de Instalacao
🎯 Setup Rapido
A instalacao e um unico comando. O parametro apos o pacote define quais diretorios o Claude pode acessar. Voce pode especificar multiplos caminhos separados por espaco. Cada caminho e uma whitelist - o Claude so acessa o que voce autorizar.
-
•
claude mcp add filesystem -- npx -y @anthropic/mcp-filesystem ~/projetos -
•
claude mcp add filesystem -- npx -y @anthropic/mcp-filesystem ~/projetos ~/configs - • Multiplos caminhos: separe por espaco. Cada um e um diretorio autorizado.
📊 Configuracao Segura
- Caminhos sao WHITELIST: so o que voce listar e acessivel
- Nunca use / (raiz) - expoe todo o sistema
- Prefira caminhos especificos: ~/projetos, ~/dev, ~/work
💡 Dica Pratica
Comando recomendado para a maioria dos operadores: claude mcp add filesystem -- npx -y @anthropic/mcp-filesystem ~/projetos. Se voce tem configs globais que referencia frequentemente, adicione: claude mcp add filesystem -- npx -y @anthropic/mcp-filesystem ~/projetos ~/.config. Verifique com /status apos instalar.
✓ O que FAZER
- ✓ Usar caminhos especificos e limitados
- ✓ Verificar instalacao com /status
- ✓ Testar com 'liste os arquivos em ~/projetos'
✗ O que NAO fazer
- ✗ Usar / como caminho (expoe tudo)
- ✗ Expor ~/.ssh, ~/.aws, ~/.gnupg
- ✗ Adicionar caminhos desnecessarios 'por precaucao'
💼 Casos de Uso Praticos
🎯 Workflows do Dia a Dia
O Filesystem MCP brilha em cenarios cross-repo e acesso a configs globais. Ele transforma o Claude de 'preso no diretorio atual' para 'agente com visao do sistema inteiro'.
- • Cross-repo: 'copie o componente Header de ~/projetos/site-a para o projeto atual'
- • Configs globais: 'leia meu .gitconfig e sugira aliases uteis'
- • Templates: 'use o template de ~/projetos/templates/api-endpoint.ts como base'
- • Comparacao: 'compare como autenticacao esta implementada em ~/projetos/app-a vs ~/projetos/app-b'
📊 Produtividade Real
- Evita trocar de sessao para referenciar outros projetos
- Permite 'aprender' com implementacoes de outros repos seus
- Facilita padronizacao cross-project copiando patterns
💡 Dica Pratica
Um workflow poderoso: peca ao Claude para analisar como voce resolveu um problema em outro projeto e aplicar a mesma abordagem no atual. 'Leia como implementei auth em ~/projetos/app-saas/src/auth/ e implemente algo similar aqui'. O Claude le o outro projeto e adapta para o contexto atual.
✓ O que FAZER
- ✓ Referenciar implementacoes de outros projetos
- ✓ Copiar patterns testados entre repos
- ✓ Acessar configs e templates globais
✗ O que NAO fazer
- ✗ Usar para arquivos que ja estao no diretorio atual
- ✗ Copiar codigo sem adaptar ao contexto do projeto destino
- ✗ Acessar diretorios de outros usuarios sem permissao
🟢 Token Impact: Low (~500 tokens)
🎯 O MCP Mais Leve
Com apenas ~500 tokens de overhead por mensagem, o Filesystem MCP e praticamente invisible no consumo de contexto. Para perspectiva: 500 tokens e menos do que esta secao de texto que voce esta lendo agora.
- • ~500 tokens = 0.25% da janela de contexto de 200k
- • Em 50 mensagens: 25.000 tokens totais de overhead (aceitavel)
- • Comparacao: Browser MCP custa 10x mais (5.000 tokens)
📊 Numeros em Perspectiva
- 500 tokens/msg e o custo de ~2-3 linhas de codigo no contexto
- Para causar degradacao perceptivel, precisaria de 100+ MCPs como esse
- E o unico MCP onde 'always on' e universalmente recomendado
💡 Dica Pratica
Se alguem sugerir desconectar o Filesystem MCP para economizar tokens, mostre a matematica: 500 tokens x 50 mensagens = 25.000 tokens. Isso e 12.5% de uma unica compactacao. O valor em produtividade cross-repo supera esse custo em ordens de magnitude.
✓ O que FAZER
- ✓ Manter conectado sem preocupacao com overhead
- ✓ Usar como referencia de 'baixo custo' ao comparar MCPs
- ✓ Recomendar como primeiro MCP para novos operadores
✗ O que NAO fazer
- ✗ Desconectar por economia (custo negligenciavel)
- ✗ Comparar overhead com MCPs pesados (nao faz sentido)
- ✗ Hesitar em usar porque 'todo MCP custa tokens'
✅ Best Practices de Seguranca
🎯 Protegendo Seu Sistema
O Filesystem MCP acessa arquivos REAIS do seu sistema. Configuracao descuidada pode expor credenciais, chaves SSH e dados sensiveis ao contexto do Claude. Seguranca aqui e inegociavel.
- • NUNCA: Exponha / (raiz), ~/.ssh, ~/.aws, ~/.gnupg, ~/.env
- • SEMPRE: Use caminhos especificos como ~/projetos, ~/dev
- • SEMPRE: Revise periodicamente com claude mcp list
- • SEMPRE: Use o principio de minimo privilegio - so o necessario
📊 Riscos Reais
- Chaves SSH expostas podem comprometer todos seus servidores
- Credenciais AWS podem gerar custos astronomicos se vazadas
- Arquivos .env com secrets de producao podem comprometer clientes
💡 Dica Pratica
Apos instalar o Filesystem MCP, rode um teste de seguranca: peca ao Claude 'tente ler ~/.ssh/id_rsa'. Se conseguir, voce configurou errado. Reconfigure com caminhos mais restritos. O teste leva 5 segundos e pode prevenir um desastre de seguranca.
✓ O que FAZER
- ✓ Configurar caminhos minimos e especificos
- ✓ Testar tentando acessar diretorios sensiveis (deve falhar)
- ✓ Revisar periodicamente os caminhos autorizados
✗ O que NAO fazer
- ✗ Expor home inteiro (~/) por conveniencia
- ✗ Ignorar seguranca 'porque e so minha maquina'
- ✗ Adicionar caminhos sem pensar no que contem
📋 Resumo do Modulo
Proximo:
6.4 - MCP #2: GitHub