📂 MCP Filesystem (Acesso a Arquivos Fora do Repo)
Por padrao, o Claude Code so tem acesso aos arquivos dentro do diretorio onde voce iniciou a sessao. O MCP Filesystem expande esse acesso para qualquer diretorio do seu computador - Desktop, Documents, configs globais, outros projetos. E o MCP mais fundamental porque resolve a limitacao mais comum.
🎯 Conceito Principal
O Filesystem MCP e um servidor local que expoe operacoes de leitura e escrita de arquivos ao Claude. Voce define quais diretorios ele pode acessar na instalacao, e ele respeita esses limites. O impacto em tokens e baixo porque so carrega conteudo quando solicitado.
- • Acesso controlado: Voce escolhe exatamente quais diretorios expor
- • Token impact baixo: Conteudo so e carregado quando o Claude precisa
- • Alta utilidade: Voce vai usar em praticamente toda sessao produtiva
💡 Dica Pratica
Comece expondo apenas ~/Desktop e ~/Documents. Nao exponha o diretorio raiz inteiro - isso daria acesso a arquivos de sistema que nao fazem sentido para o Claude.
⚙️ Instalando Filesystem (claude mcp add)
A instalacao do Filesystem MCP e feita com um unico comando. Voce especifica o nome do MCP e os diretorios que deseja expor ao Claude. O processo e instantaneo e nao requer reiniciar nada.
🎯 Conceito Principal
O comando de instalacao segue o padrao: claude mcp add [nome] -- [comando] [argumentos]. Para o Filesystem:
Voce pode adicionar quantos diretorios quiser, separados por espaco. Cada diretorio listado sera acessivel ao Claude.
💡 Dica Pratica
Apos instalar, verifique com claude mcp list se aparece "filesystem" na lista. Depois abra uma sessao e peca: "Liste os arquivos do meu Desktop". Se funcionar, a instalacao esta correta.
🚀 Casos de Uso do Filesystem
O Filesystem MCP desbloqueia cenarios que seriam impossiveis ou muito trabalhosos sem ele. Aqui estao os mais comuns no dia a dia de um desenvolvedor.
🎯 Conceito Principal
- • Cross-project: Referenciar codigo de outro projeto enquanto trabalha no atual. Ex: "Use o mesmo pattern de auth do projeto X"
- • Configs globais: Acessar .bashrc, .zshrc, configs do VS Code, ssh configs sem sair da sessao
- • Desktop como staging area: Salvar outputs, relatorios ou artefatos diretamente no Desktop
- • Monorepo parcial: Acessar packages de um monorepo que estao fora do working directory
💡 Dica Pratica
O caso de uso killer e cross-project reference. Imagine que voce esta criando um novo projeto e quer replicar patterns de autenticacao de um projeto anterior. Com Filesystem, basta dizer: "Olhe o arquivo auth.ts no projeto ~/projects/meu-app e replique o pattern aqui".
🐙 MCP GitHub (Issues, PRs, Search, CI)
O MCP GitHub da ao Claude acesso completo a API do GitHub - criar e gerenciar issues, revisar PRs, buscar codigo em repositorios, verificar status de CI e muito mais. Tudo sem sair do terminal.
🎯 Conceito Principal
- • Criar/gerenciar issues: Abra, feche, comente e atribua issues sem abrir o navegador
- • Revisar PRs: Leia diffs, comente e aprove pull requests direto do Claude
- • Buscar em repos: Pesquise codigo, arquivos e commits em qualquer repositorio que voce tem acesso
- • CI status: Verifique se os checks passaram antes de mergear
💡 Dica Pratica
O token impact do GitHub e moderado. Mantenha queries especificas - em vez de "liste todos os issues", diga "liste issues abertos com label bug nos ultimos 7 dias". Quanto mais especifica a query, menor o consumo de tokens.
🔑 Instalando GitHub (Command + GITHUB_TOKEN)
A instalacao do MCP GitHub requer dois passos: o comando de instalacao e a configuracao do token de acesso. O token e necessario para que o Claude possa autenticar com a API do GitHub em seu nome.
🎯 Conceito Principal
Dois comandos e voce esta pronto:
O token pode ser gerado em GitHub > Settings > Developer Settings > Personal Access Tokens. Use Fine-grained tokens com as permissoes minimas necessarias.
💡 Dica Pratica
Coloque o export GITHUB_TOKEN=... no seu ~/.bashrc ou ~/.zshrc para nao precisar configurar toda vez. E nunca commite o token no repositorio.
🔄 Workflow Cross-Repo com Ambos
O verdadeiro poder aparece quando voce combina Filesystem + GitHub. Imagine: voce esta no projeto A, precisa referenciar codigo do projeto B (Filesystem) e criar uma issue no repositorio do projeto C (GitHub). Tudo numa unica sessao, sem trocar de janela.
🎯 Conceito Principal
Exemplo de workflow completo com ambos MCPs:
- • 1. Leia o CLAUDE.md do projeto-api em ~/projects/projeto-api (Filesystem)
- • 2. Verifique os issues abertos do repo no GitHub (GitHub MCP)
- • 3. Implemente a feature no projeto atual usando patterns do projeto-api
- • 4. Crie um PR com referencia ao issue (GitHub MCP)
💡 Dica Pratica
Esse combo (Filesystem + GitHub) e o setup padrao recomendado para desenvolvimento. Com apenas ~5-10% de overhead, voce ganha acesso cross-projeto e integracao GitHub completa. E o melhor custo-beneficio de MCPs.
Exercicio Pratico
Instalar Filesystem + GitHub e executar tarefa cross-repo
Instale ambos MCPs e execute uma tarefa que use os dois simultaneamente.
Passo 1: Instale os MCPs
$ export GITHUB_TOKEN=ghp_seu_token
$ claude mcp add github -- npx @anthropic-ai/mcp-github
Passo 2: Execute uma tarefa cross-repo
> "Liste os arquivos do meu Desktop e depois liste os issues abertos do meu repositorio principal no GitHub"
Checklist de Conclusao:
📋 Resumo do Modulo
Proximo Modulo:
6.3 - MCP Browser e Chrome DevTools