Modulo 6.8 - Gerenciando MCPs | 6 Pilares do Claude Code Resumido

📋 claude mcp list

🎯 Veja Todos os MCPs Ativos

O comando claude mcp list mostra todos os MCPs configurados, seu status de conexao e as tools que cada um expoe. E o equivalente de /status mas especifico para MCPs.

• Lista nome de cada MCP configurado
• Mostra status: connected ou disconnected
• Exibe as tools disponiveis de cada MCP ativo
• Rode antes de adicionar novos MCPs para evitar duplicatas

📊 Quando Usar

Antes de adicionar: verifique se o MCP ja esta configurado
Troubleshooting: confirme que o MCP esta connected
Auditoria: veja quantos MCPs estao consumindo tokens

💡 Dica Pratica

Faca de 'claude mcp list' o primeiro comando quando algo nao funciona com MCPs. Em 80% dos casos, o problema e que o MCP esta 'disconnected' e precisa ser re-adicionado. O list mostra isso imediatamente.

✓ O que FAZER

✓ Rodar antes de adicionar novos MCPs
✓ Usar como primeiro passo de troubleshooting
✓ Verificar periodicamente quantos MCPs estao ativos

✗ O que NAO fazer

✗ Assumir que MCPs estao conectados sem verificar
✗ Adicionar MCPs duplicados
✗ Ignorar MCPs com status disconnected

🗑️ claude mcp remove

🎯 Desconecte MCPs Desnecessarios

O comando claude mcp remove nome-do-mcp desconecta e remove um MCP da configuracao. O efeito e imediato: o MCP para de consumir tokens na proxima mensagem. Voce pode re-adicionar a qualquer momento.

• Sintaxe: claude mcp remove browser
• Efeito imediato: tokens do overhead param de ser cobrados
• Reversivel: voce pode re-adicionar com 'claude mcp add' a qualquer momento
• Sem perda de dados: remover nao apaga configs ou credenciais do sistema

📊 A Acao Mais Direta de Economia

Remove 5.000 tokens/msg? Desconecte Browser
Remove 2.000 tokens/msg? Desconecte GitHub quando nao usando
A economia se multiplica por cada mensagem restante na sessao

💡 Dica Pratica

Crie o habito de 'limpar MCPs' antes de sessoes longas de coding. Rode 'claude mcp list', identifique MCPs que nao vai usar, e remova todos exceto Filesystem. Isso e como fechar abas do navegador que nao esta usando - libera recursos para o que importa.

✓ O que FAZER

✓ Remover MCPs que nao vai usar na proxima fase
✓ Criar habito de limpeza antes de sessoes longas
✓ Usar remove como ferramenta de otimizacao

✗ O que NAO fazer

✗ Manter MCPs 'para depois' consumindo tokens
✗ Ter medo de remover (voce pode re-adicionar)
✗ Ignorar o impacto cumulativo de MCPs ociosos

➕ claude mcp add

🎯 Adicione Novos MCPs

O comando claude mcp add nome -- comando-do-server adiciona um novo MCP. O nome e como voce referencia o MCP, e o comando apos -- e o que inicia o servidor MCP.

• Formato: claude mcp add [nome] -- [comando]
• O -- (double dash) separa nome do comando - NAO esqueca!
• Nome pode ser qualquer string: filesystem, github, meu-banco
• Argumentos do server vao depois do comando: npx -y @pkg /caminho

📊 Erros Comuns

Esquecer o --: 'claude mcp add github npx...' nao funciona
Nome duplicado: verifique com 'mcp list' antes de add
Comando errado: teste 'npx -y @pkg --help' isolado primeiro

💡 Dica Pratica

Salve seus comandos de MCP add num arquivo de referencia rapida (cheatsheet.txt ou no CLAUDE.md). Quando precisar adicionar um MCP, copie e cole em vez de digitar do zero. Isso elimina erros de digitacao e acelera a rotacao de MCPs para menos de 10 segundos.

✓ O que FAZER

✓ Salvar comandos de add num cheatsheet
✓ Testar o comando do server isoladamente antes
✓ Verificar com /status apos adicionar

✗ O que NAO fazer

✗ Esquecer o -- entre nome e comando
✗ Adicionar sem verificar duplicatas
✗ Digitar comandos longos de memoria

⭐ Essencial vs Opcional

🎯 Classificacao por Necessidade

Classificar MCPs entre essenciais (sempre conectados) e opcionais (sob demanda) e a base da estrategia de gerenciamento. Essenciais tem baixo overhead e beneficio constante. Opcionais tem overhead variavel e beneficio pontual.

• ESSENCIAL (always on): Filesystem (~500 tokens) - beneficio constante, custo minimo
• OPCIONAL (sob demanda): GitHub (~2.000 tokens) - conecte quando trabalhando com issues/PRs
• OPCIONAL (sob demanda): Database (~1.500 tokens) - conecte quando trabalhando com dados
• OPCIONAL (sob demanda): Browser (~5.000 tokens) - conecte APENAS para tarefas web
• OPCIONAL (sob demanda): Google Sheets (~800 tokens) - conecte quando interagindo com planilhas

📊 Por Que Classificar

Sem classificacao: todos os MCPs parecem essenciais e voce acumula overhead
Com classificacao: 1 MCP fixo + 1-2 rotativos = overhead controlado
Decisoes se tornam automaticas: 'preciso de dados do banco? conecto Database MCP'

💡 Dica Pratica

Regra simples: se o MCP custa menos de 1.000 tokens E voce usa em >50% das sessoes, e essencial (keep always on). Se custa mais de 1.000 tokens OU voce usa em <50% das sessoes, e opcional (conecte sob demanda). Atualmente, so Filesystem passa no teste de 'essencial'.

✓ O que FAZER

✓ Classificar cada MCP como essencial ou opcional
✓ Manter apenas essenciais always on
✓ Ter comandos de add prontos para opcionais

✗ O que NAO fazer

✗ Tratar todos como essenciais
✗ Manter opcionais ligados 'por precaucao'
✗ Adicionar novos MCPs sem classificar primeiro

🚀 Instale Imediatamente

🎯 MCPs Para Configurar Agora

Estes sao os MCPs que voce deve instalar e configurar agora, antes de precisar. Ter o setup pronto antes de precisar evita interrupcoes no fluxo de trabalho.

• Filesystem (obrigatorio): claude mcp add filesystem -- npx -y @anthropic/mcp-filesystem ~/projetos
• GitHub (se usa GitHub): claude mcp add github -- npx -y @anthropic/mcp-github (requer GITHUB_TOKEN)
• Overhead combinado: ~2.500 tokens - aceitavel para qualquer sessao
• Estes dois cobrem 80% dos casos de uso de MCPs

📊 Por Que Agora

Configurar previamente evita interrupcoes quando voce realmente precisa
Filesystem e essencial para qualquer tipo de projeto
GitHub e essencial para qualquer dev que usa GitHub (maioria)

💡 Dica Pratica

Execute estes comandos agora e nunca mais pense nisso: 1) claude mcp add filesystem -- npx -y @anthropic/mcp-filesystem ~/projetos 2) export GITHUB_TOKEN=seu_token (adicione ao .bashrc) 3) claude mcp add github -- npx -y @anthropic/mcp-github. Pronto, 80% do seu setup de MCPs esta feito.

✓ O que FAZER

✓ Instalar Filesystem agora se ainda nao tem
✓ Configurar GitHub se trabalha com repos
✓ Adicionar GITHUB_TOKEN ao shell profile

✗ O que NAO fazer

✗ Adiar a instalacao 'para quando precisar'
✗ Instalar todos os MCPs de uma vez (comece com esses 2)
✗ Pular a configuracao de variaveis de ambiente

⏰ Instale Quando Precisar

🎯 MCPs Sob Demanda

Estes MCPs devem ser instalados apenas quando a tarefa exigir. Mantenha os comandos prontos num cheatsheet para instalar em segundos quando necessario.

• Browser: claude mcp add browser -- npx -y @anthropic/mcp-puppeteer → Use para UI/scraping
• Database: claude mcp add postgres -- npx -y @anthropic/mcp-postgres "conn_string" → Use para dados
• Supabase: claude mcp add supabase -- npx -y @supabase/mcp-server-supabase --supabase-url URL --supabase-key KEY
• Sheets: claude mcp add google-sheets -- npx -y @anthropic/mcp-google-sheets → Use para planilhas

📊 O Ciclo Add-Use-Remove

Add: cole o comando do cheatsheet (5 segundos)
Use: faca a tarefa que precisa do MCP
Remove: claude mcp remove nome (5 segundos)
Ciclo completo em menos de 30 segundos de overhead

💡 Dica Pratica

Crie um arquivo ~/mcp-cheatsheet.txt com todos os comandos de add prontos para cada MCP. Quando precisar de um MCP, abra o arquivo, copie o comando e cole. Isso reduz a friccao de rotacao para quase zero e torna a estrategia de rotacao ativa (modulo 6.9) praticavel no dia a dia.

✓ O que FAZER

✓ Manter cheatsheet com comandos de add prontos
✓ Praticar o ciclo add-use-remove ate ficar automatico
✓ Remover imediatamente apos usar

✗ O que NAO fazer

✗ Tentar lembrar comandos de memoria
✗ Instalar sob demanda sem ter credenciais configuradas
✗ Esquecer de remover apos usar

📋 Resumo do Modulo

✓

claude mcp list - O comando claude mcp l...


          
            ✓
            
              claude mcp remove
               - O comando claude mcp r...
            

          

          
            ✓
            
              claude mcp add
               - O comando claude mcp a...
            

          

          
            ✓
            
              Essencial vs Opcional
               - Classificar MCPs entre essenciais (sempre conectados) e opcionais (sob demanda) ...
            
          
          
            ✓
            
              Instale Imediatamente
               - Estes sao os MCPs que voce deve instalar e configurar agora, antes de precisar. ...
            
          
          
            ✓
            
              Instale Quando Precisar
               - Estes MCPs devem ser instalados apenas quando a tarefa exigir. Mantenha os coman...



        
          Proximo:
          6.9 - Estrategia de Rotacao Ativa
        

        
          
            ← Modulo Anterior
          
          
            Proximo Modulo →