Módulo 2.4 — MCP e Primeiro Projeto

🌐 O que é Model Context Protocol (MCP)

MCP é um padrão aberto criado pela Anthropic para conectar modelos de linguagem a ferramentas externas. Pense como uma "tomada universal" — qualquer ferramenta que implemente o protocolo pode ser plugada ao Claude Code.

🔌 Por que MCP muda tudo

Antes do MCP, o Claude Code só acessava o que estava no filesystem local. Com MCP, ele pode:

→Consultar um banco PostgreSQL para entender o schema antes de escrever código
→Ler issues e PRs do GitHub para ter contexto de uma tarefa
→Navegar em páginas web para pesquisar documentação
→Enviar mensagens no Slack ao finalizar uma tarefa automatizada

🔗 Configurando servidores MCP

Servidores MCP são configurados no settings.json na chave mcpServers. Cada servidor precisa de um comando para inicializar e opcionalmente argumentos e variáveis de ambiente.

Configuração de servidores MCP no settings.json

{
  "mcpServers": {

    // Servidor filesystem (oficial Anthropic)
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projetos"]
    },

    // Servidor GitHub
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    },

    // Servidor PostgreSQL
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

Escolher o servidor MCP

Buscar em github.com/modelcontextprotocol/servers

# Servidores oficiais disponíveis:
@modelcontextprotocol/server-filesystem
@modelcontextprotocol/server-github
@modelcontextprotocol/server-postgres
@modelcontextprotocol/server-sqlite
@modelcontextprotocol/server-slack
@modelcontextprotocol/server-puppeteer

Adicionar ao settings.json

Na chave mcpServers do arquivo de configuração

# Editar settings.json
nano ~/.claude/settings.json
# ou via /config no REPL

Reiniciar e verificar

Claude Code inicializa os servidores na próxima sessão

claude
# No REPL verificar servidores ativos:
/mcp
# Output esperado:
✓ filesystem: connected
✓ github: connected

🛠️ Ecossistema MCP — ferramentas populares

O repositório oficial já tem dezenas de servidores. Comunidade cresce rápido — novos servidores aparecem semanalmente.

📁 Filesystem

Acesso ao sistema de arquivos além do diretório atual

Útil para: monorepos, acesso cross-projeto

🐙 GitHub

Ler/criar issues, PRs, comentários, commits

Útil para: code review automatizado, triage de issues

🐘 PostgreSQL / SQLite

Consultas SQL, explorar schema, analisar dados

Útil para: gerar migrations, debug de queries

🤖 Puppeteer

Navegar na web, screenshot, interagir com páginas

Útil para: scraping, testes E2E, pesquisa de docs

💬 Slack

Ler histórico de canais, enviar mensagens

Útil para: relatórios automáticos, notificações

🗺️ Google Maps / APIs

Servidores comunitários para APIs externas

Útil para: projetos com integração de terceiros

✓ MCPs confiáveis

✓Servidores oficiais de @modelcontextprotocol
✓Servidores com código aberto auditado
✓MCPs da comunidade com muitas stars e issues ativas

✗ Avaliar com cuidado

✗MCPs de terceiros sem código público
✗Servidores que pedem acesso total ao sistema
✗MCPs que exigem credenciais de produção

📁 Criar e abrir um projeto

Claude Code funciona no contexto do diretório atual. Abrir o projeto correto é o passo zero antes de qualquer tarefa.

Abrir projeto existente

# Navegar para o projeto e iniciar Claude Code
cd ~/projetos/meu-app
claude

# Claude imediatamente entende o contexto do diretório
# Lê package.json, CLAUDE.md, .claude/settings.json

# Gerar CLAUDE.md se não existir
# Dentro do REPL:
/init
# Claude analisa o projeto e gera rascunho do CLAUDE.md

Criar projeto do zero

# Criar estrutura de projeto
mkdir ~/projetos/novo-projeto
cd ~/projetos/novo-projeto
git init

# Criar settings de projeto
mkdir .claude
cat > .claude/settings.json <<EOF
{
  "permissions": {
    "allow": ["Read(**)", "Write(**)", "Edit(**)", "Bash(npm *)"]
  }
}
EOF

# Iniciar Claude Code e gerar CLAUDE.md
claude
> /init
> Crie um projeto Node.js + TypeScript com estrutura básica

💡 Estrutura recomendada para novos projetos

meu-projeto/
├── .claude/
│   └── settings.json    ← permissões do projeto (versionar)
├── CLAUDE.md             ← instruções para o Claude (versionar)
├── src/                  ← código-fonte
├── tests/                ← testes
├── .gitignore
└── package.json

🔄 Primeiro fluxo real: do zero ao commit

Veja o ciclo completo de desenvolvimento com Claude Code. Este exemplo cria uma API REST simples do zero, com testes, e faz o primeiro commit.

Definir o escopo

> Crie uma API REST em Express + TypeScript com um endpoint GET /health
  que retorna { status: "ok", timestamp: ISO8601 }. Inclua um teste
  básico com Vitest.

Claude cria os arquivos (com confirmação)

# Claude mostra o plano e pede aprovação:
Vou criar: src/app.ts, src/routes/health.ts,
           tests/health.test.ts, package.json
Continuar? [y/n] y

Rodar testes

> Instale as dependências e rode os testes

# Claude executa:
npm install
npm test
✓ health endpoint returns 200  (3ms)

Revisar e commitar

> Revise os arquivos criados e faça um commit inicial

# Claude mostra diff → você revisa → aprova
git add .
git commit -m "feat: adicionar endpoint GET /health"

📊 Loop de desenvolvimento com Claude Code

💬

1. Descrever

o que você quer

🤖

2. Claude planeja

e cria o código

👀

3. Você revisa

o diff gerado

✅

4. Aprovar

e commitar

🚀 Próximos passos: a jornada continua

Com instalação, autenticação, settings e MCP configurados, você tem a base completa. As trilhas seguintes aprofundam cada capacidade.

🧩

Trilha 3: Skills

Criar habilidades reutilizáveis. Skills são "macro-comandos" que encapsulam fluxos complexos e ficam disponíveis em qualquer projeto.

🔁

Trilha 4: Automação

Hooks, triggers, pipelines e workflows. Automatize tarefas repetitivas de dev com Claude como orquestrador.

🏗️

Trilha 5: Projetos

Projetos reais de ponta a ponta. Do planejamento à entrega com Claude Code como par de desenvolvimento.

💡 Você completou a Trilha 2!

Seu ambiente está pronto. Você instalou, autenticou, configurou permissões e conectou ferramentas MCP. Agora é sobre uso consistente — quanto mais você usar, mais produtivo fica.

Próximo passo recomendado: ir para a Trilha 3 (Skills) para criar suas primeiras habilidades reutilizáveis.

✅ Resumo do Módulo 2.4 — e da Trilha 2

✓

MCP é o protocolo padrão para conectar Claude a ferramentas externas

✓

mcpServers no settings.json configura qualquer servidor MCP em minutos

✓

Dezenas de servidores oficiais e comunitários disponíveis agora

✓

Loop completo: descrever → Claude cria → você revisa → aprovar → commitar

✓

CLAUDE.md + settings.json + MCP = ambiente profissional completo

Próxima Trilha:

Trilha 3 — Skills: crie habilidades reutilizáveis que transformam fluxos complexos em um único comando. A superpotência do Claude Code.

← Módulo 2.3 Próxima Trilha: Skills →