Configurar servidores MCP para o Claude Desktop: o que uso mesmo

O MCP é a tomada normalizada entre o Claude Desktop e as suas ferramentas. Em vez de dez integrações proprietárias, aplicação e ferramenta falam pelo mesmo protocolo – e liga o correio, o calendário ou o sistema de ficheiros diretamente, em vez de copiar e colar.

Perceber o ficheiro de configuração

Um único ficheiro controla que servidores o Claude Desktop conhece: claude_desktop_config.json. No macOS encontra-se em ~/Library/Application Support/Claude, no Windows em %APPDATA%\Claude, no Linux em ~/.config/Claude.

Uma entrada por servidor, com nome, comando e argumentos. Opcionalmente variáveis de ambiente, opcionalmente outro transporte. Depois de cada alteração a aplicação tem de ser reiniciada por completo – no macOS não basta fechar a janela.

Antes de ativar, passe um JSON-Lint. Uma única vírgula em falta faz desaparecer a lista completa de servidores.

Seis servidores com que começo mais vezes

Servidor de sistema de ficheiros. O Claude lê e escreve numa pasta claramente delimitada. Autorizar apenas um caminho explicitamente escolhido.

Servidor GitHub ou GitLab. Contexto do repositório, pull requests, issues – uma conta de bot dedicada com permissões mínimas é aqui obrigatória.

Servidor Notion ou Confluence. Ler e alimentar a base de conhecimento. Esclarecer antes as permissões das páginas, caso contrário o Claude sobrescreve áreas.

Servidor Gmail ou Outlook. Pesquisar a caixa de correio e guardar rascunhos. Começar em modo de leitura; o envio só quando as regras estiverem definidas.

Servidor Google Drive ou OneDrive. Resumir PDFs, consultar folhas de cálculo, comparar versões. Nunca autorizar o Drive inteiro.

Servidor JIRA ou Linear. Levar os tickets como contexto. Preferir tokens de leitura; escrita só para tarefas bem delimitadas.

Quando o ícone do martelo fica vazio

Quatro sintomas representam, na prática, 90 % dos casos.

Erro de sintaxe JSON. Basta uma vírgula esquecida ou um parêntesis a mais. Antes de guardar, passar por um JSON-Linter.

Caminho errado para o ficheiro executável. Usar caminhos absolutos, não relativos. No macOS e no Linux, verificar as permissões de execução.

Variáveis de ambiente em falta. Os tokens e os caminhos pertencem ao bloco env da configuração do servidor. A aplicação não se fia no perfil da shell.

O servidor bloqueia ao arrancar. Verificar no ficheiro de registo se o processo está à espera de uma entrada. Causa frequente: um fluxo OAuth interativo que tem de ser percorrido uma vez.