Skip to main content
Os conectores personalizados permitem que clientes Pro e Enterprise conectem APIs compatíveis que não estão na biblioteca de integrações do Replit. Use-os para conectar serviços especializados sem esperar por um conector oficial. Os conectores personalizados são adicionados ao seu workspace, não à sua conta pessoal. Administradores autorizados do workspace podem criá-los e gerenciá-los.
Os conectores personalizados estão em beta e disponíveis exclusivamente para clientes Enterprise. Administradores do workspace podem criá-los e gerenciá-los.

​
Antes de começar

Tenha em mãos o seguinte:
  • Uma assinatura Pro ou Enterprise ativa e permissão para gerenciar conectores no seu workspace.
  • Uma API REST HTTPS publicamente acessível e sua URL base.
  • Credenciais para a API e acesso à sua documentação.
  • Opcionalmente, um endpoint somente leitura que você pode usar para testar a conexão.
Os conectores de API personalizados são diferentes dos servidores MCP personalizados. Use Add custom connector para uma API; as opções de servidor MCP no mesmo menu são um fluxo de configuração separado.
Conecte-se apenas a APIs em que você confia com seus dados. Mantenha as credenciais fora da descrição do conector e das instruções do Agent. Insira-as apenas nos campos de autenticação.

​
Criar um conector personalizado

1

Abra o formulário de conector personalizado

Selecione Integrations na barra lateral do seu workspace Enterprise. Abra Add custom e, em seguida, selecione Add custom connector.
Página de integrações com o menu Add custom aberto e Add custom connector listado abaixo das opções de servidor MCP
2

Descreva a API

Preencha os seguintes campos:Substitua os valores de exemplo pelos do seu serviço. As instruções do Agent têm um limite de 500 caracteres.
Formulário de criação de conector de API personalizado mostrando nome, descrição, URL base, instruções do Agent, autenticação bearer e teste de endpoint opcional
3

Configure a autenticação

Selecione o método de autenticação que corresponde à sua API e preencha os campos exibidos.Para uma API que usa um token bearer, selecione Bearer token e insira o token sem o prefixo Bearer. O Replit adiciona o prefixo ao enviar uma solicitação.
4

Teste um endpoint

Opcionalmente, insira um caminho como /health em Endpoint test e selecione Check.A verificação envia uma solicitação GET antes de você salvar. Seu resultado não é salvo. Escolha um endpoint que sua API suporte e que não altere dados.Uma verificação bem-sucedida confirma essa solicitação, não todos os endpoints ou permissões que você possa precisar.
5

Salve o conector

Revise a configuração e, em seguida, selecione Save.

​
Solucionar problemas de um teste de endpoint

Se o teste falhar, verifique o seguinte com a documentação da sua API:
  • URL e caminho: confirme que a URL base e o caminho de teste formam o endpoint pretendido.
  • Autenticação: confirme que a credencial é válida e tem permissão para acessar o endpoint. Para autenticação bearer, omita o prefixo Bearer do campo de token.
  • Método da solicitação: escolha um endpoint que aceite solicitações GET.
  • Acessibilidade: confirme que a API é publicamente acessível via HTTPS.

​
Documentação relacionada