⚡ API Direta vs MCP — Economize Contexto
Servidores MCP são poderosos e convenientes — eles expõem todas as ferramentas de uma plataforma de uma vez. Mas têm um custo: todas as definições de ferramentas são carregadas no contexto, mesmo as que você não vai usar. Quando o contexto está apertado, essa conveniência pode ser cara demais.
⚡ MCP Completo vs Endpoint Direto
MCP do Notion (exemplo)
- →Carrega 30+ definições de ferramentas
- →read_page, update_page, create_page...
- →search_database, create_database...
- →Centenas de tokens de overhead
Endpoint Direto
- →Apenas o código para aquela operação
- →GET /v1/databases/{id}/query
- →Sem ferramentas que você não usa
- →Mínimo overhead de contexto
# Ao invés de: instalar e configurar o MCP completo do Notion
# Use diretamente o endpoint que você precisa:
Você: Leia o conteúdo da database do Notion com ID abc123.
Use a API direta do Notion (token está em NOTION_TOKEN).
Claude: // Usando fetch direto ao endpoint
const response = await fetch(
'https://api.notion.com/v1/databases/abc123/query',
{
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.NOTION_TOKEN}`,
'Notion-Version': '2022-06-28'
}
}
);
💡 Dica Prática — Quando Usar Cada Abordagem
Use MCP quando: você precisa de múltiplas ferramentas da plataforma em uma sessão, o contexto não está apertado, ou a conveniência vale mais que a economia de tokens.
Use API direta quando: você usa apenas 1-2 operações da plataforma, o contexto está no limite, ou você vai chamar o mesmo endpoint repetidamente e quer scripts reutilizáveis.
📊 Análise de Dados sem SQL
Escrever consultas SQL para análises exploratórias é lento — você precisa saber a estrutura das tabelas, a sintaxe exata, e ainda iterar até chegar na query certa. Com o Claude Code e uma CLI de banco de dados conectada, você pergunta em linguagem natural e recebe a resposta diretamente.
📊 O Padrão CLI + Claude
O Claude recebe a pergunta em linguagem natural, traduz para a consulta correta na sintaxe da ferramenta, executa via CLI e retorna o resultado interpretado. Funciona para qualquer ferramenta com interface CLI.
Você: Quais foram nossas 10 maiores fontes de receita no último
trimestre? Use o BigQuery (projeto: minha-empresa).
Claude: Vou consultar o BigQuery...
$ bq query --use_legacy_sql=false \
'SELECT
revenue_source,
SUM(amount) as total_revenue
FROM `minha-empresa.analytics.transactions`
WHERE DATE(created_at) BETWEEN
DATE_SUB(CURRENT_DATE(), INTERVAL 1 QUARTER)
AND CURRENT_DATE()
GROUP BY revenue_source
ORDER BY total_revenue DESC
LIMIT 10'
Resultado:
1. Assinaturas Pro R$ 842.300
2. Enterprise Anual R$ 620.000
3. Add-ons R$ 183.400
...
💡 Padrão Reutilizável
Este padrão funciona para qualquer análise repetível. Documente no CLAUDE.md as tabelas principais, schemas e exemplos de consultas anteriores. Isso torna as análises subsequentes ainda mais precisas — o Claude já conhece a estrutura dos dados.
- →Perguntas de negócio → SQL automático → resultado direto
- →Funciona com qualquer banco que tenha CLI
- →Claude aprende o schema com o tempo via CLAUDE.md
💡 Dica Prática
Adicione ao CLAUDE.md as tabelas principais do seu banco com descrições breves: "tabela `transactions`: registros de pagamento com campos amount, status, created_at, revenue_source". Com esse contexto persistente, o Claude gera queries muito mais precisas desde o primeiro prompt.
📚 Context7 MCP — Documentação Sempre Atual
O Claude foi treinado com dados até uma certa data. Next.js 15 lançou depois. React 19 lançou depois. O Tailwind CSS v4 lançou depois. Quando o Claude escreve código com essas versões, pode usar APIs deprecadas ou padrões antigos. Context7 MCP resolve isso injetando documentação atual específica por versão antes de qualquer código ser escrito.
📚 Como o Context7 Funciona
Quando você pede ao Claude para usar Context7, ele consulta o servidor MCP antes de escrever código. O Context7 busca a documentação correta para a versão especificada e injeta no contexto. O resultado é código compatível com o que você está usando — não com o que existia durante o treinamento.
Você pede código com uma biblioteca específica
"Crie um Server Component no Next.js 15 com App Router"
Context7 busca a documentação atual
Documentação do Next.js 15 + exemplos de código ao vivo
Claude escreve com contexto atualizado
Código correto para a versão que você está usando
# 1. Instalar o Context7 MCP
$ npx -y @upstash/context7-mcp
# 2. Adicionar ao .claude/settings.json
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
# 3. Usar no prompt
Você: Use Context7 para buscar a documentação do Next.js 15
e depois crie um Server Action para salvar um formulário.
Claude: Consultando Context7 para Next.js 15...
Documentação carregada. Usando 'use server' directive,
revalidatePath e FormData conforme docs v15.
Bibliotecas com Suporte
💡 Dica Prática
Adicione ao CLAUDE.md do projeto as versões exatas das principais dependências: "Este projeto usa Next.js 15.1, React 19, Tailwind v4". Quando você pede ao Claude para usar Context7, ele já sabe qual versão buscar sem precisar perguntar.
Parabéns! Você completou os 32 Hacks do Claude Code!
Você dominou todas as três trilhas — de configuração básica até paralelismo avançado, automação e integrações. Você agora tem um arsenal completo para trabalhar com o Claude Code como profissional.
O que você aprendeu neste módulo:
Trilha 1 — Iniciante
Configuração, contexto e fluxo de trabalho inteligente
Hacks 1–10 ✓
Trilha 2 — Intermediário
Automação, MCP, subagentes e prompt engineering
Hacks 11–22 ✓
Trilha 3 — Avançado
Paralelismo, infraestrutura, poder máximo e dados
Hacks 23–32 ✓