O Claude Desktop foi um dos primeiros clientes a implementar MCP, justamente por ser da Anthropic. Na prática, isso significa que você tende a encontrar menos surpresas aqui do que em clientes que adotaram o protocolo depois.
Passo 1: localize o arquivo de configuração
O Claude Desktop guarda a configuração de MCP em um arquivo JSON, cujo caminho varia conforme o sistema operacional:
| Sistema | Caminho do arquivo |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
A forma mais confiável de chegar ao arquivo é pelas configurações do aplicativo, que oferecem um atalho para editá-lo. Procurar manualmente pelo caminho funciona, mas é onde mais se erra em Windows, por causa da variável de ambiente.
Passo 2: declare o servidor
O formato é o mesmo usado por outros clientes MCP. Este exemplo é o servidor de arquivos, que é o melhor ponto de partida:
{
"mcpServers": {
"arquivos": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/caminho/para/sua/pasta"
]
}
}
}Atenção ao escopo do último argumento. Ele define quais arquivos o Claude poderá ler. Aponte para uma pasta específica de trabalho — nunca para o diretório pessoal inteiro nem para a raiz do sistema.
Passo 3: reinicie e confirme
O Claude Desktop lê a configuração na inicialização. Sair completamente do aplicativo (não apenas fechar a janela) e abrir de novo é o que faz o servidor aparecer.
Depois de reiniciar, o indicador de ferramentas na interface mostra quais servidores foram conectados. Se um servidor falhar, a mensagem de erro aparece ali — leia com atenção, porque normalmente ela aponta o caminho errado.
Passo 4: teste
Peça algo que só possa ser respondido lendo os arquivos autorizados. Por exemplo: "Leia o arquivo de configuração do projeto e resuma as dependências principais."
Se o Claude citar conteúdo real dos seus arquivos, a configuração funcionou. Como o Claude Desktop exige aprovação explícita no primeiro uso de cada ferramenta, é normal ele pedir confirmação.
Adicionando mais servidores
Para adicionar outro servidor, inclua uma nova entrada dentro de `mcpServers`. Cada entrada é independente e precisa de uma vírgula separando as anteriores:
{
"mcpServers": {
"arquivos": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/caminho/projeto"]
},
"notas": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}Problemas comuns
| Sintoma | Causa provável | Solução |
|---|---|---|
| Servidor não aparece | Aplicativo não foi reiniciado por completo | Saia do aplicativo e abra novamente |
| Erro de sintaxe | Vírgula faltando ou sobrando no JSON | Valide o JSON antes de salvar |
| Comando não encontrado | Node.js não instalado ou fora do PATH | Instale o Node.js; no Windows, reinicie o sistema |
| "Permissão negada" | Caminho fora do escopo autorizado | Aponte para um diretório dentro do escopo declarado |
| Ferramenta não é usada | Descrição da ferramenta ambígua | Combine o pedido com um contexto mais explícito |
Segurança
- Escopo mínimo: apenas a pasta necessária, nunca o diretório pessoal inteiro.
- Revise o código de servidores de terceiros antes de conectar. A instalação fácil é exatamente o que torna a revisão necessária.
- Prefira servidores de leitura quando o objetivo não exigir alterações.
- Se um servidor acessa dados sensíveis, lembre que o conteúdo entra no contexto enviado ao provedor do modelo.