> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectores personalizados

> Saiba como clientes Pro e Enterprise podem criar um conector de API personalizado, configurar a autenticação e testar um endpoint para um serviço fora da biblioteca do Replit.

Os conectores personalizados permitem que clientes Pro e Enterprise conectem APIs
compatíveis que não estão na [biblioteca de integrações](/pt/features/integrations/overview)
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.

<Note>
  Os conectores personalizados estão em beta e disponíveis exclusivamente para
  clientes Enterprise. Administradores do workspace podem criá-los e gerenciá-los.
</Note>

## 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](/pt/features/mcp/overview)
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.

<Warning>
  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.
</Warning>

## Criar um conector personalizado

<Steps>
  <Step title="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**.

    <Frame>
      <img src="https://mintcdn.com/replit/UBZvDR_D82VVmneQ/images/connectors/custom-connectors/add-custom-connector.png?fit=max&auto=format&n=UBZvDR_D82VVmneQ&q=85&s=fe6d895207b33622e9e5be3310900fd0" alt="Página de integrações com o menu Add custom aberto e Add custom connector listado abaixo das opções de servidor MCP" width="1716" height="1177" data-path="images/connectors/custom-connectors/add-custom-connector.png" />
    </Frame>
  </Step>

  <Step title="Descreva a API">
    Preencha os seguintes campos:

    | Campo                  | O que inserir                                                                                                     | Exemplo                                                              |
    | ---------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
    | **Connector name**     | Um nome reconhecível para o serviço.                                                                              | `Acme API`                                                           |
    | **Description**        | Uma breve descrição do que a API faz.                                                                             | `Create and track customer orders`                                   |
    | **Base URL**           | A URL raiz da API, incluindo qualquer prefixo de versão necessário.                                               | `https://api.example.com`                                            |
    | **Agent instructions** | Orientações sobre como usar a API, como uma URL de documentação e convenções de endpoint. Não inclua credenciais. | `Read https://api.example.com/docs. Use GET /orders to list orders.` |

    Substitua os valores de exemplo pelos do seu serviço. As instruções do Agent
    têm um limite de 500 caracteres.

    <Frame>
      <img src="https://mintcdn.com/replit/UBZvDR_D82VVmneQ/images/connectors/custom-connectors/create-custom-connector.png?fit=max&auto=format&n=UBZvDR_D82VVmneQ&q=85&s=97a0463c8c54c3837f2884fbc37ccd01" alt="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" width="1716" height="1177" data-path="images/connectors/custom-connectors/create-custom-connector.png" />
    </Frame>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Salve o conector">
    Revise a configuração e, em seguida, selecione **Save**.
  </Step>
</Steps>

## 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

* [Integrações do Agent](/pt/features/integrations/overview) — Explore as integrações compatíveis
* [Gerenciando seus conectores](/pt/replitai/managing-connectors) — Administração de conectores para o seu workspace