MCP no Claude Desktop é atualmente um recurso beta.
O Model Context Protocol (MCP) é um protocolo aberto que permite integração perfeita entre aplicações LLM e fontes de dados e ferramentas externas. Com a introdução das extensões de desktop (DXT), instalar e gerenciar servidores MCP locais tornou-se significativamente mais fácil.
Extensões de Desktop
As extensões de desktop fornecem uma maneira simplificada de instalar e gerenciar servidores MCP locais através de pacotes instaláveis com um único clique. Em vez de configurar manualmente arquivos JSON e gerenciar dependências, agora você pode instalar servidores MCP locais no seu computador tão facilmente quanto extensões de navegador.
Nota: Estamos construindo um diretório de extensões de desktop – se você é um desenvolvedor esperando adicionar uma extensão que construiu ao diretório, complete nosso formulário de interesse em extensões de desktop para compartilhar mais informações conosco.
Instalando Extensões de Desktop
Navegue para Configurações > Extensões no Claude Desktop.
Navegue pelo diretório de extensões ou instale a partir de um arquivo .dxt.
Clique em "Instalar" na extensão desejada.
Configure quaisquer configurações necessárias (como chaves de API) através da interface amigável ao usuário.
A extensão estará automaticamente disponível em suas conversas.
Habilitando/desabilitando extensões específicas nos planos Team e Enterprise
Proprietários e Proprietários Principais de organizações Team e Enterprise podem gerenciar quais DXTs estão habilitadas para sua organização e acessíveis a outros membros via Claude Desktop.
Abra o Claude Desktop.
Clique em suas iniciais ou nome no canto inferior esquerdo, depois "Configurações".
Clique em "Extensões" sob Aplicativo de desktop.
Selecione a aba "Extensões da organização" no canto superior direito.
Desta página, clique em "..." > "Desabilitar" ao lado de quaisquer extensões que você queira impedir que membros de sua organização acessem.
Você também pode usar os filtros no topo da lista para visualizar apenas extensões habilitadas ou desabilitadas.
Nota: Depois que um Proprietário habilita ou desabilita extensões, pode levar até duas horas para que os membros vejam as mudanças refletidas em suas contas.
Solucionando problemas de instalação de extensões de desktop
Extensão não instala
Certifique-se de que está executando a versão mais recente do Claude Desktop.
Verifique se o arquivo da extensão não está corrompido baixando-o novamente.
Verifique se você tem espaço em disco suficiente para a instalação.
Extensão aparece instalada mas as ferramentas não estão disponíveis
Reinicie o Claude Desktop para atualizar o registro de extensões.
Verifique as configurações da extensão para campos obrigatórios ausentes.
Verifique se quaisquer chaves de API ou credenciais de autenticação estão inseridas corretamente.
Problemas de configuração da extensão
Navegue para Configurações > Extensões e clique na extensão para revisar suas configurações.
Certifique-se de que todos os campos de configuração obrigatórios estão preenchidos.
Verifique se os caminhos de arquivo (se aplicável) apontam para diretórios existentes aos quais você tem acesso.
Erros de permissão ou segurança
No macOS, verifique Preferências do Sistema > Segurança e Privacidade se receber avisos de segurança.
No Windows, certifique-se de que o Claude Desktop tem as permissões necessárias para acessar os diretórios requeridos.
Para ambientes empresariais, verifique se as extensões de desktop estão habilitadas através das políticas de sua organização.
FAQ do Desenvolvedor
Como converto meu servidor MCP existente para uma extensão DXT?
Adicione um arquivo manifest.json ao diretório do seu servidor MCP com os metadados necessários.
Empacote-o usando o comando dxt pack.
Veja a documentação DXT para instruções detalhadas.
Quais linguagens de programação são suportadas para extensões DXT?
Extensões DXT suportam Node.js, Python e servidores MCP binários. O Claude Desktop inclui um ambiente Node.js integrado, então a instalação do Node.js não é necessária.
Como lidar com configurações sensíveis como chaves de API?
Marque campos de configuração como "sensitive": true no seu manifest.json. O Claude Desktop criptografará automaticamente esses valores usando o armazenamento seguro do sistema operacional (Keychain no macOS, Credential Manager no Windows).
Posso distribuir minha extensão DXT privadamente?
Sim, você pode compartilhar arquivos .dxt diretamente com usuários ou equipes específicas. Para distribuição mais ampla, você pode submeter extensões ao diretório oficial.
Como depuro problemas com minha extensão DXT?
Habilite o log de depuração nas configurações do Claude Desktop, verifique os logs da extensão no painel de configurações de Extensões, e consulte o guia de depuração MCP para solução de problemas específicos do protocolo.