Connecter Fracttal One avec Microsoft Copilot Studio vous permet de consulter vos données de maintenance en langage naturel au sein de l’écosystème Microsoft 365, sans quitter Copilot. La connexion s’effectue via un agent créé dans Copilot Studio, en utilisant le protocole MCP (Model Context Protocol) avec une authentification OAuth 2.0, et l’agent accède à Fracttal avec les mêmes permissions que l’utilisateur authentifié.
Prérequis
Compte actif sur Fracttal One avec des droits d’administrateur ou accès à la Configuration.
Accès à la section Connexions API dans Fracttal One.
Licence Microsoft Copilot Studio avec droits de créateur (maker) dans l’environnement Power Platform.
Un groupe de permissions défini dans Fracttal One avec la portée des données que vous souhaitez exposer à l’agent.
Données de connexion de Fracttal One
Ces valeurs sont fixes et seront utilisées lors de la configuration dans Copilot Studio.
| Champ | Valeur |
|---|---|
| URL du serveur MCP | https://one.fracttal.com/mcp/oauth/fracttal-one |
| URL d’autorisation | https://one.fracttal.com/oauth/authorize |
| URL du token | https://one.fracttal.com/oauth/token |
| URL de rafraîchissement (refresh) | https://one.fracttal.com/oauth/token |
| Portées | Laisser vide. Fracttal One contrôle la portée via le groupe de permissions. |
Note : les URL d’autorisation et de token sont à la racine du domaine. Elles n’incluent pas /api/ ni /mcp/ dans le chemin.
Étape par étape
Créez le serveur MCP dans Copilot Studio
Dans votre agent, allez dans Outils › Ajouter un outil › Nouvel outil › Model Context Protocol.
Remplissez les champs :
| Champ | Valeur |
|---|---|
| Nom | Fracttal One (ou le nom de votre choix) |
| Description du serveur | Une description claire de la fonction du serveur. L’agent utilise ce texte pour décider quand interroger Fracttal One. |
| URL du serveur | https://one.fracttal.com/mcp/oauth/fracttal-one |
| Authentification | OAuth 2.0 |
| Type | Manuel |
Important : le champ Type propose trois options et seule l’option Manuel fonctionne avec Fracttal One. L’option Détection dynamique tente de localiser automatiquement la configuration et l’option Dynamique essaie d’enregistrer le client par elle-même, ce que Fracttal One refuse pour des raisons de sécurité.
Créez le consommateur OAuth dans Fracttal One
Dans un autre onglet, connectez-vous à Fracttal One. En haut à droite, cliquez sur le menu utilisateur et sélectionnez Configuration. Dans le menu latéral, sélectionnez Connexions API puis cliquez sur l’onglet Consommateurs OAuth.
Cliquez sur le bouton (+) pour ajouter un nouveau consommateur et remplissez le formulaire :
| Champ | Valeur |
|---|---|
| Type d’autorisation | Code d’autorisation |
| Nom | Le nom de la connexion de votre choix (ex : COPILOT MCP) |
| URL de redirection | https://global.consent.azure-apim.net/redirect (valeur provisoire, vous la remplacerez à l’Étape 5) |
| Groupe de Permissions | Sélectionnez le groupe de permissions désiré. Cependant, le système utilisera les permissions de l’utilisateur authentifié. |
Une fois le formulaire complété, cliquez sur l’icône Enregistrer en haut à droite.
Copiez la clé et le secret générés
Lors de l’enregistrement, Fracttal One génère automatiquement une Clé et un Secret pour le consommateur.
Important : le Secret est affiché une seule fois et donne un accès en lecture et écriture aux données du groupe de permissions sélectionné. Conservez ces deux valeurs dans un gestionnaire de mots de passe et ne les partagez pas via captures d’écran ou messages. En cas d’exposition du secret, créez un nouveau consommateur et remplacez les identifiants.
Complétez l’authentification manuelle dans Copilot Studio
Retournez dans la fenêtre de Copilot Studio, avec Type sur Manuel, et remplissez les champs :
| Champ | Valeur |
|---|---|
| ID client | Collez la Clé générée à l’Étape 3 |
| Secret client | Collez le Secret généré à l’Étape 3 |
| URL d’autorisation | https://one.fracttal.com/oauth/authorize |
| Modèle d’URL du token | https://one.fracttal.com/oauth/token |
| URL de rafraîchissement | https://one.fracttal.com/oauth/token |
| Portées | Laisser vide |
Cliquez sur Créer. Copilot Studio génère une URL de redirection unique, combinant l’URL de base Azure avec un suffixe identifiant le connecteur.
Synchronisez l’URL de redirection dans Fracttal One
Copiez l’URL de redirection complète générée par Copilot Studio. Retournez dans Fracttal One, ouvrez le consommateur OAuth créé à l’Étape 2, remplacez la valeur du champ URL de redirection par l’URL complète avec suffixe, puis cliquez sur Enregistrer.
Important : Fracttal One compare l’URL de redirection caractère par caractère. Si le consommateur conserve l’URL de base, l’autorisation échoue avec une erreur d’URL de redirection non correspondante. En cas d’erreur persistante, essayez d’ajouter ou de retirer la barre finale (/).
Connectez et autorisez
Dans l’écran Ajouter un outil de Copilot Studio, déployez le sélecteur Connexion et choisissez de créer la connexion. Une fenêtre d’autorisation Fracttal One s’ouvre, où vous devez vous connecter et confirmer les permissions d’accès.
Après autorisation, un indicateur vert apparaît à côté du nom de la connexion et le bouton Ajouter et configurer devient disponible.
Validez la connexion avec une requête réelle
Dans la configuration de l’agent, assurez-vous que l’orchestration générative est activée. Sans cela, l’agent reconnaît les outils Fracttal One mais ne les exécute pas.
Posez une question simple et vérifiable, puis comparez le résultat avec ce que vous voyez dans Fracttal One.
Terminé ! Fracttal One est désormais connecté à votre agent Microsoft Copilot.
Notes :
L’utilisation de cette intégration peut entraîner une consommation, des limites ou des coûts associés aux services Microsoft. Ces coûts et conditions sont exclusivement déterminés par Microsoft.
L’agent peut demander une confirmation avant d’exécuter des actions d’écriture (création, modification ou suppression d’enregistrements). Vérifiez toujours les actions proposées avant de les confirmer.
L’utilisateur est responsable de valider et de superviser les actions, automatisations et résultats générés via des plateformes tierces connectées à Fracttal, y compris ceux résultant d’instructions, configurations, prompts ou flux définis dans ces plateformes.