Como instalar servidores MCP no Claude Desktop (passo a passo)

Adicione qualquer servidor MCP ao Claude Desktop: onde fica o claude_desktop_config.json no macOS e no Windows, exemplo de configuração e solução de problemas.

Antes de começar

Você precisa do aplicativo Claude Desktop. A maioria dos servidores também exige Node.js (para comandos npx) ou Python com uv (para comandos uvx); o README do servidor informa qual.

1. Abra o arquivo de configuração

Clique no menu Claude na barra de menus do sistema (não nas configurações dentro da janela do chat), escolha Settings… e abra Developer → Edit Config. Isso abre o claude_desktop_config.json. No macOS ele fica em ~/Library/Application Support/Claude/claude_desktop_config.json e no Windows em %APPDATA%\Claude\claude_desktop_config.json.

2. Adicione o servidor

Adicione uma entrada em mcpServers. Este exemplo adiciona o servidor oficial Filesystem com acesso a uma pasta:

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

3. Reinicie e confira

Feche o Claude Desktop por completo e abra de novo. Na caixa de chat, clique em Add files, connectors, and more, abra Connectors → Manage connectors e selecione seu servidor para ver as ferramentas. Se ele não conectar, veja os logs (mcp.log e mcp-server-NOME.log) em ~/Library/Logs/Claude no macOS ou %APPDATA%\Claude\logs no Windows.

Dicas

Use caminhos absolutos.
Coloque as chaves de API em um objeto env dentro da entrada do servidor.
Muitas páginas de servidores no Socketlist mostram uma configuração pronta, copiada do README.