Claude Code MCPs — Integre Ferramentas Externas

Imagine pedir ao Claude Code para consultar sua tabela de usuários no PostgreSQL, criar um ticket no Jira e atualizar a documentação na Notion — tudo sem sair do terminal. Isso não é ficção científica. É exatamente o que o Model Context Protocol (MCP) permite fazer. Enquanto os comandos nativos e os skills personalizados resolvem boa parte do fluxo de trabalho, o MCP é a ponte que conecta o Claude Code ao resto do seu ecossistema de desenvolvimento.

Se você já domina os comandos essenciais e quer expandir as capacidades do Claude Code para além do código-fonte, este artigo é o próximo passo.

O que é o Model Context Protocol e por que importa

O Model Context Protocol (MCP) é um padrão aberto criado pela Anthropic que define como modelos de IA se comunicam com ferramentas externas. Pense nele como uma “USB universal” para inteligência artificial: em vez de cada integração precisar de um conector proprietário, o MCP estabelece um protocolo comum que qualquer ferramenta pode implementar.

Na prática, o MCP funciona em uma arquitetura cliente-servidor:

• Cliente MCP: o próprio Claude Code, que envia requisições quando precisa acessar um recurso externo.
• Servidor MCP: um processo local ou remoto que expõe ferramentas, recursos e prompts para o Claude Code consumir.

Quando você configura um servidor MCP, o Claude Code passa a “enxergar” as ferramentas que esse servidor oferece. Se o servidor expõe uma função query_database, por exemplo, o Claude Code pode chamá-la automaticamente quando você pede algo como “me mostre os últimos 10 pedidos com status pendente”.

Por que isso muda o jogo

Sem MCP, o Claude Code opera apenas sobre arquivos locais e comandos de terminal. Com MCP, ele ganha acesso a:

• Bancos de dados (PostgreSQL, MySQL, SQLite)
• APIs de terceiros (GitHub, Slack, Jira, Notion)
• Sistemas de arquivos remotos
• Ferramentas de monitoramento e observabilidade
• Qualquer serviço que implemente o protocolo

Como configurar um servidor MCP no Claude Code

A configuração acontece no arquivo de settings do Claude Code. Existem dois escopos de configuração:

Passo 1 — Criar o arquivo de configuração

Para configuração por projeto, crie o arquivo na raiz do repositório:

mkdir -p .claude
touch .claude/mcp.json

Passo 2 — Definir o servidor MCP

A estrutura do JSON segue este padrão:

{
  "mcpServers": {
    "nome-do-servidor": {
      "command": "npx",
      "args": ["-y", "@pacote/mcp-server"],
      "env": {
        "VARIAVEL_DE_AMBIENTE": "valor"
      }
    }
  }
}

Cada servidor recebe um nome identificador, o comando para inicializá-lo e variáveis de ambiente opcionais (como tokens de API ou strings de conexão).

Passo 3 — Verificar a conexão

Após salvar o arquivo, reinicie o Claude Code. Ele detecta automaticamente os servidores configurados. Você pode verificar digitando:

/mcp

Esse comando lista todos os servidores MCP ativos e as ferramentas que cada um expõe.

MCPs populares para desenvolvedores

A comunidade já produziu dezenas de servidores MCP prontos para uso. Estes são os mais relevantes para o dia a dia de desenvolvimento:

Como escolher o servidor certo

Antes de sair instalando tudo, pergunte-se: qual tarefa repetitiva eu faço fora do editor que poderia ser delegada ao Claude Code? Se você consulta o banco de dados manualmente para validar dados durante o desenvolvimento, o servidor PostgreSQL ou SQLite faz sentido. Se você cria issues no GitHub pelo navegador enquanto codifica, o servidor GitHub elimina essa troca de contexto.

Exemplos de integração com APIs e bancos de dados

Vamos a cenários reais para que você veja o MCP em ação.

Exemplo 1 — Conectando ao PostgreSQL

Configuração no mcp.json:

{
  "mcpServers": {
    "postgres-local": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:password@localhost:5432/meu_banco"
      }
    }
  }
}

Depois de reiniciar o Claude Code, você pode fazer pedidos como:

• “Liste todas as tabelas do banco de dados”
• “Mostre os 5 últimos registros da tabela orders onde status é pending”
• “Crie uma migration para adicionar a coluna phone na tabela customers”

O Claude Code usa o servidor MCP para executar a consulta e retorna os resultados formatados diretamente no terminal.

Exemplo 2 — Integração com GitHub

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_seuTokenAqui"
      }
    }
  }
}

Com essa integração ativa, cenários práticos incluem:

• “Crie uma issue no repositório X com o bug que acabamos de encontrar”
• “Liste os PRs abertos que estão aguardando review”
• “Busque os comentários do PR #42”

Exemplo 3 — Servidor Fetch para APIs REST

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    }
  }
}

Este é o servidor mais versátil. Com ele, o Claude Code pode fazer requisições HTTP para qualquer endpoint. Útil para:

• Consultar documentação de APIs durante o desenvolvimento
• Testar endpoints que você acabou de criar
• Buscar dados de serviços externos para validar integrações

Criando seu próprio servidor MCP

Se nenhum servidor existente atende sua necessidade, criar um do zero é mais simples do que parece. O SDK oficial está disponível em TypeScript e Python.

Estrutura mínima de um servidor MCP em TypeScript:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({ name: "meu-servidor", version: "1.0.0" });

server.tool("minha_ferramenta", "Descrição do que faz", {
  parametro: { type: "string", description: "O que este parâmetro recebe" }
}, async ({ parametro }) => {
  // Sua lógica aqui
  return { content: [{ type: "text", text: `Resultado: ${parametro}` }] };
});

const transport = new StdioServerTransport();
await server.connect(transport);

O ponto-chave é a função server.tool(), que registra uma ferramenta com nome, descrição, parâmetros e a função que será executada. O Claude Code lê essas definições automaticamente e sabe quando e como chamar cada ferramenta.

Boas práticas para trabalhar com MCPs

1. Comece com um servidor por vez — adicione, teste e valide antes de empilhar integrações.
2. Descreva bem suas ferramentas — o Claude Code decide quando usar cada ferramenta baseado na descrição. Descrições vagas geram chamadas imprecisas.
3. Monitore o uso — servidores MCP executam operações reais. Um pedido mal formulado pode alterar dados no banco de produção se você apontar para o servidor errado.
4. Versione a configuração — mantenha um mcp.json.example no repositório com placeholders para que outros desenvolvedores do time saibam quais servidores configurar.

O MCP como extensão natural do fluxo de trabalho

O Model Context Protocol transforma o Claude Code de uma ferramenta de geração de código em um hub central de desenvolvimento. Cada servidor MCP que você adiciona elimina uma troca de contexto — e trocas de contexto são o maior inimigo da produtividade de quem desenvolve software.

Comece pelo servidor que resolve sua dor mais frequente. Se você vive alternando entre o terminal e o pgAdmin, instale o MCP de PostgreSQL. Se o Jira ou GitHub consomem seu tempo, comece por aí. A curva de aprendizado é mínima porque a interação continua sendo em linguagem natural — a diferença é que agora o Claude Code tem mãos para alcançar ferramentas que antes estavam fora do seu alcance.

Artigos relacionados

• Claude Code – Guia Completo para Criar Projetos com IA
• Claude Code Skills — Como Criar Comandos Personalizados

Bruno Bracaioli

Empreendedor e Desenvolvedor

Bruno Bracaioli é especialista em arquitetura de software, ciência de dados e cybersecurity. Além disso, investe em criptomoedas e em investimentos tradicionais como CDBs, Ações, Tesouro e outros. É influenciador digital no instagram (@brunobracaioli) e no Youtube (/brunobracaioli). Contato por: bruno@bracaiolitech.com ou pelo bruno@b2tech.com