Visão geral
Conexões prontas a serviços conhecidos, do cadastro na organização ao uso pelo agente.
Integrações são conexões a serviços que a plataforma já sabe conversar. Diferente dos MCPs, você não descreve o protocolo: escolhe o serviço de uma lista e informa o acesso.
Como os MCPs, elas seguem o caminho de catálogo na organização e ligação no workspace.
Cadastrar na organização
Organização › Integrações abre para Superadmin e Admin, com duas abas:
- Disponíveis: o catálogo de integrações que a plataforma conhece e que ainda não foram cadastradas.
- Instaladas: as que a organização já cadastrou e pode distribuir aos workspaces.
Para cadastrar, abra Disponíveis e clique em Instalar no card do serviço. Não há formulário nesta etapa: a integração passa direto para Instaladas. O acesso que ela exige é informado depois, quando cada workspace a instala.
Quando a aba Disponíveis aparece vazia, todas as integrações conhecidas já foram cadastradas neste registro.
Associar a um workspace
A associação é feita em Organização › Workspaces: abra o workspace e, na aba Integrações, ligue a chave do card. O estado passa de Inativo para Ativo. Associar e desassociar são ações reversíveis.
Na barra estreita à esquerda, clique em Organização.
Ligar no workspace
Workspace › Integrações tem as mesmas duas abas, Instaladas e Disponíveis, aplicadas ao que a organização associou a este workspace.
Esta tela é acessível apenas ao Proprietário do workspace. Nenhum outro papel a alcança, nem em leitura. Um Curador que esteja montando um Agente vê a integração na lista do formulário, mas não consegue ligá-la. A ligação precisa ser feita por quem tem o papel.
Ao instalar no workspace, a janela pede nome, descrição e as credenciais que a integração exige. Integrações que dependem de autorização no serviço de origem abrem o fluxo de consentimento nesse momento.
Entregar a um agente
Ligar no workspace não entrega a integração a nenhum Agente. Cada Agente marca o que pode acionar na seção Integrações do próprio formulário.
Workflows também alcançam integrações, pelo nó Integração do canvas.
Nome e descrição
O menu de ações do registro da organização permite editar o nome e a descrição de uma integração cadastrada.
Vale usar isso quando a mesma integração é cadastrada mais de uma vez, apontando para ambientes diferentes: o nome padrão do catálogo não distingue uma da outra.
Remover
Desligar uma integração no workspace interrompe o acesso dos Agentes e Workflows que dependiam dela. A falha aparece no momento do uso, não no da remoção.
Próximos passos
- Guarde os acessos que elas usam em Credenciais.
- Compare com o caminho dos servidores de ferramentas em MCPs.