Publicado originalmente em claudeguide.io/claude-mcp-servers-guide

Servidores Claude MCP: Como Estender Claude com Ferramentas Personalizadas

Servidores MCP (Model Context Protocol) são processos locais que expõem ferramentas, recursos e prompts para Claude — permitindo que Claude Code chame seus bancos de dados internos, APIs e scripts diretamente, sem nenhum código de aplicativo personalizado. Você registra um servidor MCP uma vez em sua configuração, e cada sessão de Claude Code naquela máquina pode usá-lo. Este guia cobre como instalar servidores existentes, construir o seu próprio em Python e quando usar MCP em vez da API de uso de ferramentas em 2026.

O que é MCP e por que é importante

O Model Context Protocol é um padrão aberto que define como um host (Claude Code) descobre e chama capacidades de um processo de servidor em execução na sua máquina. Um servidor MCP anuncia três coisas:

• Ferramentas — funções que Claude pode chamar (ler um arquivo, consultar um banco de dados, executar um script)
• Recursos — fontes de dados que Claude pode ler (arquivos, esquemas de banco de dados, respostas de API)
• Prompts — modelos de prompt reutilizáveis para fluxos de trabalho comuns

Antes do MCP, estender Claude significava escrever um aplicativo personalizado usando a API de uso de ferramentas ou colar dados na conversa manualmente. O MCP dá ao Claude Code uma interface de plug-in padrão: escreva um servidor uma vez, use-o em todos os lugares onde o Claude Code é executado.

O protocolo funciona sobre stdio ou HTTP. O Claude Code inicia o processo do servidor na inicialização e se comunica com ele através da entrada/saída padrão. O processo do servidor vive na sua máquina — nada é enviado para os servidores da Anthropic, exceto os resultados das ferramentas que Claude precisa para formar sua resposta.

MCP vs a API de uso de ferramentas

Esses dois mecanismos de extensão resolvem problemas diferentes e não são intercambiáveis:

Se você está construindo um aplicativo web que usa Claude para ajudar os usuários, use a API de uso de ferramentas. Se você está estendendo seu próprio fluxo de trabalho do Claude Code para se conectar a um banco de dados privado ou API interna, use o MCP. A distinção é: o uso de ferramentas é para aplicativos que você envia, o MCP é para ferramentas que você usa.

Instalando servidores MCP existentes no Claude Code

A Anthropic e a comunidade mantêm um registro crescente de servidores MCP prontos para uso. Instalar um requer duas coisas: o pacote do servidor (geralmente um pacote npm) e uma entrada de configuração informando ao Claude Code como iniciá-lo.

Adicione servidores a ~/.claude/claude_desktop_config.json para disponibilidade global, ou a .claude/settings.json em um diretório de projeto para acesso específico do projeto:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allow"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "seu-token"
      }
    }
  }
}

Os campos command e args definem como o Claude Code inicia o servidor. O campo env injeta variáveis de ambiente no processo do servidor — use isso para chaves de API e credenciais em vez de codificá-las diretamente no servidor.

Após salvar a configuração, reinicie o Claude Code. Execute /mcp no Claude Code para confirmar que os servidores estão conectados e suas ferramentas estão disponíveis.

Servidores MCP populares que valem a pena instalar

@modelcontextprotocol/server-filesystem — Dá ao Claude acesso de leitura e gravação a um diretório especificado. Útil para permitir que o Claude Code trabalhe com arquivos fora do projeto atual.

@modelcontextprotocol/server-github — Acesso completo à API do GitHub: ler problemas e PRs, criar branches, enviar commits, gerenciar repositórios. Requer um token de acesso pessoal com os escopos apropriados.

@modelcontextprotocol/server-slack — Ler e postar mensagens, pesquisar canais, procurar usuários. Útil para construir resumos ou notificações assistidas pelo Claude em seu fluxo de trabalho.

@modelcontextprotocol/server-postgres — Consultar um banco de dados PostgreSQL diretamente do Claude Code. Claude pode inspecionar esquemas, executar consultas de leitura e usar os resultados em suas respostas sem que você copie os dados manualmente.

@modelcontextprotocol/server-brave-search — Pesquisa na web via API do Brave Search. Dá ao Claude acesso a informações atuais sem sair do Claude Code.

@playwright/mcp — Automação de navegador. Claude pode navegar em páginas, extrair conteúdo, preencher formulários e tirar capturas de tela. Útil para scraping e testes de fluxos de trabalho.

Construindo seu próprio servidor MCP em Python

O pacote mcp Python fornece uma estrutura de servidor que lida com os detalhes do protocolo. Instale-o com pip install mcp.

Um servidor mínimo tem dois manipuladores: um que lista as ferramentas disponíveis e um que as executa:

python
from mcp.server import Server
from mcp.server.models import Initializa