Ligar o Fracttal One com o Microsoft Copilot permite consultar os seus dados de manutenção em linguagem natural dentro do ecossistema Microsoft 365, sem sair do Copilot. A ligação é feita a partir de um agente criado no Copilot Studio, através do protocolo MCP (Model Context Protocol) com autenticação OAuth 2.0, e o agente acede ao Fracttal com as mesmas permissões do utilizador autenticado.
Requisitos
Conta ativa no Fracttal One com permissões de administrador ou acesso às Configurações.
Acesso à secção Ligações API dentro do Fracttal One.
Licença do Microsoft Copilot Studio com permissões de criador (maker) no ambiente Power Platform.
Um grupo de permissões definido no Fracttal One com o âmbito de dados que quer expor ao agente.
Dados de ligação do Fracttal One
Estes valores são fixos e vai usá-los durante a configuração no Copilot Studio.
| Campo | Valor |
|---|---|
| URL do servidor MCP | https://one.fracttal.com/mcp/oauth/fracttal-one |
| URL de autorização | https://one.fracttal.com/oauth/authorize |
| URL do token | https://one.fracttal.com/oauth/token |
| URL de atualização (refresh) | https://one.fracttal.com/oauth/token |
| Âmbitos | Deixar vazio. O Fracttal One controla o âmbito através do grupo de permissões. |
Nota: as URLs de autorização e do token estão na raiz do domínio. Não incluem /api/ nem /mcp/ no caminho.
Passo a passo
Crie o servidor MCP no Copilot Studio
No seu agente, vá a Ferramentas › Adicionar uma ferramenta › Nova ferramenta › Model Context Protocol.
Preencha os campos:
| Campo | Valor |
|---|---|
| Nome | Fracttal One (ou o nome que preferir) |
| Descrição do servidor | Uma descrição clara do que o servidor faz. O agente usa este texto para decidir quando consultar o Fracttal One. |
| URL do servidor | https://one.fracttal.com/mcp/oauth/fracttal-one |
| Autenticação | OAuth 2.0 |
| Tipo | Manual |
Importante: o campo Tipo oferece três opções e só Manual funciona com o Fracttal One. A opção Deteção dinâmica tenta localizar a configuração automaticamente e a opção Dinâmico tenta registar o cliente por conta própria, algo que o Fracttal One rejeita por segurança.
Crie o consumidor OAuth no Fracttal One
Numa outra aba, inicie sessão no Fracttal One. No canto superior direito, clique no menu do utilizador e selecione Configuração. No menu lateral, selecione Conexões API e depois clique no separador Consumidores OAuth.
Clique no botão (+) para adicionar um novo consumidor e preencha o formulário:
| Campo | Valor |
|---|---|
| Tipo de autorização | Código de autorização |
| Nome | O nome da ligação que preferir (ex: COPILOT MCP) |
| URL de redirecionamento | https://global.consent.azure-apim.net/redirect (valor provisório, vai substituir no Passo 5) |
| Grupo de Permissões | Selecione o grupo de permissões desejado. No entanto, o sistema usará as permissões do utilizador autenticado. |
Depois de preencher o formulário, clique no ícone de Guardar, no canto superior direito.
Copie a chave e o segredo gerados
Ao guardar, o Fracttal One gera automaticamente uma Chave e um Segredo para o consumidor.
Importante: o Segredo é mostrado uma única vez e dá acesso de leitura e escrita aos dados do grupo de permissões selecionado. Guarde ambos os valores num gestor de palavras-passe e não os partilhe em capturas de ecrã nem em mensagens. Se o segredo ficar exposto, crie um consumidor novo e substitua as credenciais.
Complete a autenticação manual no Copilot Studio
Volte à janela do Copilot Studio, com Tipo em Manual, e preencha os campos:
| Campo | Valor |
|---|---|
| Id. de cliente | Cole a Chave gerada no Passo 3 |
| Segredo do cliente | Cole o Segredo gerado no Passo 3 |
| Endereço URL de autorização | https://one.fracttal.com/oauth/authorize |
| Modelo de URL do token | https://one.fracttal.com/oauth/token |
| Atualizar URL | https://one.fracttal.com/oauth/token |
| Âmbitos | Deixar vazio |
Clique em Criar. O Copilot Studio gera uma URL de redirecionamento única, que combina a URL base do Azure com um sufixo identificador do conector.
Sincronize a URL de redirecionamento no Fracttal One
Copie a URL de redirecionamento completa que o Copilot Studio gerou. Volte ao Fracttal One, abra o consumidor OAuth criado no Passo 2, substitua o valor do campo URL de redirecionamento pela URL completa com o sufixo e clique em Guardar.
Importante: o Fracttal One compara a URL de redirecionamento carácter por carácter. Se o consumidor mantiver a URL base, a autorização será interrompida com um erro de URL de redirecionamento não coincidente. Se o erro persistir, experimente adicionar ou remover a barra final (/).
Ligue e autorize
No ecrã Adicionar ferramenta do Copilot Studio, abra o seletor Ligação e escolha criar a ligação. Abre-se uma janela de autorização do Fracttal One, onde deve iniciar sessão e confirmar as permissões de acesso.
Depois de autorizar, aparece um indicador verde junto ao nome da ligação e o botão Adicionar e configurar fica disponível.
Valide a ligação com uma consulta real
Na configuração do agente, confirme que a orquestração generativa está ativada. Sem ela, o agente reconhece as ferramentas do Fracttal One mas não as executa.
Faça uma pergunta simples e verificável e compare o resultado com o que vê no Fracttal One.
Está feito! Já tem o Fracttal One ligado ao seu agente do Microsoft Copilot.
Notas:
O uso desta integração pode implicar consumo, limites ou custos associados aos serviços da Microsoft. Estes custos e condições são determinados exclusivamente pela Microsoft.
O agente pode solicitar confirmação antes de executar ações de escrita (criar, modificar ou eliminar registos). Reveja sempre as ações propostas antes de as confirmar.
O utilizador é responsável por validar e supervisionar as ações, automatizações e resultados gerados através de plataformas de terceiros ligadas ao Fracttal, incluindo os que derivem de instruções, configurações, prompts ou fluxos definidos nessas plataformas.