# Conectores

Entenda os estados de uma conexão e escolha quais fontes e ações fazem sentido para sua tarefa.

Fonte: https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/

**TL;DR** · Conectores relacionam o Maestro a serviços externos. Abra **Conectores** na lateral e confira o estado antes de pedir uma ação.

![Formulario Adicionar via URL aberto a partir da aba Conectores, com os campos vazios e o botao Cancelar](https://guides.adapta.org/media/screenshots/maestro/conectores-permissoes-2026-09-18/conectores-permissoes-adicionar-url-2026-09-18.gif)

*Abra Adicionar via URL, confira os campos e cancele se nao for conectar agora.*

## Para que servem

Uma equipe pode precisar consultar documentos antes de uma reunião ou reunir informações de um sistema de atendimento. O conector é o caminho até esse serviço. A instrução explica o que fazer; a conexão e suas permissões determinam o acesso que pode estar disponível.

Não confunda consultar uma fonte com agir nela. Ler um documento para preparar um parecer não autoriza editá-lo ou enviá-lo a terceiros.

## Entenda cada estado

|  Estado |  O que significa nesta orientação |
| --- | --- |

|  Disponível |  O serviço aparece no catálogo. A conexão ainda precisa ser verificada. |

|  Instalado ou adicionado |  Termos que podem aparecer em outros fluxos; não foram confirmados como estado separado nesta tela. Não equivalem automaticamente a conectado. |

|  Conectado |  Rótulo exibido pelo Maestro para uma conexão da conta. Não certifica todos os acessos ou uma operação recente. |

|  Testado |  Uma tarefa específica foi executada, teve resultado conferido e escopo registrado. Não é um selo automático do catálogo. |

## O que aparece na interface

![Aba Conectores, com seis serviços já conectados (DeepWiki, Gmail, Google Calendar, Google Drive, Google Docs, WhatsApp) e outros disponíveis para conectar (Skip, Context7, GitHub, Google Sheets).](https://guides.adapta.org/media/screenshots/maestro/conectores-2026-09-10/conectores-lista.png)

*Aba Conectores, em 10/09/2026: 6 conectados, mais disponíveis abaixo.*

A página tem abas **Conectores** e **Integrações**, com busca e **Adicionar via URL** no topo. Em **Conectores**, cada item mostra um estado (com um indicador colorido), uma breve descrição e um controle: **Conectar** para os disponíveis, ou um interruptor mais **Reconectar** para os já conectados. Na inspeção, vários itens conectados (Gmail, Google Calendar, Google Drive, Google Docs, WhatsApp) exibiam **Reconectar** junto ao interruptor: um sinal de que a autorização pode ter expirado ou precisar de atenção, não necessariamente uma falha.

Clicar em **Conectar** num item disponível abre a tela de login do **próprio serviço externo** (por exemplo, a tela de login do serviço em outra aba), não um formulário do Maestro. Cancelar essa tela não afeta nenhuma conexão existente.

## Conectores × Integrações: dois catálogos diferentes

As duas abas não são a mesma lista com nomes diferentes. **Conectores** reúne serviços de uso comum (e-mail, agenda, arquivos, mensagens, documentação) conectados por login/OAuth do próprio serviço. **Integrações**, na inspeção de 10/09/2026, reunia acessos técnicos de infraestrutura: **GitHub** (autenticação da CLI `gh`, distinta do conector GitHub por OAuth), **Claude Code** (habilita a CLI num workspace), **AWS (assume role)** (acesso à AWS via papel IAM/STS), **Datadog** (CLI `pup` e Skill para métricas, logs e monitores) e **AWS EKS** (monta o `kubeconfig` do cluster para usar `kubectl`). Cada item explica, na própria descrição, se o acesso é por CLI, papel de nuvem ou OAuth: leia essa frase antes de conectar, porque muda o tipo de credencial exigida.

![Aba Integrações, com itens técnicos: GitHub (gh CLI), Claude Code (CLI), AWS (assume role via IAM/STS), Datadog (CLI) e AWS EKS (kubectl).](https://guides.adapta.org/media/screenshots/maestro/conectores-2026-09-10/integracoes-tecnicas-lista.png)

*Aba Integrações, em 10/09/2026: acesso via linha de comando e papéis de nuvem, não OAuth de app.*

### Quatro formas de credencial, num único catálogo

A distinção acima não é exclusiva do Maestro: catálogos de integração, de um modo geral, costumam variar a forma de autenticação por serviço, e o tipo de credencial muda o que fica registrado e o que pode ser revogado depois.

|  Forma de credencial |  Como funciona, em termos gerais |  Onde apareceu na inspeção |
| --- | --- | --- |

|  OAuth do próprio serviço |  Login na tela do serviço externo; o Maestro recebe um token de acesso, sem ver a senha. |  Todos os itens da aba **Conectores** (conectados ou disponíveis). |

|  Token ou API key |  Uma chave copiada do serviço externo e colada num formulário; não abre tela de login. |  Formulário **Adicionar via URL**, campo **Token (opcional)**. |

|  CLI autenticada no ambiente |  Um programa de linha de comando previamente autenticado onde o Maestro roda. |  **GitHub** (`gh`), **Claude Code** e **Datadog** (`pup`), na aba **Integrações**. |

|  Papel ou acesso de nuvem |  Uma permissão temporária ou configuração de cluster, sem senha fixa, delimitada por política. |  **AWS (assume role)** e **AWS EKS**, na aba **Integrações**. |

Confirme com o responsável técnico qual dessas formas se aplica antes de preencher qualquer campo; a tabela organiza o que já está descrito nas duas abas, não substitui a leitura da descrição de cada item.

Algumas descrições mencionam consumo de créditos de serviços externos. Não presuma que a assinatura do Maestro cubra as condições de outro serviço. Confira-as antes de autorizar uma tarefa que possa gerar cobrança.

## Conectores e outros recursos

[Skills](https://guides.adapta.org/guias/maestro/recursos-do-maestro/skills/) orientam métodos; [Ferramentas](https://guides.adapta.org/guias/maestro/recursos-do-maestro/ferramentas/) oferecem capacidades de ação. Um conector não deve ser tratado como sinônimo desses recursos. A aba Integrações também é uma área própria, não uma confirmação de que todos os serviços estão conectados.

**Dica prática:** defina a fonte e o resultado antes de escolher um acesso. Como Criar Assistentes de IA, aula 4, separa insumos, regras e formato da entrega. Aqui isso vira uma pergunta concreta: “quais documentos preciso consultar e o que não posso alterar?”.

## Próximos passos

- [Confira as permissões](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/permissoes/) antes de autenticar ou fornecer uma credencial.

- [Prepare a conexão e o teste](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/configurar-testar/) com uma amostra sintética e um resultado conferível.

Este guia cobre a leitura do catálogo e do formulário vazio por URL. Autenticação, instalação, reautorização, consulta a dados externos e alteração de conexões seguem em fluxos próprios, fora deste guia.

Confira aplicações nos [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).