Ir para conteúdo principal

Começando com Servidores MCP Locais no Claude Desktop

Atualizado esta semana

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, você agora 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

  1. Navegue até Configurações > Extensões no Claude Desktop.

  2. 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.

  3. Configure as configurações necessárias (como chaves de API) através da interface amigável.

  4. A extensão estará automaticamente disponível em suas conversas.

Instalando extensões de desktop personalizadas

  1. Navegue até Configurações > Extensões no Claude Desktop.

  2. Clique em "Configurações avançadas" e encontre a seção Desenvolvedor de Extensão.

  3. Clique em "Instalar Extensão…"

  4. 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:

  1. Ativar ou desativar extensões de desktop públicas dependendo dos padrões de segurança da sua organização.

  2. 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 Desenvolvedor de Extensão:

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 de máquina do usuário 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.

Isto respondeu à sua pergunta?