MCP no Claude para 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 dentro do 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
Solução de 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 necessários
Para ambientes empresariais, verifique se as extensões de desktop estão habilitadas através das políticas da 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?
As 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 os 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.
O que acontece quando minha extensão precisa de atualizações?
Extensões do diretório oficial são atualizadas automaticamente por padrão. Para extensões distribuídas privadamente, os usuários precisarão instalar arquivos .dxt atualizados manualmente.
Controles de Política Empresarial
Administradores empresariais podem controlar extensões de desktop através de políticas do sistema:
Configuração Empresarial macOS
Configure extensões de desktop através de um arquivo de lista de propriedades em
~/Library/Preferences/com.anthropic.Claude.plist:
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>isDxtEnabled</key> <true/> <key>isDxtDirectoryEnabled</key> <false/> <key>isDxtSignatureRequired</key> <true/> <key>dxtRegistry</key> <string>https://registry.example.com</string></dict></plist>
Configuração Empresarial Windows
Configure extensões de desktop através de políticas do Registro do Windows em HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Claude ou HKEY_CURRENT_USER\SOFTWARE\