# Integrações do ambiente

Diferencie recursos do ambiente de execução e conectores antes de preparar uma tarefa técnica.

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

**TL;DR** · Abra **Conectores → Integrações** para consultar os recursos do ambiente. Essa aba não é o catálogo de conectores: algumas opções preparam programas ou acessos usados em tarefas técnicas. Ativar uma integração é uma etapa separada, com autenticação e configuração próprias.

![Gravação do Maestro: na página Conectores, a aba Integrações é aberta e a lista mostra GitHub, Claude Code, AWS assume role, Datadog e AWS EKS, cada um com a descrição do tipo de acesso e um botão Conectar que não é acionado.](https://guides.adapta.org/media/screenshots/maestro/integracoes-permissoes-2026-09-19/maestro-integracoes-aba-fluxo.gif)

*A aba Integrações fica ao lado de Conectores e lista outro tipo de acesso: CLI autenticada e papel de nuvem, não conector de serviço. Ler a lista não conecta nada.*

## Quando consultar esta área

Uma equipe técnica pode precisar trabalhar com um repositório de código, analisar uma operação em nuvem ou usar programas no ambiente do agente. Antes de pedir a execução, é necessário entender qual acesso e qual recurso a tarefa exige.

![Aba Integrações dentro de Conectores, com GitHub, Claude Code, AWS (assume role), Datadog e AWS EKS, todos com botão Conectar.](https://guides.adapta.org/media/screenshots/maestro/conectores-2026-09-10/integracoes-tecnicas-lista.png)

*Aba Integrações, conferida em 10/09/2026: a lista bate com a tabela abaixo.*

Pense no ambiente como uma bancada de trabalho: ter o nome de uma ferramenta na lista não significa que ela esteja pronta, autorizada ou testada. Se você quer apenas preparar uma pauta a partir de informações já fornecidas, não precisa presumir que uma integração seja necessária.

## Integração não é sinônimo de conector

As duas abas ficam na mesma página, mas apresentam caminhos diferentes. Em **Integrações**, a descrição do GitHub menciona `gh CLI` e uma Skill de comandos. A do Datadog menciona a CLI `pup` e uma Skill de uso. Ambas orientam usar o respectivo **conector** para ferramentas nativas via OAuth, uma forma de autorizar acesso pelo serviço.

CLI significa um programa operado por comandos. Não é preciso dominar esses comandos para consultar o catálogo, mas configurar e autorizar seu uso pode exigir o responsável técnico.

Uma integração pode dar acesso a recursos do ambiente; uma [Skill](https://guides.adapta.org/guias/maestro/recursos-do-maestro/skills/) orienta um método; [Ferramentas](https://guides.adapta.org/guias/maestro/recursos-do-maestro/ferramentas/) oferecem capacidades de ação. Esses nomes não são intercambiáveis. Consulte [Conectores](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/) quando sua dúvida for sobre aquela outra aba.

## Opções observadas

Estas são descrições exibidas na interface (reconferidas em 10/09/2026), não resultados homologados:

|  Opção |  Finalidade apresentada |
| --- | --- |

|  GitHub |  CLI `gh` autenticada e Skill de comandos para issues, PRs, repositórios e Actions. |

|  Claude Code |  Habilitar a CLI no workspace para tarefas de código e worktrees, áreas de trabalho de código. |

|  AWS (assume role) |  Assumir um papel IAM via STS para acesso à AWS pelo agente. O papel define permissões; seu alcance precisa de conferência técnica. |

|  Datadog |  CLI `pup` e Skill para métricas, logs e monitores. |

|  AWS EKS (kubectl) |  Preparar o `kubeconfig` de um cluster EKS na inicialização para uso de `kubectl`. São recursos de acesso a um ambiente de aplicações. |

Cada opção mostra **Conectar** nesta lista. Não deduza disso disponibilidade em todas as contas, instalação concluída, comandos permitidos, limites de plano ou ausência de cobrança externa.

## Escolha pelo trabalho, não pelo nome

Para uma reunião sobre uma implantação, comece pelo resultado: uma lista de bloqueios, fontes e decisões. Se um relatório sintético fornecido na conversa já contém os dados necessários, a tarefa pode ser preparada sem acesso à infraestrutura.

Se a equipe realmente precisa consultar um repositório ou ambiente, defina qual deles e para quê. Uma análise não autoriza criar uma alteração, executar uma implantação ou modificar permissões. Veja [como conferir os acessos do ambiente](https://guides.adapta.org/guias/maestro/recursos-do-maestro/integracoes/permissoes/) antes de prosseguir.

**Dica prática:** descreva a função da tarefa antes do recurso. Como Criar Assistentes de IA, aula 4, ensina a separar propósito, regras e insumos. Aqui, “identificar bloqueios usando o relatório indicado, sem alterar o ambiente” orienta melhor a decisão que “conecte tudo”.

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