Conectar o Fracttal One com o Microsoft Copilot permite consultar seus dados de manutenção em linguagem natural dentro do ecossistema Microsoft 365, sem sair do Copilot. A conexão é feita a partir de um agente criado no Copilot Studio, usando o protocolo MCP (Model Context Protocol) com autenticação OAuth 2.0, e o agente acessa o Fracttal com as mesmas permissões do usuário autenticado.
Requisitos
Conta ativa no Fracttal One com permissões de administrador ou acesso à Configuração.
Acesso à seção Conexões API dentro do Fracttal One.
Licença do Microsoft Copilot Studio com permissões de criador (maker) no ambiente do Power Platform.
Um grupo de permissões definido no Fracttal One com o escopo de dados que deseja expor ao agente.
Dados de conexão do Fracttal One
Esses valores são fixos e você os usará 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 |
| Escopos | Deixe vazio. O Fracttal One controla o escopo através do grupo de permissões. |
Nota: as URLs de autorização e 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á para 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 esse 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 apenas Manual funciona com o Fracttal One. A opção Detecção dinâmica tenta localizar a configuração automaticamente e a opção Dinâmico tenta registrar o cliente por conta própria, algo que o Fracttal One rejeita por segurança.
Crie o consumidor OAuth no Fracttal One
Em outra aba, faça login no Fracttal One. No canto superior direito, clique no menu do usuário e selecione Configuração. No menu lateral, selecione Conexões API e depois clique na aba 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 conexão que preferir (ex: COPILOT MCP) |
| URL de redirecionamento | https://global.consent.azure-apim.net/redirect (valor provisório, você 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 usuário autenticado. |
Após preencher o formulário, clique no ícone de Salvar, no canto superior direito.
Copie a chave e o segredo gerados
Ao salvar, o Fracttal One gera automaticamente uma Chave e um Segredo para o consumidor.
Importante: o Segredo é mostrado apenas uma vez e dá acesso de leitura e escrita aos dados do grupo de permissões selecionado. Guarde ambos os valores em um gerenciador de senhas e não os compartilhe em capturas de tela nem em mensagens. Se o segredo for exposto, crie um novo consumidor e substitua as credenciais.
Complete a autenticação manual no Copilot Studio
Volte para a janela do Copilot Studio, com o Tipo em Manual, e preencha os campos:
| Campo | Valor |
|---|---|
| ID do cliente | Cole a Chave gerada no Passo 3 |
| Segredo do cliente | Cole o Segredo gerado no Passo 3 |
| URL de autorização | https://one.fracttal.com/oauth/authorize |
| Template de URL do token | https://one.fracttal.com/oauth/token |
| URL de atualização | https://one.fracttal.com/oauth/token |
| Escopos | Deixe 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 gerada pelo Copilot Studio. 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 Salvar.
Importante: o Fracttal One compara a URL de redirecionamento caractere por caractere. Se o consumidor mantiver a URL base, a autorização será interrompida com um erro de URL de redirecionamento não correspondente. Se o erro persistir, tente adicionar ou remover a barra final (/).
Conecte e autorize
Na tela Adicionar ferramenta do Copilot Studio, abra o seletor Conexão e escolha criar a conexão. Será aberta uma janela de autorização do Fracttal One, onde você deverá fazer login e confirmar as permissões de acesso.
Após autorizar, aparece um indicador verde ao lado do nome da conexão e o botão Adicionar e configurar fica disponível.
Valide a conexã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.
Pronto! Agora você tem o Fracttal One conectado ao seu agente do Microsoft Copilot.
Notas:
O uso desta integração pode implicar consumo, limites ou cobranças associadas aos serviços da Microsoft. Esses 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 excluir registros). Sempre revise as ações propostas antes de confirmá-las.
O usuário é responsável por validar e supervisionar as ações, automações e resultados gerados através de plataformas de terceiros conectadas ao Fracttal, incluindo aqueles decorrentes de instruções, configurações, prompts ou fluxos definidos nessas plataformas.