Saltar para o conteúdo principal
A governança de conectores controla quais contas o seu Workspace conecta, quem pode usá-las e como o Agent usa esse acesso.
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.

Onde encontrar os controles

Selecione o Workspace desejado e abra Settings > Integrations. As configurações atualizadas têm estas visualizações: 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. 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. 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.

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.
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:
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: 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