MCP e Integrações

O Model Context Protocol (MCP) é o padrão aberto que permite o Claude Code conectar com ferramentas e fontes de dados externas. Em vez do Claude depender só do filesystem e do Bash, ele passa a conseguir falar com Jira, GitHub, Slack, Google Drive, seu banco, design system, ou qualquer API que você queira expor.

O que é MCP

MCP é a camada de protocolo entre o Claude e as ferramentas externas. Um MCP server roda como processo separado (local ou remoto), expõe ferramentas e o Claude as chama via protocolo padronizado. A vantagem: qualquer servidor MCP funciona com qualquer cliente MCP, sem precisar de integração custom.

Existem servidores MCP oficiais (Anthropic, Google, GitHub), comunitários e os que você pode escrever pro seu próprio sistema interno.

Adicionando um MCP Server

claude mcp add <nome> <comando-ou-url>

Exemplo, adicionando um servidor de filesystem:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects

Ou um remoto:

claude mcp add --transport sse jira https://api.atlassian.com/mcp/jira

Os servidores configurados ficam disponíveis em todas as sessões. Use /mcp no Claude pra listar e gerenciar.

Configuração Manual

Você também pode editar settings:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

Ou via flag pontual:

claude --mcp-config ./mcp.json
claude --strict-mcp-config --mcp-config ./mcp.json  # ignora outros servidores

Servidores MCP Comuns

A lista cresce todo dia. Alguns dos mais úteis:

Server	O que faz
filesystem	Acesso a diretórios fora do projeto
github	Issues, PRs, comentários, repos
gitlab	Equivalente do GitLab
postgres / sqlite / mysql	Query e introspecção de banco
slack	Mensagens, canais, threads
notion	Páginas e databases
linear	Issues e ciclos
jira / confluence	Atlassian suite
google-drive	Docs, sheets, slides
figma	Design files, componentes
puppeteer / playwright	Automação de browser
memory	Memória persistente entre sessões

A lista oficial está em mcp-registry.

Tool Search e Carregamento Sob Demanda

MCP servers podem expor centenas de ferramentas. Carregar todos os schemas no contexto seria caro. Por padrão, o Claude Code usa Tool Search: só os nomes das ferramentas MCP entram no contexto inicial. Quando o Claude precisa de uma ferramenta específica, ele a "busca" e o schema completo é carregado sob demanda.

Você controla com a env var ENABLE_TOOL_SEARCH:

Valor	Comportamento
auto (padrão)	Carrega upfront se cabe em 10% do contexto, senão deferred
true	Sempre deferred
false	Sempre carrega tudo

Em geral, auto é o que você quer. Se está usando muitos servidores MCP pesados, deixe true.

Aprovação de MCP

Toda conexão MCP precisa de aprovação na primeira vez. Cada chamada individual de ferramenta também passa pelo sistema de permissões padrão. Você pode adicionar regras de allow/deny via /permissions:

mcp__github__get_issue
mcp__github__.*
mcp__slack__send_message

IDE Integrations

Além do terminal, o Claude Code roda nativamente em:

VS Code

Extensão oficial. Recursos exclusivos:

• Diffs inline antes de aceitar mudanças
• @ mentions para arquivos abertos
• Plan review na lateral
• Histórico de conversas

Instale via code --install-extension anthropic.claude-code ou pelo marketplace.

JetBrains

Plugin pra IntelliJ, PyCharm, WebStorm e o resto da família. Diff viewer interativo e contexto de seleção compartilhado.

Cursor

A extensão do VS Code também roda no Cursor: cursor:extension/anthropic.claude-code.

Outras Superfícies

Claude Code on the Web

claude.ai/code. Roda em VMs isoladas na infra da Anthropic. Útil pra:

• Tasks longos que você quer começar e voltar depois
• Trabalhar em repos que você não tem localmente
• Rodar várias tasks em paralelo

Desktop App

App nativo macOS/Windows. Diff review visual, múltiplas sessões side-by-side, scheduled tasks.

iOS App

Disparar tasks pelo celular. Use com Dispatch.

GitHub Actions

Code review automatizado em PRs e triagem de issues:

- uses: anthropics/claude-code-action@v1
  with:
    claude_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

GitLab CI/CD

Equivalente do GitHub Actions pra GitLab.

Slack

Mencione @Claude num canal com um bug report e receba o PR de volta.

Chrome Extension

claude --chrome ativa integração com browser pra debugging de UI ao vivo.

Conexões entre Sessões

Sessões não estão presas a uma superfície. Você pode mover trabalho entre ambientes:

Movimento	Como
Terminal → Desktop	/desktop
Web → Terminal local	claude --teleport
Mobile/qualquer browser → Terminal	Remote Control
Slack → Sessão	Mention @Claude

Cada superfície compartilha o mesmo motor, então CLAUDE.md, settings e MCP servers funcionam igual em todas.

Routines (Tarefas Agendadas)

Você pode rodar Claude em cron na infra da Anthropic:

/schedule

Use cases:

• Review de PRs todo dia de manhã
• Análise de falhas de CI à noite
• Audit de dependências semanal
• Sync de docs depois de merges

Routines persistem mesmo com o computador desligado. Também há Desktop scheduled tasks pra rodar localmente com acesso aos seus arquivos.

Channels

Recurso em research preview que permite servidores MCP receberem notificações push (ex: novo evento no Telegram, Discord, iMessage, ou seu webhook custom). Útil pra workflows reativos.

CLI Tools são Melhores que MCP

Vale uma observação importante: pra interação com serviços externos, CLIs são geralmente mais context-efficient que MCP. O gh, aws, gcloud, sentry-cli o Claude já sabe usar nativamente. Eles não adicionam listing de tools no contexto, e respeitam suas credenciais locais.

Use MCP quando:

• Não existe CLI boa pra ferramenta
• Você precisa de operações estruturadas com schemas ricos
• A integração precisa de autenticação OAuth complexa
• Você está expondo um sistema interno custom

Use CLI quando:

• Já existe ferramenta CLI madura (gh, aws, kubectl, etc)
• Você quer minimizar overhead de contexto

Conclusão

MCP é o que conecta o Claude Code ao resto do mundo. Bem configurado, ele transforma o Claude num agente que entende seu Jira, lê seu Figma, escreve no seu Slack e operates seu banco. Mas tudo tem custo de contexto. Use Tool Search, prefira CLIs quando existirem, e revise periodicamente quais servidores estão habilitados em /mcp.

---

Próximo: CLAUDE.md e Memória

Referências:

• MCP documentation
• MCP Registry
• Routines
• Remote Control