O que é MCP: conectando o Claude Code ao mundo externo

O Claude Code tem um escopo definido por padrão: ler e escrever arquivos locais, executar comandos no terminal, usar ferramentas integradas. Mas projetos reais exigem mais — consultar um banco de dados, ler documentos do Notion, pesquisar mensagens no Slack, chamar APIs internas.

MCP é a solução para esse problema.

O que é MCP

MCP (Model Context Protocol) é um protocolo aberto da Anthropic que define como modelos de IA se comunicam com ferramentas externas e fontes de dados. Pense nisso como instalar plugins no Claude Code: cada MCP Server é um serviço independente que expõe um conjunto de ferramentas que o Claude pode chamar diretamente durante uma sessão.

Diferente dos Hooks (que disparam scripts quando o Claude executa uma ação), o MCP expande ativamente o que o Claude pode fazer: tudo o que você conectar, o Claude pode operar.

Como funciona

A arquitetura é simples:

Claude Code (Client)  ←→  MCP Server  ←→  Sistema externo

Você declara um MCP Server na sua configuração (um processo local ou serviço remoto)
O Claude Code conecta a esse Server na inicialização e recebe a lista de ferramentas expostas
Durante a sessão, o Claude pode chamar essas ferramentas assim como chama as integradas (Read, Write, Bash)
O MCP Server processa a requisição e retorna o resultado

Tudo isso é transparente para o usuário. O que você vê é o Claude dizendo "vou consultar o banco de dados" e retornando uma resposta — o MCP está gerenciando a comunicação em segundo plano.

Três tipos de capacidades MCP

Um MCP Server pode expor três tipos de coisas:

Tools (ferramentas)
Funções que o Claude pode chamar ativamente — "consultar a tabela de usuários", "pesquisar documentos", "enviar mensagem no Slack". Cobre 90% dos casos de uso reais.

Resources (recursos)
Dados estruturados que o Claude pode ler como contexto — schemas de banco de dados, documentação de API, arquivos de configuração.

Prompts (templates de prompt)
Fragmentos de prompt predefinidos que os usuários podem invocar diretamente.

Na prática, quase sempre você vai trabalhar com Tools.

Início rápido: adicionar um MCP Server existente

Usando o Filesystem MCP oficial como exemplo — esse Server dá ao Claude acesso a partes do sistema de arquivos além do diretório de trabalho.

Instalar

npm install -g @modelcontextprotocol/server-filesystem

Configurar

Edite ~/.claude/settings.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents"
      ]
    }
  }
}

Verificar

Reinicie o Claude Code e tente:

Liste todos os arquivos PDF em /Users/yourname/Documents

Se o Claude retornar resultados em vez de dizer "não consigo acessar o sistema de arquivos", o MCP está funcionando.

Estrutura da configuração

{
  "mcpServers": {
    "nome-do-servidor": {
      "command": "comando de início",
      "args": ["lista de argumentos"],
      "env": {
        "API_KEY": "xxx"
      }
    }
  }
}

command + args: como o Claude Code inicia o processo do MCP Server
O nome do servidor é apenas um identificador local — use o que fizer sentido
Use env para API keys e configurações sensíveis; não hardcode no código

Onde colocar a configuração

A configuração do MCP pode ficar em três lugares, do menor para o maior nível de prioridade:

Local	Arquivo	Quando usar
Global	`~/.claude/settings.json`	Ferramentas para todos os projetos
Projeto	`.claude/settings.json`	Ferramentas específicas deste projeto
Override local	`.claude/settings.local.json`	Configuração pessoal, não vai pro git

Para conexões a banco de dados e APIs internas, use a configuração de projeto e faça commit junto com o código. Membros da equipe que clonarem o repositório terão o mesmo ambiente MCP automaticamente.

Onde encontrar MCP Servers existentes

A Anthropic mantém um conjunto de servers oficiais:

@modelcontextprotocol/server-filesystem — acesso ao sistema de arquivos
@modelcontextprotocol/server-github — operações GitHub (PRs, issues, busca de código)
@modelcontextprotocol/server-postgres — queries PostgreSQL
@modelcontextprotocol/server-slack — ler e escrever mensagens no Slack
@modelcontextprotocol/server-google-maps — mapas e informações geográficas

A comunidade construiu muitos outros cobrindo Notion, Linear, Jira e vários bancos de dados.

MCP vs Hooks: qual escolher

	Hooks	MCP
Disparado quando	Claude executa uma ação específica	Claude chama ativamente uma ferramenta
Propósito	Interceptar ou melhorar comportamentos existentes	Adicionar novas capacidades
Casos típicos	Formatar ao salvar, verificar antes do commit	Consultar banco de dados, chamar API externa
Complexidade de configuração	Baixa	Média

São complementares. Hooks controlam como o Claude trabalha; MCP controla o que o Claude pode fazer.

Próximos passos

Este artigo é uma introdução conceitual ao MCP. Os próximos vão cobrir:

Conectar o Claude Code a um banco PostgreSQL real com schema real
Conectar ferramentas e APIs internas
Construir seu próprio MCP Server do zero

Se você já tem um sistema que quer conectar, confira primeiro a lista de MCP Servers — é bem provável que alguém já tenha construído o que você precisa.