Instalando uma Integração

Guia

Passo a Passo

Acessar a página de Integrações

No menu lateral, clique em Integrações. A página exibe as integrações já configuradas e um botão para adicionar novas.
Abrir o catálogo

Clique no botão Adicionar para abrir o painel lateral com o catálogo de integrações disponíveis.
Buscar e selecionar

Utilize o campo de busca para localizar a integração desejada por nome ou descrição. Clique no botão ”+” no card da integração.
Nomear a integração

Informe um Nome para esta instância da integração. Este campo é obrigatório e ajuda a identificá-la na lista — especialmente útil quando há múltiplas instâncias do mesmo tipo (ex: “Jira — Mobile”, “Jira — Backend”).
Configurar credenciais

Um diálogo de configuração é exibido com dois tipos de campos:
- Configurações — campos adicionais específicos da ferramenta (quando aplicável)
- Autenticação — credenciais de acesso (chave de API, token, usuário/senha, etc.)
Preencha todos os campos obrigatórios (marcados com indicador).
Escolher permissões

No final do formulário, a seção Permissões permite definir o escopo da integração:
- Local (Somente no workspace) — selecionado por padrão. A integração fica restrita ao workspace atual.
- Global (Todos os workspaces) — torna a integração disponível em todos os workspaces da organização.
Conectar

Clique em Conectar para salvar a integração. O sistema valida as credenciais e exibe uma notificação de sucesso ou erro.

Múltiplas Instâncias

É possível instalar múltiplas instâncias do mesmo tipo de integração, cada uma com credenciais e escopo diferentes. Por exemplo:

Um Jira Local conectado ao projeto MOBILE
Outro Jira Local conectado ao projeto BACKEND
Um Jira Global disponível como fallback para todos os workspaces

Quando um workspace tem uma integração Local, ela substitui automaticamente a versão Global do mesmo tipo para os agentes de IA daquele produto.

Campos do Formulário

O formulário de configuração é dinâmico e varia conforme a integração selecionada. Os tipos de campo disponíveis são:

Tipo	Descrição
Texto	Campos de texto livre (URLs, nomes, IDs)
Senha	Campos mascarados para credenciais sensíveis
Email	Campos de endereço de email
Número	Campos numéricos (portas, IDs)
Seleção	Dropdown com opções predefinidas
Checkbox	Toggle para opções booleanas

Após a Instalação

Com a integração instalada:

Ela aparece na lista de integrações configuradas com seu nome, badge de escopo (Local/Global) e logo
A data da última validação é exibida quando disponível
A integração fica disponível para uso em agentes, workflows e dashboards
Novos dashboards podem ficar disponíveis na Tela Inicial