Resumo: Como conectar conectores personalizados do Claude

Um conector personalizado é uma configuração que permite conectar o Claude a uma ferramenta externa que você utiliza. Você também pode adicionar ferramentas como tl;dv, usando o recurso de diretório de ferramentas avaliadas da Anthropic apenas alguns cliques.

Para adicionar um conector personalizado, acesse:

  1. Configurações
  2. Conectores
  3. Adicionar conector personalizado
  4. Em seguida, cole a URL (geralmente termina com /mcp, mas pode variar)
  5. Configure o OAuth ou uma chave de API
  6. Ative essa função no seu chat
  7. Teste com uma solicitação simples de leitura

 

Um ponto importante a ser observado ao configurar um conector personalizado é que ele deve estar acessível publicamente via HTTPS, já que o Claude utiliza a nuvem Anthropice não o seu computador.

Os planos gratuitos do Claude permitem a utilização de um conector personalizado. As contas pagas permitem conectar vários conectores, sem nenhum custo adicional além do que você pagaria pela ferramenta externa.

Índice

Como adicionar um conector personalizado no Claude? O Claude em 2026 é uma ferramenta incrivelmente poderosa por si só; ele é capaz de fazer muitas coisas. No entanto, seu desempenho pode ser limitado pela quantidade de informações às quais tem acesso e pela sua habilidade em formular prompts.

Adicionar um conector personalizado permite integrar ferramentas que você já utiliza, como tl;dv. Algumas ferramentas são adicionadas automaticamente a partir do diretório pronto do Claude. Outras exigem algumas etapas manuais, e é aí que as pessoas podem ter um pouco de dificuldade.

O que é, na verdade, um conector personalizado

Um conector personalizado conecta um aplicativo, uma ferramenta ou uma fonte de dados por meio do endereço da web de um servidor remote do Protocolo de Contexto remote (MCP).

Ao estabelecer essa conexão, o Claude pode acessar e utilizar os recursos desse serviço, trazendo essas informações e funcionalidades para o seu ecossistema do Claude, seja pela interface do LLM, pelo Claude Cowork, pelo Claude Code ou até mesmo pelo Claude Design.

Um servidor MCP é o padrão aberto Anthropicpara conectar a IA a ferramentas e dados externos. O conector é a forma pela qual o Claude “se comunica” com ele.

Conectores de diretório x conectores personalizados

Existem dois tipos diferentes de conectores no Claude.

  • Conectores de diretório
  • Conectores personalizados

 

Os conectores de diretório são aqueles que Anthropic e oferece nativamente na interface, como nos exemplos abaixo. Eles podem ser conectados com um simples clique e estão prontos para uso, talvez exigindo apenas algumas etapas para o login.

Diretório de Conectores Claude
Conectores para diretores da Claude

Conectores personalizados exigem um pouco mais de trabalho.

Eles precisam ser implementados pelo usuário. Embora, “nos bastidores”, sejam iguais aos conectores de diretório — já que ambos rodam no MCP —, a principal diferença é que não são verificados pela Anthropic precisam ser configurados manualmente.

O que é um plugin?

Uma coisa que é preciso ter em mente é a diferença entre um plugin, um conector e uma skill:

  • O conector é algo que conecta o Claude a um serviço externo.
  • O plugin é um pacote que você pode instalar e que inclui conectores, habilidades e ferramentas.
  • As habilidades são um conjunto de instruções para realizar uma tarefa repetidamente.

O que você deve ter à mão antes de começar a conectar um conector personalizado

Há quatro pontos importantes que devem ser configurados antes de conectar um conector personalizado ao Claude. Nenhum deles exige programação.

Um URL de servidor MCP acessível ao público

Para conectar o Claude ao seu conector personalizado, o servidor em que ele está hospedado precisa estar aberto à internet pública por meio de HTTPS. Isso significa que, se ele estiver em uma rede privada, tiver uma VPN ou um firewall, não estará acessível. Você pode adicionar os intervalos de IP Anthropicpara habilitar o acesso em algumas circunstâncias.

O Plano Certo

O plano que você possui na Anthropic quantos conectores você pode configurar.

A versão gratuita permite um conector personalizado.

Se você estiver em um plano com preço mais alto, como o Pro, Max, Team ou Enterprise, poderá adicionar vários. A configuração pode ser feita tanto pelo aplicativo da web quanto pelo aplicativo para desktop.

É importante observar que os planos Team e Enterprise exigem que o conector seja restrito a determinados projetos.

Acesso de proprietário no plano Team ou Enterprise

Em um plano Team ou Enterprise, apenas um Proprietário ou Proprietário Principal pode adicionar um conector à organização.

Os membros regulares não podem adicionar um por conta própria, mas podem se conectar a qualquer conector que um Proprietário já tenha configurado.

Portanto, se você precisar que um novo conector seja adicionado, será necessário solicitar isso a alguém com acesso de Proprietário.

Seus dados de autenticação

Para se conectar, você precisará comprovar sua identidade, e a forma de fazer isso depende do servidor. Uma das formas mais comuns é usar o OAuth, que consiste simplesmente em fazer login e aprovar o acesso.

Encontre e verifique a URL do seu conector

Para encontrar a URL necessária para conectar sua ferramenta externa ao Claude, procure a URL do conector na documentação da ferramenta ou na página do conector. Ela pode estar um pouco escondida, mas trata-se do endpoint MCP, o endereço com o qual o Claude realmente se comunica, e normalmente terá algo como /mcp no final. Por exemplo, https://app.tool.com/mcp, em vez da página inicial. Esse é apenas um exemplo, e o caminho exato provavelmente será diferente.

É provável que a central de ajuda ou a documentação da empresa contenha essas informações e, normalmente, também apresente um passo a passo de configuração a ser seguido, incluindo se é necessário usar o OAuth ou uma chave de API.

Uma coisa que você pode verificar é abrir o link do endpoint no seu navegador usando sua conexão normal à internet, sem nenhuma VPN. A página não vai ficar muito bonita, mas deve responder em vez de apresentar tempo limite, o que indica que está ativo. Certifique-se de clicar em um link de um serviço confiável.

Como adicionar um conector no Pro ou no Max

Se você tem um plano individual, como o Pro ou o Max, adicionar um conector personalizado é incrivelmente simples. Quando você tiver sua URL, siga estas cinco etapas.

  1. Abra “Configurações ” e vá para “Personalizar” e, em seguida, “Conectores”.
  2. Clique no menu suspenso“Adicionar”, no canto superior direito da janela pop-up.
  3. Selecione“Adicionar conector personalizado” na parte inferior da lista.
  4. Cole a URL do seu servidor MCP no campo (o endpoint que termina em /mcp da última seção) e dê ao conector um nome que deixe claro do que se trata.
  5. Se o servidor usar OAuth, abra as configurações avançadas e adicione seu ID de cliente e seu segredo; em seguida, clique em “Adicionar” para concluir.

Em seguida, o Claude deve abrir uma janela de login. Você deve então aprovar as permissões necessárias, e o conector já estará ativo e disponível em seus chats imediatamente.

Claude: Adicionar conector personalizado
Adicionando um conector personalizado

Também é possível adicionar um conector diretamente em um chat, pressionando o sinal de mais próximo da caixa de comando e seguindo as abas do menu até encontrar a opção “Adicionar conector personalizado”. É nesse mesmo local que você pode ativar e desativar seus conectores.

Se a janela de login não aparecer, isso geralmente se deve a um problema com a URL ou com a autenticação, e a seção de solução de problemas aborda essa questão.

Como adicionar um conector no Team ou no Enterprise

Conectar um conector personalizado à sua conta do Team ou Enterprise é um pouco diferente, envolve duas etapas e depende do seu nível de acesso.

Um Proprietário ou Proprietário Principal deve adicionar o conector para toda a organização. Em seguida, cada membro da equipe deve conectar sua própria conta do Claude a ele antes de poder utilizá-lo.

Etapas do proprietário

  1. Abra as configurações da Organização e acesse “Conectores”.
  2. Clique em “Adicionar”.
  3. Passe o mouse sobre “Personalizado” e, em seguida, selecione “Web”.
  4. Cole a URL do servidor remote .
  5. Para adicionar a autenticação, abra as configurações avançadas e insira o ID do cliente OAuth e o segredo do cliente.
  6. Clique em “Adicionar”. O conector agora está disponível para que todos na organização possam se conectar a ele.

Etapas para membros

Conforme mencionado anteriormente, os membros das organizações não podem adicionar novos conectores por conta própria. Esses conectores devem ser configurados pelo Proprietário ou pelo Proprietário Principal do espaço de trabalho. Se um conector tiver sido criado, os membros poderão se conectar a ele.

  1. Abra o “Personalizar”, vá até “Conectores” e encontre aquele que seu proprietário adicionou.
  2. Clique em “Conectar ” ao lado dele.
  3. Faça login na ferramenta, aprove as permissões solicitadas e ela já estará disponível em seus chats.

Escolhendo como o Claude realiza a autenticação

Existem três opções para a autenticação de um conector personalizado pelo Claude.

O OAuth é o método padrão. Você clica em “Conectar”, o Claude redireciona você para a tela de consentimento da ferramenta e, assim que você aprovar, a ferramenta retorna um token em vez da sua senha. O Claude armazena esse token, e você pode revogá-lo a qualquer momento sem alterar seus dados de login. Quando o servidor solicitar, seu ID de cliente e seu segredo devem ser inseridos nas configurações avançadas durante a instalação. Os tokens são atualizados em segundo plano, então você raramente precisará se autenticar novamente. Há apenas uma ressalva: a URI de redirecionamento ou callback (para onde a ferramenta o redireciona após o login) precisa corresponder exatamente. Um único caractere errado e o login falha.

Os cabeçalhos de solicitação abrangem servidores que utilizam credenciais fixas, como uma chave de API ou um token de portador. Você cola a chave no campo do cabeçalho e o Claude a armazena com segurança. Isso é comum em servidores auto-hospedados e, no momento, está em fase beta; portanto, é possível que ocorram algumas falhas esporádicas.

Também não é possível realizar a autenticação, mas tenha cuidado ao lidar com isso. Um conector ativo que contenha dados reais nunca deve ser deixado aberto.

Ligue e verifique se funciona

Para usar seu conector, primeiro ative-o. Isso pode ser feito em qualquer conversa clicando no botão + no canto inferior esquerdo da caixa de prompt. Abra “Conectores” e ative aqueles que você deseja usar nessa conversa.

Confirme se está conectado

Depois de ativado, o conector pode exibir as diversas ferramentas às quais agora tem acesso. Se as ferramentas forem listadas, isso confirma que o Claude está se comunicando com o servidor. Se nada aparecer, ou se o botão de ativação não permanecer ativado, significa que a conexão não foi estabelecida.

Tema da sua primeira prova

Para testar, faça uma solicitação simples, pedindo ao Claude algo que você saiba que a ferramenta tem acesso. Por exemplo, se você estiver conectado ao tl;dv do MCP, pode perguntar: “Quais são algumas das minhas tl;dv mais recentes tl;dv ?”. Se a resposta for o que você precisa, está funcionando. Caso contrário, talvez a função não esteja ativada ou precise de reparos

Na primeira vez que você usar uma ferramenta com o conector, receberá uma mensagem do Claude na janela de bate-papo solicitando sua permissão para executá-la. Você pode aprovar com uma única ação ou optar por“Permitir sempre”,o que manterá a conexão ativa. Anthropic selecionar “Permitir sempre” apenas para ferramentas nas quais você confia para serem executadas sem supervisão, como aquelas que apenas leem dados, em vez de enviar informações ou alterá-los.

Modos de carregamento de ferramentas e custo de contexto

Existem três modos nos quais Claude pode carregar um conector, e o modo selecionado pode determinar quanto espaço ainda resta para a conversa.
  • O recurso “Auto” permite que Claude escolha quais ferramentas carregar com base nas suas instruções.
  • O modo “Sempre disponível ” mantém todas as ferramentas desse conector específico disponíveis durante todo o bate-papo.
  • O modo “sob demanda ” carrega as ferramentas e os conectores apenas quando especificamente solicitado.
Cada ferramenta pode armazenar o contexto, que é a memória de trabalho da conversa. Quando você começa a sobrepor diferentes conectores, com várias ferramentas associadas a cada um, o sistema pode ficar bastante pesado e consumir muitos tokens. É nesse momento que se deve usar Sob demanda. Se você estiver usando vários conectores, mas de forma intermitente, poderá optar por incluí-los na área de trabalho apenas quando necessário, em vez de fazê-lo a cada solicitação. Você também pode desativar ferramentas específicas que não vai usar, para que o Claude pare de carregá-las.

Como conectar seus registros de reuniões do tl;dv

tl;dv um poderoso conjunto de ferramentas e um assistente de reuniões baseado em IA. Ele grava reuniões, cria transcrições e resumos e registra tudo o que acontece nas reuniões.

tl;dv um servidor MCP nativo que se conecta diretamente ao Claude; assim, todas as reuniões Google Meet, Zoom, Teams ou qualquer outra reunião capturada pelo aplicativo para desktop podem ser importadas diretamente para o Claude.

A rota do diretório

tl;dv disponível como um conector no diretório de aplicativos confiáveis da Anthropic. Basta clicar no botão, fazer login uma vez e você terá acesso somente para leitura às suas gravações.

tl;dv : Diretório tl;dv

Assim que estiver no ar, você poderá fazer perguntas como:

  • Resuma a transcrição da ligação com o cliente de ontem
  • Identifique as ações a serem realizadas a partir das reuniões da equipe desta semana
  • Encontre todas as reuniões em que discutimos os preços
  • Me informe sobre as ligações que perdi enquanto estive fora
  • Redija um e-mail de acompanhamento com base na minha última ligação de vendas

 

E como tl;dv já tl;dv um conector de diretório revisado e aprovado, você não precisa passar pelo processo de configuração de conector personalizado mencionado acima. O fluxo do conector personalizado é mais útil quando uma ferramenta não aparece no diretório, mas oferece o MCP; seguindo as etapas descritas acima, você pode conectá-la.

Como editar e remover um conector

Não há função de edição. Para alterar a URL ou os detalhes de autenticação, remova o conector e adicione-o novamente.

Para remover um, abra “Configurações”, depois “Conectores”, clique no conector e selecione “Remover”.

No Team e no Enterprise, um proprietário faz isso nas configurações da organização para que a alteração seja aplicada a todos.

A remoção de um conector revoga imediatamente o acesso de Claude àquela ferramenta.

Quando um conector não se conecta: solução de problemas

A maioria das falhas no conector se resume a problemas de conectividade ou autenticação. Quando ocorrer uma falha, anote o ID de referência ofid_ que o Claude exibe na mensagem de erro; a equipe de suporte irá solicitá-lo.

Não foi possível acessar o servidor MCP. Essa é a causa mais comum. Seu endpoint não está acessível publicamente. Acesse-o a partir de uma rede fora da sua VPN e verifique se ele responde por HTTPS.

Bloqueio por firewall, WAF ou CDN. Se seus logs de borda mostrarem respostas 403 ou 429 para Anthropic, isso significa que um firewall ou uma CDN está filtrando o tráfego. Adicione os intervalos de IPs de saída Anthropicà lista de permissões.

Redirecionamentos que comprometem a autenticação. Um redirecionamento 301, 302, 307 ou 308 perde o cabeçalho “Authorization” ao longo do caminho. Registre a URL final no Claude, e não uma que redirecione.

Um código 404 ou 500 do servidor. Um código 404 geralmente significa que o caminho da URL está incorreto; muitas vezes, o endpoint /mcp está faltando ou foi digitado incorretamente. Um código 500 indica um erro do próprio servidor; portanto, verifique os logs do servidor, em vez de qualquer coisa no Claude.

Falha na autorização ou erro 401. O OAuth passa por três etapas de descoberta, e qualquer falha em qualquer uma delas resulta em um erro 401. Duas causas comuns: o URI do seu ID de aplicativo precisa corresponder exatamente, sem barra final, e o seu URI de redirecionamento precisa corresponder ao que o Claude usa, caractere por caractere.

Conectado, mas nenhuma ferramenta é exibida. A conexão foi estabelecida, mas o servidor não disponibilizou nada útil. Verifique se o servidor está realmente disponibilizando sua lista de ferramentas. Se as ferramentas forem exibidas, mas o Claude não as utilizar, certifique-se de que a opção esteja ativada para aquela conversa e de que você tenha aprovado a ferramenta quando solicitado.

A autenticação foi perdida após uma reinicialização. Às vezes, a reinicialização do servidor invalida o token. Remova e reconecte o conector para realizar uma nova autenticação.

Ainda está com dificuldades? Reúna três informações antes de entrar em contato com o suporte: o ID de referência ofid_, a URL exata do servidor que você inseriu e os logs do servidor a partir do momento em que ocorreu a falha. Com essas informações, o suporte poderá rastrear a solicitação do início ao fim, em vez de ter que adivinhar.

Segurança, permissões e seus dados

Os conectores personalizados são seguros de usar. O único ponto a se ter em mente é que Anthropic conectores de diretório, como tl;dv, mas não os conectores personalizados que você mesmo adiciona. Um servidor personalizado é aquele pelo qual você se responsabiliza; portanto, conecte-se apenas a servidores nos quais você confia e que você controla.

Você mantém o controle no momento da conexão. Leia a solicitação de permissão antes de aprová-la, conceda os escopos mais restritos necessários para a tarefa e opte pelo acesso somente para leitura sempre que for oferecido. Se a ferramenta permitir que você configure as permissões individualmente, as configurações “Sempre permitir” , “Precisa de aprovação” e “Bloqueado” do Claude permitem que você aprove acessos de leitura e bloqueie qualquer ação que possa excluir ou sobrescrever seus dados.

Também vale a pena saber sobre a injeção de prompts, em que os dados retornados por um conector contêm instruções ocultas destinadas ao Claude. Anthropic medidas de defesa contra isso, e seu próprio bom senso é a outra parte: tenha um cuidado redobrado com servidores que lidam com conteúdo não confiável ou público.

O que acontece com seus dados

Um conector só tem acesso ao que sua própria conta tem acesso; ele herda suas permissões, nada além disso. O que Anthropic com os dados que passam por ele — incluindo se eles são usados para treinamento e por quanto tempo são retidos — depende do seu plano e das suas configurações; portanto, verifique a documentação de privacidadeAnthropic e seus controles de dados, em vez de simplesmente presumir. Tenha um cuidado redobrado com o Research, que pode acionar ferramentas por conta própria; assim, um conector pode ser chamado sem que você precise solicitá-lo diretamente a cada vez.

E o seu mecanismo de desativação continua simples. Revogue o acesso no Claude removendo o conector ou desative-o no serviço de origem girando a chave ou revogando a autorização do aplicativo.

Aproveitando ao máximo um Claude conectado

Essa é a configuração, desde encontrar a URL correta do servidor até se conectar e testar sua conexão por meio de um prompt. Depois de conectar uma ferramenta, o processo segue as mesmas etapas e abre um amplo leque de possibilidades sobre como usar o Claude para gerenciar seus dados.

Para começar, experimente com uma ferramenta que você usa todos os dias. E se não souber por onde começar, experimente primeiro com tl;dv, usando o diretório para conectá-lo, em vez da configuração do conector personalizado. Ao conectar sua tl;dv , comece pedindo ao Claude as ações pendentes da sua última chamada e comece a ver as possibilidades que podem surgir a partir disso.

Perguntas frequentes sobre como adicionar um conector Claude personalizado em 2026

Não. O plano Gratuito permite um conector personalizado. Os planos Pro, Max, Team e Enterprise permitem adicionar vários, sem limite.

Abra “Configurações”, vá para “Personalizar”, depois para “Conectores” e selecione “Adicionar conector personalizado”. As etapas são as mesmas no Mac e no Windows, já que a configuração fica na sua conta do Claude, e não no computador.

Um conector de diretório é previamente revisado pela Anthropic adicionado com um clique. Um conector personalizado é qualquer servidor remote que você adicionar por meio de sua URL. Ambos são executados na mesma infraestrutura do MCP.

Sim, mas use conectores sem autenticação apenas para desenvolvimento e testes. Qualquer conector que contenha dados reais deve usar OAuth ou uma chave de API.

O Claude se conecta pela nuvem Anthropic, e não pelo seu computador; portanto, um servidor no localhost ou atrás de uma VPN não pode ser acessado. É necessário um URL HTTPS público.

Não há botão de edição. Para alterar uma URL ou credencial, remova o conector e adicione-o novamente com os novos detalhes.

Não. Os conectores já estão incluídos no seu plano Claude atual. Você paga apenas o que a ferramenta conectada cobrar por conta própria.