Publicado originalmente em claudeguide.io/claude-code-mcp-server-setup

Claude Code MCP Server Setup: Um Guia Prático (2026)

O MCP (Model Context Protocol) permite que o Claude Code se comunique com ferramentas externas e fontes de dados através de uma interface padronizada. Em vez de o Claude ter que pesquisar na web ou ler arquivos manualmente, um servidor MCP pode expor ferramentas que o Claude chama diretamente — buscando threads do Slack, consultando bancos de dados, executando automação de navegador ou lendo de qualquer API em 2026.

Este guia cobre a configuração prática: onde a configuração vive, como adicionar servidores, as diferenças entre servidores locais e remotos, e como depurar quando as ferramentas não aparecem.

Onde a configuração do MCP vive

O Claude Code lê a configuração do servidor MCP de dois lugares:

Nível de usuário (aplica-se a todos os projetos):

~/.claude/claude_desktop_config.json

Nível de projeto (verificado no seu repositório):

.claude/mcp.json    # ou claude_desktop_config.json

A configuração de nível de projeto tem precedência para os servidores definidos lá. Ambos os arquivos são mesclados — você pode ter servidores globais (GitHub, Slack) e servidores específicos do projeto (uma conexão de banco de dados, um executor de teste local) ativos simultaneamente. Ambos os arquivos de configuração do MCP e as definições de hook vivem dentro do mesmo diretório .claude/ — consulte a referência do settings.json do Claude Code para o esquema completo.

Formato da configuração

Ambos os arquivos usam a mesma estrutura JSON:

{
  "mcpServers": {
    "server-name": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/server.js"],
      "env": {
        "API_KEY": "sua-chave-aqui"
      }
    }
  }
}

Os campos principais:

• "type": "stdio" para processos locais, "sse" para servidores HTTP remotos
• "command": o executável a ser executado
• "args": argumentos passados para o comando
• "env": variáveis de ambiente injetadas no processo do servidor

Adicionando um servidor local stdio

A maioria dos servidores MCP da comunidade são pacotes npm que rodam como processos locais. O padrão:

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/voce/projetos"]
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}


Após editar a configuração, reinicie o Claude Code. Novos servidores entram em vigor na próxima inicialização.


  Adicionando um servidor remoto SSE


Para servidores que funcionam como endpoints HTTP (por exemplo, um servidor MCP implantado que sua equipe executa):




{
  "mcpServers":