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

# Conectores

> Conecte contas como GitHub e Gmail para que as sessões na nuvem possam ler e escrever nesses serviços em seu nome. Gerencie o acesso, reconecte e desconecte.

**Conectores** são contas de terceiros que você autoriza para o AIHubMix Cloud. Depois de conectados, as sessões na nuvem podem usar esses serviços em seu nome, por exemplo para puxar repositórios do GitHub ou pesquisar no Gmail. Você autoriza no navegador, sem precisar digitar nenhum token.

Os conectores se aplicam apenas às sessões na nuvem e não alteram nenhuma configuração no seu dispositivo. As extensões do agente (plugins, MCP, Skills) são gerenciadas em [Plugins, MCP e Skills](https://docs.aihubmix.com/pt/cloud/integrations/plugins-mcp-skills.md).

## Conectar um app

**1. Abrir os conectores**

Acesse **Settings › Integrations › Connectors**. A página agrupa os apps em Code (GitHub), Email (Gmail), Connected apps e More apps. Os apps disponíveis para conexão são os exibidos na página.

**2. Clicar em Connect**

Clique em **Connect** na linha do app. Para o Gmail, escolha primeiro um nível de acesso, conforme descrito abaixo.

**3. Autorizar no navegador**

O navegador abre a página de autorização do serviço. Conclua a autorização ali. Se a página não aparecer, clique em **Reopen browser**.

**4. Voltar ao AIHubMix Cloud**

Depois que você autoriza, o app aparece como conectado, junto com o nome da sua conta.

Se a autorização não for concluída, o app mostra o motivo. Clique em **Try again** para recomeçar. Cada conector conecta uma conta. Se você vir que outra conta já está conectada, desconecte-a primeiro para trocar de conta.

> [!TIP]
>
> Se você escolher importar do GitHub ao criar um projeto, mas ainda não tiver conectado o GitHub, clique em **Connect GitHub** ali mesmo. Consulte [Projetos e ambientes](https://docs.aihubmix.com/pt/cloud/environments/projects.md).

![Página de conectores](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/connectors.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=dfbc7ee94d4b7c166f49026795346187)

Settings › Integrations › Connectors

## Conectar o GitHub

Depois de conectar o GitHub, você pode importar repositórios para criar projetos. O agente pode puxar código, fazer push de branches e abrir PRs no servidor na nuvem, e pode ler issues e PRs e pesquisar código durante uma sessão.

Você gerencia no GitHub quais repositórios e organizações ele pode acessar: clique em **Manage** na linha do GitHub e depois em **Manage on GitHub** para adicionar organizações ou repositórios.

## Conectar o Gmail

O Gmail tem dois níveis de acesso. Cada conta AIHubMix pode conectar uma conta do Google:

* **Read and send** (padrão): o agente pode pesquisar e ler e-mails, e enviar e-mails por você.
* **Send only**: o agente pode enviar e-mails por você, mas não pode pesquisar nem ler e-mails.

Em qualquer nível, **o agente sempre pergunta a você na sessão antes de enviar um e-mail**. Ele lista o remetente, os destinatários, o assunto e o corpo, e você clica em **Send** ou **Don’t send**. As configurações de acesso não podem pular essa etapa, e o mesmo vale para envios depois que você conecta o Outlook.

Para alterar o nível de acesso, clique em **Change granted access** na página de gerenciamento do Gmail, escolha o novo nível e clique em **Authorize with Google**.

> [!NOTE]
>
> Se você escolheu Read and send, mas não marcou a permissão de leitura na página de autorização do Google, a linha do Gmail mostra "Send only" e o agente ainda não pode ler e-mails. Clique em **Change granted access** para autorizar novamente e marque a permissão de leitura.

## Gerenciar o acesso

Clique em **Manage** em qualquer app conectado para ver a conta conectada e o acesso dela.

* A lista de permissões vem do que a conta realmente concedeu no serviço, então os itens variam conforme o app e a conta.
* Você pode desativar ou ativar as permissões concedidas pelas chaves. As alterações entram em vigor depois de salvas. Quando um item está desativado, as sessões que tentam usá-lo são bloqueadas.
* Os itens que você não pode alternar são permissões que essa conta não concedeu, que não podem ser alteradas ou que exigem reconexão. Para conceder um acesso mais amplo, autorize novamente.
* Se salvar ou carregar falhar, clique em **Reload access** e tente de novo.

## Reconectar quando a autorização expirar

Se um app mostrar que a autorização expirou, normalmente você a revogou no serviço. Clique em **Reconnect** nessa linha e autorize novamente no navegador. O Gmail mantém o nível de acesso anterior.

## Desconectar

**1. Abrir a página de gerenciamento**

Clique em **Manage** na linha do app conectado.

**2. Desconectar**

Clique em **Disconnect** e depois em **Disconnect** novamente na caixa de confirmação.

Depois que você desconecta, as sessões na nuvem não conseguem mais acessar o app. Você pode reconectar a qualquer momento. Se a desconexão falhar, a conexão é mantida. Clique em **Reload access** e tente de novo.

> [!WARNING]
>
> Depois que você desconecta o GitHub, os ambientes na nuvem existentes não conseguem puxar código, fazer push de branches nem abrir PRs. Os arquivos nesses ambientes e os seus projetos são mantidos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.