# Conectores

> Dê ao Endless acesso às ferramentas que você já usa, com o seu próprio login e sob um teto definido pelo espaço de trabalho.

Source: https://endless.app/pt/docs/automate/connectors

Um **conector** dá ao Endless um caminho até uma ferramenta que você já usa — seu rastreador
de issues, suas anotações, seu CRM — para que um chat possa ler dela e agir nela. A página é
**Configurações → Conectores*&#x2A;, com o título &#x2A;"Conecte as ferramentas que seu time já usa"*, e
todo membro do espaço de trabalho pode abri-la.

<Callout type="info">
  Uma skill ensina ao Endless *como* você trabalha. Um conector dá a ele
  *acesso* a outro lugar. Os dois são ligados e desligados do mesmo jeito, e
  essa é a única coisa que têm em comum — veja [skills e
  conhecimento](/pt/docs/concepts/skills-and-knowledge) para entender a diferença.
</Callout>

## Como conectar um

Cada conector é um card com o nome, uma linha sobre o que ele faz e um botão &#x2A;*+*&#x2A; com o
rótulo &#x2A;*"Conectar"** seguido do nome da ferramenta. O que acontece quando você o pressiona
depende de como aquela ferramenta autoriza o acesso.

<img alt="A página de conectores: um campo de busca do marketplace acima de uma grade Em destaque com cards de conectores — GitHub, Linear, Notion, PostHog, Granola, Stripe, HubSpot e DeepWiki — cada um com uma descrição de uma linha e um botão de mais para conectar, um visto indicando que já está conectado ou um selo Desligado" src="__img0" />

<Cards>
  <Card icon="<Shield />" title="Entrar com o provedor">
    Algumas ferramentas autorizam pela conta que você conecta ao próprio
    Endless. Você aprova as permissões na janela do provedor e volta. Pode ser
    que peçam para você confirmar sua identidade antes — isso é esperado.
  </Card>

  <Card icon="<Globe />" title="Autorizar em uma janela do navegador">
    A maioria das ferramentas faz a própria autorização: você é enviado até a
    ferramenta, aprova o acesso lá e volta para a página de conectores com
    &#x2A;*"Conector adicionado"**.
  </Card>

  <Card icon="<CircleCheck />" title="Sem login nenhum">
    Algumas poucas — em geral servidores públicos de documentação — não precisam
    de conta. O botão do card simplesmente liga o conector para você.
  </Card>
</Cards>

Depois de conectado, o card mostra um visto. Passe o mouse ou dê foco nele e o visto vira um
&#x2A;*×*&#x2A; — é o botão de desconectar. Ao lado fica um pequeno indicador de saúde que conta o que a
ferramenta está de fato fazendo: &#x2A;*"Verificando conexão"*&#x2A;, depois quantas ferramentas ela
oferece, ou &#x2A;*"Sem resposta"** se o servidor estiver fora do ar.

<Callout type="warn" icon="<TriangleWarning />">
  Alguns conectores dependem de um aplicativo registrado junto ao provedor do
  nosso lado antes que qualquer pessoa consiga concluir o fluxo. Onde isso ainda
  não existe, a conexão falha com um aviso &#x2A;"Não foi possível conectar"* e
  tentar de novo não ajuda — a correção não está nas suas mãos. Se um conector
  específico recusa a conexão repetidamente enquanto os outros funcionam, essa é
  a causa provável.
</Callout>

## Como encontrar um

O catálogo é uma grade com busca: um campo &#x2A;*"Buscar no marketplace…"** e um menu **Ordenar**
que oferece **Em destaque** ou **Nome**. Hoje ele cobre ferramentas de desenvolvimento e
produto, ferramentas de anotações e reuniões, CRM e pagamentos, analytics e servidores de
documentação.

<Callout type="info" icon="<Magnifier />">
  A lista cresce sem que nada precise ser instalado ou atualizado do seu lado —
  o que está na página é o que está disponível. Busque nela em vez de confiar em
  uma lista anotada em outro lugar.
</Callout>

## Dois interruptores, não um

Os conectores seguem o mesmo modelo de dois níveis das skills, com um passo extra próprio.

<Steps>
  <Step>
    ### O teto do espaço de trabalho

    Uma aba **Espaço de trabalho*&#x2A;, visível só para quem pode gerenciar as ferramentas do espaço
    de trabalho — uma permissão de governança que os admins têm por padrão e os membros comuns
    não. A dica dela: &#x2A;"Desligue um conector aqui para removê-lo para todo mundo no espaço de
    trabalho. Os membros escolhem por conta própria entre os que ficarem ligados."*
  </Step>

  <Step>
    ### A sua escolha

    A aba **Minhas ferramentas*&#x2A;, que é o que todo mundo vê sozinho. Onde o espaço de trabalho
    desligou algo, seu card mostra um selo bloqueado &#x2A;*"Desligado"** no lugar do botão.
  </Step>

  <Step>
    ### O seu login

    O passo que as skills não têm. &#x2A;*Habilitado não é o mesmo que conectado.** Um conector
    deixado ligado para o espaço de trabalho, mas em que você nunca fez login, não faz nada — as
    credenciais são suas, pessoais, e ninguém pode concedê-las no seu lugar.
  </Step>
</Steps>

<Callout type="warn" icon="<Lock />">
  Desligar um conector para o espaço de trabalho o remove para todo mundo na
  hora, inclusive para quem já tinha conectado. Ligá-lo não conecta ninguém —
  cada pessoa ainda faz o próprio login.
</Callout>

<Cards>
  <Card icon="<Users />" title="Quem controla o teto" href="/pt/docs/governance/roles-and-permissions">
    A permissão por trás da aba **Espaço de trabalho** e quais funções a têm.
  </Card>

  <Card icon="<Eye />" title="Ajustes por pessoa">
    Um admin também pode definir os conectores de uma pessoa pelo perfil dela em
    **Membros**, na seção **Acesso** — ainda limitado pelo teto do espaço de
    trabalho.
  </Card>
</Cards>

## Como adicionar um servidor seu

Abaixo do catálogo fica &#x2A;*"Servidores MCP personalizados"*&#x2A; — &#x2A;"Adicione seu próprio servidor
MCP (Slack, Granola, …) para usar as ferramentas dele dentro do chat."* Se uma ferramenta que
você usa publica um endpoint MCP, você pode apontar o Endless para ele sem esperar que apareça
no catálogo.

<Steps>
  <Step>
    ### Descreva o servidor

    Um **Rótulo do servidor*&#x2A; (o exemplo mostrado é &#x2A;"Rótulo (ex.: Granola)"*), a **URL do
    servidor** e um **Transporte** — `http` ou `sse`, o que o servidor documentar.
  </Step>

  <Step>
    ### Escolha como ele autentica

    **Bearer token** se o servidor aceita um token que você já tem — cole-o e ele é criptografado
    antes de ser armazenado. **OAuth*&#x2A; se o servidor faz o próprio login: &#x2A;"Você será
    redirecionado ao servidor para entrar depois de adicioná-lo."*
  </Step>

  <Step>
    ### Adicione

    **"Adicionar servidor"*&#x2A;, ou &#x2A;*"Adicionar e conectar"** quando o handshake OAuth vem logo em
    seguida. O servidor passa a aparecer como uma linha em que você pode **Conectar**, **Editar**
    ou **Remover**, com as mesmas abas **Minhas ferramentas** e **Espaço de trabalho*&#x2A; — a dica do
    espaço de trabalho aqui diz &#x2A;"Desligue um servidor aqui para removê-lo para todo mundo no
    espaço de trabalho."*
  </Step>
</Steps>

<Callout type="info">
  Adicionar um servidor personalizado exige permissão para criar conteúdo, que
  membros e admins têm por padrão e visualizadores não. Editar ou remover um
  servidor que outra pessoa adicionou exige as permissões mais amplas para agir
  sobre o trabalho dos outros.
</Callout>

Uma seção vazia avisa: &#x2A;*"Nenhum servidor personalizado ainda"*&#x2A; / &#x2A;"Adicione a URL de um
servidor MCP acima para expor as ferramentas dele ao chat."*

<Callout type="warn" icon="<Trash />">
  Um servidor personalizado é uma conexão ativa com algo fora do Endless,
  guardando credenciais que você forneceu. Adicione servidores em que você
  confia e remova os que parar de usar, em vez de deixá-los apenas desligados.
</Callout>

## Como usá-los

<Cards>
  <Card icon="<Book />" title="No chat" href="/pt/docs/chat">
    As ferramentas de um conector conectado ficam simplesmente disponíveis. Você
    descreve o que quer; o Endless escolhe a ferramenta certa.
  </Card>

  <Card icon="<CalendarClock />" title="Em execuções agendadas" href="/pt/docs/automate/scheduled-tasks">
    O controle **Ferramentas** de um agendamento lista só os conectores que você
    realmente conectou — um conector sem conexão não conseguiria rodar sozinho,
    então nem é oferecido. Desconecte um conector e todo agendamento que depende
    dele começa a falhar.
  </Card>

  <Card icon="<Wrench />" title="Limitado por agendamento" href="/pt/docs/automate/scheduled-tasks">
    Você pode desligar conectores específicos em um agendamento sem mudar o que
    fica disponível para você em todo o resto.
  </Card>
</Cards>

<Cards>
  <Card icon="<Plug />" title="Skills" href="/pt/docs/automate/skills">
    A outra forma de estender o Endless — instruções em vez de acesso.
  </Card>

  <Card icon="<Globe />" title="O caminho contrário" href="/pt/docs/connect">
    A Endless publica um servidor MCP próprio, então Claude, ChatGPT, Cursor e
    VS Code podem ler seu espaço de trabalho, trazer arquivos e gerar mídia.
  </Card>

  <Card icon="<Toggle />" title="Como os dois níveis se encaixam" href="/pt/docs/concepts/skills-and-knowledge">
    Skills, conhecimento e conectores lado a lado.
  </Card>
</Cards>
