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.