Como conectar servidores MCP ao Claude Desktop

Servidores remotos: adicionar um conector personalizado

Abra o Claude Desktop, vá em Settings, depois Connectors, e clique em Add custom connector. Dê um nome, cole a URL do servidor e confirme. Conectores personalizados usando MCP remoto estão disponíveis nos planos Free, Pro, Max, Team e Enterprise; uma conta Free tem limite de um conector personalizado. Nos planos Team e Enterprise, um proprietário da organização adiciona o conector primeiro nas configurações da organização, e os membros o ativam depois na própria página de Connectors.

Servidores que suportam OAuth pedem que você faça login e aprove os escopos no navegador na primeira vez que os usar; nada mais é necessário. Uma seção opcional de Advanced settings recebe um client ID e um secret de OAuth para servidores que exigem um cliente pré-registrado, o que a maioria dos servidores públicos não exige. Para o servidor da HostTracker, a URL é https://mcp.host-tracker.com/mcp; ele usa OAuth com registro dinâmico de cliente, então o conector guarda apenas os escopos que você aprovar, e não há chave para colar.

Os conectores rodam do lado da Anthropic, não da sua máquina, então não conseguem alcançar um servidor na sua rede local, e são o mesmo mecanismo usado pelo claude.ai e pelo Cowork. O arquivo de configuração descrito a seguir é a contraparte local.

Servidores locais: editar o claude_desktop_config.json

Abra Settings, escolha a aba Developer e clique em Edit Config. Isso abre o arquivo de configuração no seu editor, criando-o se ainda não existir. O arquivo fica em ~/Library/Application Support/Claude/claude_desktop_config.json no macOS e em %APPDATA%\Claude\claude_desktop_config.json no Windows; na versão beta para Linux, use o botão Edit Config em vez de tentar adivinhar o caminho. Cada servidor é uma entrada dentro de mcpServers com o comando a executar e os argumentos dele:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Salve o arquivo, depois feche o Claude Desktop completamente e abra-o de novo; fechar a janela não basta, porque os servidores são iniciados quando o aplicativo abre. No Windows, o ambiente de execução do qual o comando depende, como o Node.js para o npx, precisa estar instalado e no PATH que o aplicativo desktop enxerga, então um servidor que funciona bem em um terminal mas não a partir do aplicativo costuma ser uma diferença de PATH.

Para ver se um servidor carregou, clique no ícone "Add files, connectors, and more" no canto inferior esquerdo da caixa de mensagem, passe o mouse sobre Connectors e abra Manage connectors; o servidor aparece lá com as ferramentas dele. Documentações mais antigas chamam isso de ícone do martelo, e a página de solução de problemas ainda usa esse nome em um dos títulos.

Extensões do diretório

Settings, depois Extensions, depois Browse extensions mostra um diretório selecionado de servidores locais empacotados como extensões, que se instalam com um único clique e se atualizam sozinhos. Um pacote baixado se instala pelo Install Extension, escolhendo o arquivo; esses pacotes usam o formato .mcpb, que substituiu o antigo nome .dxt, e podem envolver servidores em Node.js, Python ou binários. Pacotes distribuídos de forma privada não se atualizam sozinhos e precisam ser reinstalados manualmente depois de uma mudança.

Onde ficam os logs quando nada aparece

O Claude Desktop grava um log geral de conexão e um log por servidor. No macOS eles ficam em ~/Library/Logs/Claude/ como mcp.log e mcp-server-NAME.log; no Windows em %APPDATA%\Claude\logs. O arquivo de cada servidor traz a própria saída de erro dele, onde aparece detalhado um módulo ausente, um caminho errado ou uma credencial rejeitada. Se o arquivo estiver vazio, o aplicativo nunca conseguiu iniciar o comando, o que aponta de volta para o PATH ou para um erro de sintaxe JSON no arquivo de configuração.

Um aplicativo, duas superfícies

O Claude Desktop agora inclui uma aba Code que roda o Claude Code dentro do aplicativo, ao lado da aba Chat. Servidores declarados no claude_desktop_config.json ficam disponíveis tanto na superfície de chat quanto nas sessões locais da aba Code, junto com os do ~/.claude.json e do .mcp.json de um projeto; quando o mesmo nome existe nos dois lugares, a aba Code usa a definição do arquivo do desktop. O Claude Code de linha de comando independente não lê o arquivo do desktop. Se você configurou servidores primeiro no aplicativo desktop e quer usá-los no terminal, o claude mcp add-from-claude-desktop os importa no macOS e no Windows Subsystem for Linux, como descrito em como adicionar um servidor MCP ao Claude Code.

Um servidor de monitoramento remoto como primeiro conector

Um servidor remoto é o jeito mais rápido de confirmar que o fluxo do conector funciona, já que não há nada para instalar e a resposta é verificável. Adicione o servidor da HostTracker como um conector personalizado, faça login quando solicitado e pergunte ao Claude se um site que você conhece está no ar; a resposta deve citar uma verificação feita a partir dos pontos de checagem da HostTracker em localidades nomeadas, e não um palpite. A página do servidor MCP lista as 65 ferramentas e os escopos que cada uma exige, das verificações instantâneas às atualizações de página de status.