{"id":2317,"date":"2026-06-10T21:15:23","date_gmt":"2026-06-10T19:15:23","guid":{"rendered":"https:\/\/pletzenauer.com\/?p=2317"},"modified":"2026-08-21T12:41:13","modified_gmt":"2026-08-21T10:41:13","slug":"configurar-servidores-mcp-claude-desktop","status":"publish","type":"post","link":"https:\/\/pletzenauer.com\/pt-pt\/2026\/06\/10\/configurar-servidores-mcp-claude-desktop\/","title":{"rendered":"Configurar servidores MCP para o Claude Desktop: o que uso mesmo"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">O MCP \u00e9 a tomada normalizada entre o Claude Desktop e as suas ferramentas. Em vez de dez integra\u00e7\u00f5es propriet\u00e1rias, aplica\u00e7\u00e3o e ferramenta falam pelo mesmo protocolo \u2013 e liga o correio, o calend\u00e1rio ou o sistema de ficheiros diretamente, em vez de copiar e colar.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Perceber o ficheiro de configura\u00e7\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Um \u00fanico ficheiro controla que servidores o Claude Desktop conhece: <code>claude_desktop_config.json<\/code>. No macOS encontra-se em <code>~\/Library\/Application Support\/Claude<\/code>, no Windows em <code>%APPDATA%\\Claude<\/code>, no Linux em <code>~\/.config\/Claude<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Uma entrada por servidor, com nome, comando e argumentos. Opcionalmente vari\u00e1veis de ambiente, opcionalmente outro transporte. Depois de cada altera\u00e7\u00e3o a aplica\u00e7\u00e3o tem de ser reiniciada por completo \u2013 no macOS n\u00e3o basta fechar a janela.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Antes de ativar, passe um JSON-Lint. Uma \u00fanica v\u00edrgula em falta faz desaparecer a lista completa de servidores.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Seis servidores com que come\u00e7o mais vezes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Servidor de sistema de ficheiros.<\/strong> O Claude l\u00ea e escreve numa pasta claramente delimitada. Autorizar apenas um caminho explicitamente escolhido.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Servidor GitHub ou GitLab.<\/strong> Contexto do reposit\u00f3rio, pull requests, issues \u2013 uma conta de bot dedicada com permiss\u00f5es m\u00ednimas \u00e9 aqui obrigat\u00f3ria.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Servidor Notion ou Confluence.<\/strong> Ler e alimentar a base de conhecimento. Esclarecer antes as permiss\u00f5es das p\u00e1ginas, caso contr\u00e1rio o Claude sobrescreve \u00e1reas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Servidor Gmail ou Outlook.<\/strong> Pesquisar a caixa de correio e guardar rascunhos. Come\u00e7ar em modo de leitura; o envio s\u00f3 quando as regras estiverem definidas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Servidor Google Drive ou OneDrive.<\/strong> Resumir PDFs, consultar folhas de c\u00e1lculo, comparar vers\u00f5es. Nunca autorizar o Drive inteiro.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Servidor JIRA ou Linear.<\/strong> Levar os tickets como contexto. Preferir tokens de leitura; escrita s\u00f3 para tarefas bem delimitadas.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Quando o \u00edcone do martelo fica vazio<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Quatro sintomas representam, na pr\u00e1tica, 90 % dos casos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Erro de sintaxe JSON.<\/strong> Basta uma v\u00edrgula esquecida ou um par\u00eantesis a mais. Antes de guardar, passar por um JSON-Linter.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Caminho errado para o ficheiro execut\u00e1vel.<\/strong> Usar caminhos absolutos, n\u00e3o relativos. No macOS e no Linux, verificar as permiss\u00f5es de execu\u00e7\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Vari\u00e1veis de ambiente em falta.<\/strong> Os tokens e os caminhos pertencem ao bloco env da configura\u00e7\u00e3o do servidor. A aplica\u00e7\u00e3o n\u00e3o se fia no perfil da shell.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>O servidor bloqueia ao arrancar.<\/strong> Verificar no ficheiro de registo se o processo est\u00e1 \u00e0 espera de uma entrada. Causa frequente: um fluxo OAuth interativo que tem de ser percorrido uma vez.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Que servidores MCP fazem realmente sentido no Claude Desktop: a minha sele\u00e7\u00e3o comprovada, a configura\u00e7\u00e3o segura e o que uso de facto no dia a dia.<\/p>\n","protected":false},"author":0,"featured_media":1459,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2317","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-unkategorisiert"],"_links":{"self":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts\/2317","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=2317"}],"version-history":[{"count":2,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts\/2317\/revisions"}],"predecessor-version":[{"id":3163,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts\/2317\/revisions\/3163"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/media\/1459"}],"wp:attachment":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=2317"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=2317"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=2317"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}