Conectores
Entenda os estados de uma conexão e escolha quais fontes e ações fazem sentido para sua tarefa.
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, 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, 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 orientam métodos; 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.
Próximos passos
- Confira as permissões antes de autenticar ou fornecer uma credencial.
- Prepare a conexão e o teste 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.