Fracttal One permet de se connecter à des assistants d’intelligence artificielle comme Google Gemini via le protocole MCP (Model Context Protocol) avec une authentification OAuth. Cette intégration permet à Gemini d’accéder aux données de maintenance de votre entreprise dans Fracttal One (actifs, ordres de travail, relevés de compteurs et plus encore) directement depuis le chat Gemini, sans avoir besoin d’exporter des fichiers ni de changer de plateforme.
L’option permettant d’ajouter des connecteurs MCP personnalisés dépend du forfait Gemini et, pour les comptes Google Workspace, de la configuration définie par l’administrateur. Si l’option + Personnalisé ne s’affiche pas dans l’onglet Connecteurs, vérifiez votre forfait Gemini ou contactez l’administrateur Google Workspace de votre organisation.
Étape 1 : créer le client OAuth dans Fracttal One
La configuration commence dans Fracttal One, où vous créerez un client OAuth pour générer les identifiants (Clé et Secret) dont vous aurez besoin dans Gemini.
Dans Fracttal One, accédez à Configuration > Connexions API.
Sélectionnez l’onglet Clients OAuth (①), puis cliquez sur le bouton (+) (②) pour créer un nouveau client.
Remplissez le formulaire avec les informations suivantes :
Type d’autorisation : sélectionnez Code d’autorisation.
Nom : saisissez un nom descriptif, par exemple
Gemini MCP.URL de redirection : ce champ est obligatoire. Pour l’instant, saisissez l’URL du serveur MCP (
https://one.fracttal.com/mcp/oauth/fracttal-one) comme valeur provisoire ; vous la remplacerez à l’étape 3 par l’URI que Gemini vous fournira.
Groupe d’autorisations : sélectionnez un groupe d’autorisations (ce champ est obligatoire). Lorsque la connexion est établie via un client MCP, ce groupe ne s’applique pas : le profil et les autorisations de l’utilisateur qui autorise la connexion sont utilisés.
- Cliquez sur Enregistrer.
- Fracttal One génère les identifiants du client. Copiez les valeurs de la Clé et du Secret à l’aide de l’icône de copie. Vous en aurez besoin dans Gemini.
Étape 2 : configurer le connecteur MCP dans Gemini
Une fois les identifiants Fracttal One en votre possession, accédez à Gemini pour configurer le connecteur MCP.
Dans Gemini, cliquez sur Personnaliser dans le menu latéral, puis sélectionnez l’onglet Connecteurs.
Cliquez sur + Personnalisé pour ajouter un connecteur MCP personnalisé. La boîte de dialogue « Se connecter à un serveur MCP » s’ouvre.
Saisissez l’URL du serveur MCP de Fracttal One dans le champ URL du serveur MCP :
https://one.fracttal.com/mcp/oauth/fracttal-one
Cliquez sur Paramètres supplémentaires > Afficher plus pour développer les champs d’authentification. Les champs ID client, Secret client et le bouton Copier l’URI de redirection s’afficheront.
- Saisissez les identifiants obtenus auprès de Fracttal One dans les champs correspondants :
- ID client : collez la Clé de Fracttal One.
- Secret client : collez le Secret de Fracttal One.
- Cliquez sur Copier l’URI de redirection (①). Enregistrez cette URI ; vous en aurez besoin pour terminer la configuration du client OAuth dans Fracttal One.
Ne fermez pas cette fenêtre Gemini. Vous y reviendrez après avoir ajouté l’URI de redirection dans Fracttal One.
Étape 3 : terminer la connexion
Revenez maintenant dans Fracttal One pour ajouter l’URI de redirection, puis retournez dans Gemini pour finaliser la connexion.
Dans Fracttal One, ouvrez le client OAuth que vous avez créé à l’étape 1 et, dans le champ URL de redirection, remplacez la valeur provisoire par l’URI que vous avez copiée depuis Gemini.
- Retournez dans Gemini et cliquez sur Suivant. Gemini affiche un écran de consentement. Cochez la case « Je comprends et j’accepte les risques », puis cliquez sur Se connecter.
- La page d’autorisation de Fracttal One s’ouvre. Cliquez sur Accorder l’accès pour approuver la connexion.
- De retour dans Gemini, la boîte de dialogue Enregistrer votre application personnalisée s’ouvre, avec le nom du connecteur déjà renseigné et la liste des actions disponibles. Si vous le souhaitez, modifiez le nom, puis cliquez sur Se connecter pour l’enregistrer.
- Une bannière de confirmation indiquant que le connecteur est actif et prêt à être utilisé s’affiche.
Étape 4 : consulter les données de Fracttal One depuis Gemini
Une fois la connexion active, vous pouvez consulter les données de maintenance directement depuis le chat Gemini.
- Dans le champ de saisie de Gemini, mentionnez le connecteur en écrivant
@Fracttalsuivi de votre demande. Par exemple : « @Fracttal indique-moi quels sont les ordres de travail ouverts cette semaine ».
La première fois que Gemini doit utiliser une action du connecteur, un message vous demandant d’autoriser cette action s’affiche. Cliquez sur Toujours autoriser pour que Gemini l’utilise sans vous le demander à nouveau. Si vous préférez l’autoriser uniquement pour cette demande, cliquez sur Autoriser une fois.
- Gemini traite la demande en accédant aux données de votre entreprise dans Fracttal One et affiche la réponse directement dans le chat.
Remarques :
Autorisations de l’utilisateur : les données que Gemini peut consulter dépendent des autorisations de l’utilisateur qui a autorisé la connexion, et non du groupe d’autorisations du client OAuth.
Gestion des identifiants : vous pouvez consulter et gérer les identifiants du client OAuth (Clé et Secret) depuis Fracttal One, dans Configuration > Connexions API > Clients OAuth.
Révocation de l’accès : vous pouvez révoquer l’accès depuis Fracttal One en supprimant le client OAuth ou en consultant les autorisations actives dans la section Autorisations des applications.
Service tiers : Gemini est un produit de Google et sa disponibilité, ses fonctionnalités et son interface peuvent être modifiées sans préavis par Fracttal. Fracttal ne contrôle ni ne garantit le fonctionnement des services tiers.