O Fracttal One permite ligar-se a assistentes de inteligência artificial, como o Google Gemini, através do protocolo MCP (Model Context Protocol) com autenticação OAuth. Esta integração permite que o Gemini aceda aos dados de manutenção da sua empresa no Fracttal One (ativos, ordens de trabalho, leituras de contadores e muito mais) diretamente a partir do chat do Gemini, sem necessidade de exportar ficheiros nem mudar de plataforma.
A opção para adicionar conectores MCP personalizados depende do plano do Gemini e, nas contas do Google Workspace, da configuração definida pelo administrador. Se não vir a opção + Personalizado no separador Conectores, verifique o seu plano do Gemini ou consulte o administrador do Google Workspace da sua organização.
Passo 1: Criar o consumidor OAuth no Fracttal One
A configuração começa no Fracttal One, onde irá criar um consumidor OAuth para gerar as credenciais (Chave e Segredo) de que irá necessitar no Gemini.
No Fracttal One, aceda a Configuração > Ligações API.
Selecione o separador Consumidores OAuth (①) e clique no botão (+) (②) para criar um novo consumidor.
Preencha o formulário com os seguintes dados:
Tipo de autorização: selecione Código de autorização.
Nome: introduza um nome descritivo, por exemplo
Gemini MCP.URL de redirecionamento: este campo é obrigatório. Por enquanto, introduza o URL do servidor MCP (
https://one.fracttal.com/mcp/oauth/fracttal-one) como valor provisório; irá substituí-lo no Passo 3 pelo URI fornecido pelo Gemini.
Grupo de permissões: selecione um grupo de permissões (o campo é obrigatório). Quando a ligação é efetuada através de um cliente MCP, este grupo não se aplica: são utilizados o perfil e as permissões do utilizador que autoriza a ligação.
- Clique em Guardar.
- O Fracttal One gera as credenciais do consumidor. Copie os valores de Chave e Segredo utilizando o ícone de cópia. Irá necessitar deles no Gemini.
Passo 2: Configurar o conector MCP no Gemini
Com as credenciais do Fracttal One disponíveis, aceda ao Gemini para configurar o conector MCP.
No Gemini, clique em Personalizar no menu lateral e selecione o separador Conectores.
Clique em + Personalizado para adicionar um conector MCP personalizado. Será aberta a caixa de diálogo "Ligar a um servidor MCP".
Introduza o URL do servidor MCP do Fracttal One no campo URL do servidor MCP:
https://one.fracttal.com/mcp/oauth/fracttal-one
Clique em Definições adicionais > Mostrar mais para expandir os campos de autenticação. Serão apresentados os campos ID do cliente, Segredo do cliente e o botão Copiar URI de redirecionamento.
- Introduza as credenciais obtidas no Fracttal One nos campos correspondentes:
- ID do cliente: cole a Chave do Fracttal One.
- Segredo do cliente: cole o Segredo do Fracttal One.
- Clique em Copiar URI de redirecionamento (①). Guarde este URI; irá necessitar dele para concluir o consumidor OAuth no Fracttal One.
Não feche esta janela do Gemini. Voltará a ela depois de adicionar o URI de redirecionamento no Fracttal One.
Passo 3: Concluir a ligação
Agora volte ao Fracttal One para adicionar o URI de redirecionamento e, em seguida, volte ao Gemini para concluir a ligação.
No Fracttal One, abra o consumidor OAuth que criou no Passo 1 e, no campo URL de redirecionamento, substitua o valor provisório pelo URI que copiou do Gemini.
- Volte ao Gemini e clique em Seguinte. O Gemini apresentará um ecrã de consentimento. Selecione a caixa "Compreendo e aceito os riscos" e clique em Ligar.
- Será aberta a página de autorização do Fracttal One. Clique em Conceder acesso para aprovar a ligação.
- De volta ao Gemini, será aberta a caixa de diálogo Guardar a sua aplicação personalizada, com o nome do conector já preenchido e a lista de ações disponíveis. Se quiser, edite o nome e clique em Ligar para o guardar.
- Verá um banner de confirmação a indicar que o conector está ativo e pronto a ser utilizado.
Passo 4: Consultar dados do Fracttal One a partir do Gemini
Com a ligação ativa, pode consultar dados de manutenção diretamente a partir do chat do Gemini.
- No campo de prompt do Gemini, mencione o conector escrevendo
@Fracttalseguido da sua consulta. Por exemplo: "@Fracttal diga-me quais são as ordens de trabalho abertas desta semana".
Na primeira vez que o Gemini precisar de utilizar uma ação do conector, apresentará uma mensagem para autorizar essa ação. Clique em Permitir sempre para que o Gemini a utilize sem voltar a perguntar. Se preferir autorizá-la apenas para esta consulta, clique em Permitir uma vez.
- O Gemini processará a consulta acedendo aos dados da sua empresa no Fracttal One e apresentará a resposta diretamente no chat.
Notas:
Permissões do utilizador: os dados que o Gemini pode consultar dependem das permissões do utilizador que autorizou a ligação, e não do grupo de permissões do consumidor OAuth.
Gestão de credenciais: pode consultar e gerir as credenciais do consumidor OAuth (Chave e Segredo) no Fracttal One, em Configuração > Ligações API > Consumidores OAuth.
Revogação do acesso: pode revogar o acesso no Fracttal One eliminando o consumidor OAuth ou verificando as autorizações ativas na secção Autorizações de aplicações.
Serviço de terceiros: o Gemini é um produto da Google e a sua disponibilidade, funcionalidades e interface podem mudar sem aviso prévio por parte da Fracttal. A Fracttal não controla nem garante o funcionamento de serviços de terceiros.