MCP — conectando o Claude ao mundo

MCP (Model Context Protocol) é um padrão pra plugar ferramentas externas no Claude. Em vez de cada integração ter sua gambiarra, todo mundo fala o mesmo protocolo. Você liga uma vez e pronto.

O que isso resolve na prática

Sem MCP, se você quer que o Claude leia um issue do GitHub, você abre o GitHub, copia, cola, descreve. Com MCP do GitHub ligado, você só diz “olha o issue #423 e sugere um fix”. Ele chama a API, lê, entende.

Mesma coisa pra:

• Postgres: “roda um select no banco de staging e me mostra os últimos users”
• Linear: “lista minhas tasks abertas e me ajuda a priorizar”
• Figma: “pega esse frame e gera o componente React”
• Filesystem/Slack/Sentry/etc: cada um com seu server MCP

Como adicionar um server

Via CLI:

claude mcp add github --env GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github

Ou edita direto o config (~/.claude/mcp.json ou equivalente):

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/meu_db"]
    }
  }
}

Reinicia o Claude Code e o servidor aparece disponível. Dá /mcp pra ver o status dos servers conectados.

Escopo: global vs projeto

• Global (~/.claude/) — vale pra tudo que você faz
• Projeto (.mcp.json no root) — commitado no repo, time inteiro ganha acesso

Projeto é melhor pra coisa específica do time (banco de staging, Linear do time). Global é pra ferramenta pessoal (teu GitHub, teu Slack).

Quando preferir CLI ao invés de MCP

MCP é ótimo, mas às vezes CLI resolve melhor:

• Você já tem um CLI bom (gh, psql, aws): o Claude usa via Bash sem cerimônia. Menos peça pra configurar.
• Operação pontual: se é “uma vez na vida”, não vale configurar MCP.
• Autenticação complicada: MCP server que exige OAuth chato às vezes não compensa. gh já autenticado no teu shell é mais simples.

Exemplo: pra GitHub, gh CLI costuma ser suficiente e mais ágil que o MCP. Pra Postgres onde você quer que o Claude entenda schemas e fazer queries exploratórias, MCP ganha (ele consegue listar tabelas, descrever colunas, tudo estruturado).

Quando NÃO usar MCP

• Servidor que dá acesso a dados sensíveis em prod sem auditoria
• Server de origem duvidosa — você tá dando ferramentas ao modelo, confia na fonte
• Quando uma skill + CLI resolve mais simples

Dica prática

Começa com 1 ou 2 servers que você realmente usa toda semana (provavelmente GitHub e o banco de dev). Ir adicionando MCP por hype só enche o contexto com ferramentas que o modelo vai considerar à toa. Menos é mais.