Básicos do MCP

Problema: O Claude Code continua a bater em paredes. Ele edita os teus ficheiros e corre os teus comandos, mas no momento em que precisas de uma linha de base de dados, de uma issue do GitHub ou de um resultado de pesquisa recente, a resposta é não.

Ganho Rápido: Liga um servidor à tua configuração e a parede desaparece. Coloca isto no teu ficheiro de configuração do MCP:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-api-key" }
    }
  }
}

Reinicia o Claude Code, depois pede-lhe para "pesquisar as funcionalidades mais recentes do Next.js 15" e vê os resultados em tempo real a aparecerem.

O Que São Servidores MCP?

Um servidor MCP é um programa separado que expõe ferramentas ao Claude Code por um formato de comunicação partilhado. O nome do formato é Model Context Protocol. Instalas uma vez, o programa fica ao lado do Claude e responde quando é chamado.

Novidade em 2026: O MCP Tool Search já vem incluído no Claude Code. Carrega as definições dos servidores sob demanda, o que reduz a sobrecarga de contexto do MCP em até 95%. Podes ligar uma lista longa de servidores sem ver a janela de contexto desaparecer.

Pensa no que o Claude Code consegue fazer sozinho. Ficheiros. Comandos. Só isso. Com um servidor ligado, a mesma sessão consegue:

Buscar páginas ao vivo da internet
Executar queries em bases de dados e APIs
Controlar GitHub, Slack ou Google Sheets diretamente do chat
Aceder a ferramentas especializadas para um setor específico
Encadear passos por vários sistemas num único workflow
Comunicar com Telegram e Discord pelos Channels

Como Funcionam os Servidores MCP

Cada servidor MCP corre como o seu próprio processo. O Claude Code comunica com ele pelo protocolo, e o handshake segue sempre os mesmos quatro passos:

Ligação: O Claude Code abre um canal para o servidor MCP
Descoberta: O servidor lista as ferramentas e funções que expõe
Integração: Essas ferramentas aparecem na lista de ferramentas do Claude
Execução: O Claude pode chamá-las durante a conversa

// Claude Code CLI: ~/.claude.json or project-level .mcp.json
// Claude Desktop: claude_desktop_config.json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-api-key"
      }
    }
  }
}

Servidores MCP Essenciais para Instalar

Começa pelos mais importantes. Estes resolvem os problemas que a maioria dos programadores encontra logo no primeiro dia:

Acesso Web e Pesquisa:

Brave Search (@modelcontextprotocol/server-brave-search) - Capacidade de pesquisa na web
Fetch (@modelcontextprotocol/server-fetch) - Buscar e processar conteúdo web

Ferramentas de Desenvolvimento:

GitHub (@modelcontextprotocol/server-github) - Acesso e gestão de repositórios
Git (@modelcontextprotocol/server-git) - Operações git locais
PostgreSQL (@modelcontextprotocol/server-postgres) - Queries à base de dados

Operações de Ficheiros:

Filesystem (@modelcontextprotocol/server-filesystem) - Operações de ficheiros melhoradas
Google Drive (@modelcontextprotocol/server-gdrive) - Acesso a ficheiros na nuvem

Adiciona qualquer um destes ao bloco mcpServers usando a mesma estrutura do exemplo acima.

Cada servidor adiciona a sua fatia de capacidade. A lista de servidores MCP populares é onde encontras os que se encaixam no teu trabalho diário.

Processo de Configuração

Os servidores ficam em JSON. Não há comando de instalação. A configuração é feita em quatro passos curtos:

Localiza o teu ficheiro de configuração:

Claude Code CLI: ~/.claude.json ou .mcp.json na raiz do projeto
Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json

Adiciona a configuração do servidor:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-name"],
      "env": { "API_KEY": "your-key-here" }
    }
  }
}

Reinicia o Claude Code para carregar a nova configuração.
Testa no Claude Code: Pergunta ao Claude: "What MCP tools are available?" para ver as tuas extensões instaladas.

Problemas Comuns de Configuração e Soluções

Erro: "MCP server not found" Solução: Certifica-te de que o pacote está instalado globalmente e no caminho correto:

# Reinstall with explicit global flag
npm install -g @modelcontextprotocol/server-brave-search

Erro: "Authentication failed"

Solução: Verifica se as chaves de API estão exportadas na tua shell:

# Check environment variables
echo $BRAVE_API_KEY
echo $GITHUB_TOKEN

Erro: "Server connection timeout" Solução: Reinicia o Claude Code para que as ligações MCP sejam refeitas. Sai da sessão atual e abre uma nova para recarregar todos os servidores.

Comandos Rápidos de Ativar/Desativar

Não precisas de editar JSON para silenciar um servidor que está a dar problemas. Alterna diretamente do chat:

# Disable a server temporarily
/mcp disable supabase
 
# Re-enable when needed
/mcp enable supabase

É útil quando um servidor está a dar erros, ou quando a sua lista de ferramentas está a bagunçar os teus prompts. A entrada de configuração fica intacta. Só o estado ativo desta sessão é desligado.

Configuração Avançada

Alguns servidores querem parâmetros extra. Passas comandos personalizados e valores de ambiente assim:

{
  "mcpServers": {
    "custom-server": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LOG_LEVEL": "debug",
        "TIMEOUT": "30000"
      }
    }
  }
}

O que esse padrão te dá:

Servidores Node.js ou Python locais a correr nos teus próprios caminhos
Variáveis de ambiente personalizadas para chaves e ajustes
Logging de debug quando algo corre mal
Uma ponte para qualquer serviço que ofereça um servidor compatível com MCP

Próximas Ações

Escolhe um e põe-no a funcionar hoje:

Instala o teu primeiro servidor MCP: Escolhe o Brave Search para acesso imediato à web
Explora opções populares: Consulta o nosso guia de Servidores MCP Populares para recomendações selecionadas
Configura automação de browser: Aprende automação de browser com MCP para interações web avançadas
Cria integrações personalizadas: Constrói os teus próprios servidores MCP com o nosso tutorial de Integrações Personalizadas

Um servidor MCP muda a forma de todas as sessões do Claude Code. Adiciona o que precisas hoje. Adiciona o próximo quando a próxima parede aparecer. Se preferires saltar o processo de tentativa e erro, o Code Kit do ClaudeFast inclui um conjunto selecionado de configurações de servidores MCP juntamente com o seu sistema de 18 agentes, para que a primeira sessão já esteja toda ligada.

Básicos do MCP

On this page