🟢 MCP & Integrações

🟢 O que é

O MCP (Model Context Protocol) é o "padrão USB" que conecta o Claude Code a ferramentas externas: bancos de dados, navegadores, APIs, docs. Cada servidor MCP expõe ferramentas que o Claude passa a poder usar — ler do Supabase, raspar um site, controlar o navegador.

💡 Por que aprender

Sem MCP, o Claude só enxerga seus arquivos. Com MCP, ele age no mundo: consulta seu banco real, abre páginas, pega dados ao vivo. É o que transforma o agente de "editor de código" em "operador de sistemas".

🔑 Como adicionar e onde vive

claude mcp add firecrawl "npx -y firecrawl-mcp"   # adiciona um server
claude mcp list                                    # lista os configurados
/mcp                                               # painel dos servers na sessão

🟢 O que é

Um punhado de servidores MCP resolve a maior parte dos casos: Supabase (banco), Firecrawl (raspar a web), Playwright (controlar o navegador) e NotebookLM (base de conhecimento). Todos entram com um claude mcp add.

💡 Por que aprender

Com o Supabase MCP o Claude lê e migra seu banco real sem você copiar schema; com Firecrawl ele pega conteúdo de qualquer site; com Playwright ele testa a UI clicando de verdade. É produtividade que não dá pra fingir com prompt.

🔑 Os mais úteis

claude mcp add playwright "npx -y @playwright/mcp@latest"
claude mcp add supabase "npx -y @supabase/mcp-server-supabase" -e SUPABASE_ACCESS_TOKEN=...

🟢 O que é

O Claude Code procura a chave em ANTHROPIC_API_KEY e a URL em ANTHROPIC_BASE_URL. Trocando essa URL por um roteador (CCR — claude-code-router) ou um servidor local (Ollama), dá pra rodar com outros modelos — inclusive de graça.

💡 Por que aprender

Para estudar, testar ou tarefas simples, você não precisa gastar tokens caros. CCR roteia para provedores gratuitos/baratos; Ollama roda modelos na sua máquina, offline. Mantém o fluxo do Claude Code, troca só o "motor".

🔑 As duas rotas

npm install -g @musistudio/claude-code-router
ccr code        # abre o Claude Code roteado p/ outro provedor
# github.com/musistudio/claude-code-router

ollama pull qwen2.5-coder
export ANTHROPIC_BASE_URL="http://localhost:11434"
claude   # usa o modelo local, offline

🟢 O que é

As Routines são automações que rodam na nuvem — sem deixar o PC ligado. Você define um prompt, um repositório GitHub, modelo e cadência; o disparo pode ser por agendamento, API ou evento do GitHub. Já o /loop e as scheduled tasks rodam localmente.

💡 Por que aprender

É o Claude virando membro da equipe que trabalha sozinho: revisa PRs, atualiza dependências, gera relatórios — em horário marcado, sem você. A pegadinha: o ambiente na nuvem é stateless e não enxerga seu .env local; segredos vão como variáveis de ambiente do cloud.

🔑 Local × Nuvem

Limites por plano: Pro ~5/dia · Max ~15/dia · Team/Enterprise ~25/dia. Cada execução na nuvem ≈ 4 vCPU / 16 GB RAM.

🟢 O que é

Ferramentas que mostram, em tempo real, quanto você está gastando e o que seus agentes estão fazendo: consumo de tokens, custo, sessões abertas e múltiplos terminais. A comunidade construiu vários — Token-Dashboard, iccmonit, SMA (Surveil My Agents), Agent View.

💡 Por que aprender

Quem roda vários agentes em paralelo (trilha 6) perde a noção do gasto e do estado. Um monitor evita susto na fatura e mostra qual terminal travou ou terminou. /cost resolve o básico; os dashboards dão a visão geral.

🔑 O que cada um cobre

🟢 O que é

A Anthropic lança novas versões de Sonnet e Opus com frequência — o Claude Code aponta para as mais recentes. Para busca semântica (RAG, "segundo cérebro"), entram os embeddings, onde modelos como o Gemini Embedding são populares por serem baratos/gratuitos.

💡 Por que aprender

Saber a diferença entre modelo de chat (gera código/texto) e modelo de embedding (transforma texto em vetores pra busca) evita confusão. O primeiro você troca com /model; o segundo alimenta seu RAG (trilha 6).

🔑 Chat × Embedding

/model         # ver e trocar o modelo de chat ativo
/model sonnet  # último Sonnet (dia-a-dia)
/model opus    # último Opus (tarefas difíceis)