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

# Governança de conectores

> Controle o acesso a conectores no seu Workspace com propriedade de conta, pessoas e grupos, escopos de provedor, limites de permissão do Agent e configurações de contas compartilhadas.

A governança de conectores controla quais contas o seu Workspace conecta, quem pode usá-las e como o Agent usa esse acesso.

> [!NOTE]
>
> Esta referência abrange as configurações de integração de acesso antecipado.
> Os controles disponíveis dependem do seu Workspace, das suas permissões e da
> integração. Se as suas configurações mostrarem **All integrations** em vez de
> **Discover integrations**, consulte [Gerenciar conectores](https://docs.replit.com/pt/replitai/managing-connectors.md).

## Onde encontrar os controles

Selecione o Workspace desejado e abra **Settings > Integrations**. As configurações atualizadas têm estas visualizações:

| Visualização | O que contém |
| - | - |
| **Discover integrations** | Serviços disponíveis e suas opções de configuração. Um serviço pode ter várias configurações. |
| **Your integrations** | Configurações e contas disponíveis para você, ações de login e suas escolhas de permissão padrão. |
| **Workspace integrations (admin)** | Configurações do Workspace, seus públicos, ajustes e projetos ou chats conectados. Esta visualização exige acesso de administrador do Workspace. |

Membros com acesso **Can manage** podem gerenciar uma configuração individual em **Your integrations** sem acesso à visualização de administrador.

Uma **configuração** define a instalação de um serviço, incluindo o tipo de conta, as definições do provedor e o público. Uma **conexão** é uma conta conectada por meio dessa configuração.
O **Configuration name** identifica cada instalação quando um serviço tem várias configurações, como contas separadas de desenvolvimento e produção.
Salvar uma configuração nem sempre conecta uma conta. Configurações pessoais exigem que cada membro faça login depois.

## Tipo de conta e protocolos

A configuração oferece apenas as combinações que a integração suporta. O tipo de conta determina de quem são as credenciais que a conexão usa.

| Tipo de conta | Comportamento |
| - | - |
| **Personal** | Cada membro conecta sua própria conta de provedor. Compartilhar a configuração não compartilha as credenciais de um membro com todos. |
| **Shared** | Os membros usam a mesma conta de provedor conectada, sujeita às concessões de acesso e ao consentimento dela. |
| **Service account** | Uma conta dedicada, não humana, fornece as credenciais. A disponibilidade depende do provedor. |

Os protocolos determinam como a integração é usada. **MCP** suporta conversas com o Agent, **HTTP** suporta aplicativos e automações, **Git** suporta repositórios e **Database** suporta acesso a bancos de dados.
Nem toda integração oferece todos os protocolos. Alguns protocolos exigem uma configuração e um fluxo de autorização separados.

## Público e funções

**Who has access** determina quem pode usar a configuração. Você pode escolher **Everyone in workspace**, incluindo futuros membros, ou **Selected people and groups**.

| Função | Acesso à configuração |
| - | - |
| **Can use** | Ver a configuração e conectar uma conta por meio dela. O consentimento da conta e as verificações de acesso continuam valendo quando um projeto ou chat usa a conexão. |
| **Can manage** | Usar e editar a configuração, gerenciar o público dela e removê-la. |

Os administradores do Workspace mantêm o acesso de gerenciamento, inclusive quando você escolhe pessoas e grupos selecionados. Remover uma entrada do público não remove o acesso concedido por meio de outro grupo.

A visualização **Audience** lista os destinatários salvos que são visíveis para você. Ela não é um cálculo completo do acesso efetivo de cada pessoa.
Para saber mais sobre associação a grupos e outras concessões, consulte [Grupos e permissões](https://docs.replit.com/pt/teams/groups-and-permissions.md).

## Configuração do provedor e escopos

**Replit defaults** usa o aplicativo de provedor configurado pelo Replit. **Custom** usa a sua própria configuração de provedor, quando suportado, como um cliente OAuth ou um endpoint de serviço.
O provedor determina quais campos são obrigatórios. As credenciais armazenadas não são exibidas no editor.

Os **Connector scopes** determinam quais permissões de provedor uma conexão pode solicitar. Escolha os escopos necessários para o trabalho pretendido.
Os escopos obrigatórios e os escopos usados por conexões existentes podem estar bloqueados.

> [!NOTE]
>
> As conexões OAuth existentes mantêm suas permissões de provedor atuais até
> se reconectarem. Alterar os escopos da configuração se aplica a novas
> conexões e reconexões.

Alterar o modo de permissão do Agent não adiciona escopos de provedor. **Always allow** não pode conceder acesso que a conta conectada não tem.

## Escolhas de permissão do Agent e limites do Workspace

**Default permission** é a sua escolha salva para uma conexão. Os **Workspace Agent Permission Limits** são controles de administrador que restringem o uso do Agent em todo o Workspace.
Para ações interativas do Agent que suportam aprovação, os modos têm estes significados:

| Modo | Significado |
| - | - |
| **Always ask** | Pergunta antes de ler ou alterar dados. |
| **Decide for me** | Pergunta para ações detectadas como potencialmente perigosas. Isso não é uma promessa de perguntar antes de toda gravação. |
| **Always allow** | Lê e faz alterações sem um aviso de aprovação, dentro do acesso já existente da conexão. |
| **Disabled** | Bloqueia o uso coberto por essa configuração de permissão. |

> [!WARNING]
>
> Durante o acesso antecipado, alguns seletores de permissão padrão informam que
> apenas salvam uma preferência e não alteram o comportamento do Agent. Não
> conte com esses seletores para exigir aprovação. Use os controles de acesso e
> as permissões de provedor disponíveis para restringir dados ou ações sensíveis.

A seção de limites do Workspace aparece abaixo de **Your integrations**. Os administradores podem definir limites para **All integrations** e para conectores individuais.
O limite de um conector individual não pode afrouxar um limite mais rígido aplicado a todo o Workspace. Os membros podem escolher uma configuração mais rígida onde o controle de permissão é aplicado.
As alterações de política se aplicam às verificações seguintes, incluindo as feitas por Agents em execução.

Para servidores MCP personalizados, um **MCP origin override** se aplica à origem do servidor: seu esquema, host e porta.
Caminhos diferentes na mesma origem compartilham esse limite. **No limit**, quando oferecido, remove essa substituição sem remover o limite aplicado a todo o Workspace.

Esses controles não fazem com que um aplicativo ou uma execução sem supervisão exiba um aviso de aprovação interativo.
Um **Workspace Rep** é um Agent com suas próprias concessões de acesso. Os Reps usam suas próprias concessões de conexão e não herdam a permissão padrão pessoal de um membro.
Um limite de Workspace **Disabled** ainda bloqueia o uso deles.

## Instruções do Agent

**Agent instructions** adiciona orientações para o uso de uma configuração, como quais canais usar ou como formatar registros.
Essas instruções têm precedência sobre as instruções do conector quando há conflito, mas não concedem acesso adicional.

As instruções são orientações, não um substituto para restrições de público, escopos de provedor ou limites de permissão aplicados.
Mantenha as credenciais nos campos de credenciais do provedor, não nas instruções do Agent.

## Contas e alterações de credenciais

As ações disponíveis dependem do tipo de conta e das suas permissões:

* **Log in** ou **Connect** cria uma conexão de conta por meio da configuração salva.
* **Reauthorize** renova a autorização do provedor quando suportado.
* **Edit public settings** mantém as credenciais armazenadas enquanto atualiza os campos visíveis da configuração.
* **Replace credentials** exige as credenciais de substituição completas para a mesma conta de provedor. Os segredos armazenados permanecem ocultos.

Quando o editor distingue **Development** e **Production**, verifique o ambiente selecionado antes de substituir as credenciais de uma conta compartilhada.
Se um salvamento não for confirmado, use a ação de nova tentativa exibida para continuar essa tentativa. Siga a instrução de recarregar ou reiniciar quando a página a solicitar.

## Status e projetos conectados

Uma configuração salva pode existir sem uma conta conectada. **Account connected · health not checked** significa que uma conta está salva, sem um resultado de verificação de integridade em tempo real.
Um horário em **Last checked** se refere a um resultado registrado, não a uma garantia de que o provedor está acessível agora.

A visualização **Connections** mostra os projetos visíveis, projetos publicados, chats ou Reps anexados a uma configuração.
Esta é uma lista das conexões atuais, não uma lista de contas de provedor nem um registro histórico de uso.

## Logout, desconexão compartilhada e remoção

Estas ações têm efeitos diferentes:

| Ação | Efeito |
| - | - |
| **Log out** | Exclui a conexão pessoal salva selecionada. Não revoga a autorização no provedor. |
| **Disconnect shared account** | Remove essa conexão compartilhada. Todos que usam a conta perdem o acesso, mas a configuração permanece. A autorização do provedor não é revogada. |
| **Remove configuration** | Exclui a configuração e suas conexões. Aplicativos e chats conectados perdem o acesso. Não exclui a conta do provedor nem os dados do provedor. |

Para revogar a autorização no provedor, use as configurações de conta ou de aplicativo desse provedor.
Revise a conta e a configuração afetadas antes de confirmar a remoção.

## Documentação relacionada

* [Gerenciar conectores](https://docs.replit.com/pt/replitai/managing-connectors.md) aborda a configuração geral de integrações e a disponibilidade.
* [Grupos e permissões](https://docs.replit.com/pt/teams/groups-and-permissions.md) explica a associação ao Workspace e as concessões de acesso.
* [Conectar via MCP](https://docs.replit.com/pt/build/connect-via-mcp.md) aborda a configuração de servidores MCP personalizados.
