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 de extensões de desktop, 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 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 de extensões de desktop para compartilhar mais informações conosco.
Instalando extensões de desktop do diretório
Navegue até Configurações > Extensões no Claude Desktop.
Clique em "Procurar extensões" para visualizar nosso diretório e clique em qualquer ferramenta revisada pela Anthropic que deseja usar. Clique em "Instalar" na extensão desejada.
Configure as configurações necessárias (como chaves de API) através da interface amigável.
A extensão estará automaticamente disponível em suas conversas.
Instalando extensões de desktop personalizadas
Navegue até Configurações > Extensões no Claude Desktop.
Clique em "Configurações avançadas" e encontre a seção Extension Developer.
Clique em "Instalar Extensão…"
Selecione o arquivo .mcpb e siga os prompts para instalar.
Controles de Administrador para Extensões de Desktop
Proprietários e Proprietários Primários de planos Team e Enterprise podem gerenciar o acesso da equipe a extensões de desktop usando dois controles:
Ativar ou desativar extensões de desktop públicas dependendo dos padrões de segurança da sua organização.
Fazer upload de extensões de desktop personalizadas e disponibilizá-las para sua equipe para instalação com um clique.
Esses controles permitem que as organizações personalizem totalmente seus registros adicionando apenas as extensões que a equipe precisa acessar e removendo quaisquer outras.
Ativando/desativando extensões específicas em planos Team e Enterprise
Proprietários e Proprietários Primários de organizações Team e Enterprise podem gerenciar quais extensões de desktop estão ativadas para sua organização e acessíveis a outros membros via Claude Desktop. Consulte Ativando e usando a lista de permissões de extensão de desktop
para instruções específicas.
Criar e fazer upload de extensões personalizadas para sua organização
Os uploads de extensões de desktop personalizadas permitem que planos Team e Enterprise aproveitem fluxos de trabalho específicos da organização que não estão disponíveis no diretório público. Após criar uma extensão de desktop personalizada, Proprietários e Proprietários Primários podem navegar até Configurações > Extensões no Claude Desktop e clicar em "Configurações avançadas" para acessar a seção Extension Developer:
Clique em "Instalar Extensão…" e selecione o arquivo .mcpb. Siga os prompts para instalar e configurar sua extensão de desktop personalizada. Para informações mais detalhadas, consulte nossa documentação do desenvolvedor de extensão de desktop.
Controles de Política Enterprise
Nota: Os controles de política Enterprise no nível do usuário-máquina substituirão quaisquer controles no aplicativo (lista de bloqueio e lista de permissões). Se você deseja usar um controle no aplicativo, certifique-se de que isDesktopExtensionEnabled e isDesktopExtensionDirectoryEnabled não estão definidos como "false" para que a lista de permissões possa preencher o registro disponível.
Para controlar extensões de desktop através de políticas do sistema, consulte nossa documentação de configuração enterprise de desktop.
Resolvendo problemas de instalação de extensão de desktop
A extensão não será instalada
Certifique-se de que está executando a versão mais recente do Claude Desktop.
Verifique se o arquivo de extensão não está corrompido baixando-o novamente.
Verifique se você tem espaço em disco suficiente para a instalação.
A 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 de configuração da extensão para campos obrigatórios ausentes.
Verifique se as chaves de API ou credenciais de autenticação foram inseridas corretamente.
Problemas de configuração de extensão
Navegue até 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 enterprise, verifique se as extensões de desktop estão ativadas através das políticas da sua organização.
FAQ do Desenvolvedor
Como verifico se meus servidores MCP estão conectados corretamente no Claude Desktop?
Clique no botão "+" na parte inferior da caixa de chat no Claude Desktop e selecione "Conectores". Isso mostrará seus servidores MCP conectados e suas ferramentas. Alternativamente, você pode visitar as configurações do Desenvolvedor (em Desktop app) para ver o status da conexão e verificar os logs de qualquer servidor MCP.
Como converto meu servidor MCP existente em uma extensão de desktop?
Adicione um arquivo manifest.json ao diretório do seu servidor MCP com os metadados necessários.
Empacote-o usando o comando
mcpb pack.Consulte a documentação do MCPB para instruções detalhadas.
Quais linguagens de programação são suportadas para extensões de desktop?
As extensões de desktop suportam Node.js, Python e servidores MCP binários. O Claude Desktop inclui um ambiente Node.js integrado, portanto a instalação do Node.js não é necessária.
Como lidar com configuração sensível 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 de desktop personalizada de forma privada?
Sim, você pode compartilhar arquivos .mcpb diretamente com usuários ou equipes específicas. Para distribuição mais ampla, você pode enviar extensões para o diretório oficial.
Como faço para depurar problemas com minha extensão de desktop?
Ative o registro de depuração nas configurações do Claude Desktop, verifique os logs de extensão no painel de configurações de Extensões e consulte o guia de depuração do MCP para solução de problemas específicos do protocolo.
O que acontece quando minha extensão precisa de atualizações?
As extensões do diretório oficial são atualizadas automaticamente por padrão. Para extensões distribuídas de forma privada, os usuários precisarão instalar arquivos .mcpb atualizados manualmente.
Interessado em aprender mais sobre MCP?
Para informações mais detalhadas sobre como construir seus próprios clientes e servidores MCP, recomendamos revisar os seguintes recursos:
Guia de Início Rápido do MCP - Um tutorial passo a passo perfeito para começar com integração básica do MCP.
Github do Model Context Protocol - Contém a documentação técnica completa, exemplos de código e guias de implementação.
Guia para depuração de integrações MCP - Dicas de solução de problemas e soluções para desafios comuns de implementação.
Se você precisar de mais orientação, visite nosso guia sobre Como Obter Suporte para opções de suporte adicionais.