Un connecteur permet à ONE d'accéder à un outil extérieur à Factorial IT. Ajoutes-en un quand tu veux que l'assistant consulte des informations ou agisse dans un autre système que ton équipe utilise déjà.
Fonctionnement
Aperçu
Chaque connecteur est un serveur MCP (Model Context Protocol, ou protocole de contexte de modèle) que tu enregistres à partir de son URL. Une fois connecté, ONE peut appeler les outils proposés par ce serveur pendant que tu discutes avec lui. Par exemple, il peut retrouver une page dans Notion ou effectuer une tâche dans un autre service.
Voici les raisons habituelles d'en ajouter un :
- Consulter des données ailleurs. Fais venir des informations détenues par un outil sur lequel ton équipe s'appuie.
- Agir ailleurs. Laisse l'assistant effectuer des tâches dans un service connecté.
- Étendre les capacités de l'assistant. Branche n'importe quel outil compatible avec le protocole MCP.
Tu n'as pas besoin de connecteur si l'assistant doit seulement travailler avec les données de Factorial IT ou avec les consignes de ton entreprise. Dans ce cas, utilise des articles de la base de connaissances.
Avant de commencer
- Pour ajouter, modifier, réauthentifier ou supprimer des connecteurs, ou pour modifier leurs autorisations d'outils, tu as besoin de l'autorisation Gérer les agents IA. Pour simplement les consulter, l'autorisation Voir les agents IA suffit.
- Tu as besoin de l'URL d'un serveur MCP compatible avec l'authentification OAuth.
Étapes
- Va dans Agents IA > Paramètres et sélectionne l'onglet Connecteurs.
- Clique sur Ajouter un connecteur. Une fenêtre s'ouvre.
- Renseigne les informations :
-
Nom : le libellé du connecteur, par exemple
Notion. -
URL du serveur : le point de terminaison MCP, par exemple
https://example.com/mcp.
-
Nom : le libellé du connecteur, par exemple
- Ouvre Paramètres avancés uniquement si ton serveur MCP ne prend pas en charge l'enregistrement dynamique de client. Dans ce cas, enregistre Factorial IT dans la console OAuth du fournisseur et saisis l'ID client et le secret client. Les clients publics qui reposent sur PKCE peuvent laisser le secret vide.
- Clique sur Connecter. Tu es redirigé·e vers le serveur MCP pour te connecter. Une fois l'accès accordé, tu reviens dans Factorial IT et le connecteur affiche Connecté.
Statuts des connecteurs
| Statut | Signification |
|---|---|
| Authentification en attente | Le connecteur est créé, mais l'authentification n'est pas encore terminée. |
| Connecté | Le connecteur est authentifié et disponible pour l'assistant. |
| Erreur | La connexion a échoué. Réauthentifie-toi pour réessayer. |
Consulter un connecteur
L'onglet Connecteurs affiche d'abord les connecteurs intégrés (Factorial IT et le connecteur du centre d'aide), puis ceux que tu as ajoutés. Les connecteurs intégrés sont toujours Connectés. Clique sur un connecteur pour ouvrir sa page.
Sur la page d'un connecteur que tu as ajouté, tu trouves :
- Paramètres : le Nom, l'URL du serveur et, si tu en as saisi un, l'ID client. Le secret client n'est jamais affiché. Utilise Modifier la connexion pour changer ces valeurs. Si tu modifies l'URL du serveur ou les identifiants OAuth, tu dois t'authentifier de nouveau.
- Autorisations du chat et Autorisations des agents : chaque outil proposé par le serveur MCP, avec sa règle. Consulte la section « Définir les autorisations des outils » ci-dessous.
La liste des outils est récupérée depuis le serveur MCP à chaque ouverture de la page : elle correspond donc toujours à ce que le serveur propose actuellement. Les outils ne s'affichent que si le connecteur est Connecté. Si le serveur ne répond pas, un avertissement s'affiche à la place des outils, et Paramètres reste utilisable.
Les connecteurs intégrés n'ont ni Paramètres ni menu Actions. Tu ne peux ni les modifier ni les supprimer, mais tu peux changer leurs autorisations d'outils.
Gérer un connecteur
Sur la page d'un connecteur que tu as ajouté, utilise le menu Actions en haut à droite :
- Réauthentifier : reconnecte-toi au serveur MCP. Cette option n'apparaît que si le connecteur n'est pas Connecté.
- Supprimer : retire le connecteur et ses identifiants enregistrés, après confirmation. Si un agent utilise le connecteur, tu ne peux pas le supprimer tant que tu ne l'as pas désactivé dans cet agent.
Définir les autorisations des outils
La page du connecteur contrôle la façon dont ONE peut utiliser chaque outil. Quand le connecteur est Connecté, ses outils sont listés en deux sections :
- Autorisations du chat concernent tes propres conversations avec ONE.
- Autorisations des agents concernent ONE quand il fonctionne sans supervision, par exemple sur un ticket auquel tu l'as ajouté en tant qu'agent. Quand tu actives le connecteur pour un agent personnalisé, cet agent prend une copie de ces paramètres et la conserve. Les modifications apportées ensuite ici ne lui sont pas répercutées.
Dans les deux sections, les outils sont regroupés en Outils en lecture seule et Outils en lecture-écriture. Un outil est considéré comme en lecture seule uniquement si le serveur MCP l'indique avec l'annotation readOnlyHint. Tout autre outil est traité comme un outil en lecture-écriture.
Pour définir une règle pour un groupe entier, utilise le menu à droite de ce groupe. Ce choix s'applique aussi aux outils que le serveur ajoutera à l'avenir, et remplace les paramètres de chaque outil du groupe. Pour définir la règle d'un seul outil, déplie le groupe et choisis une règle avec les icônes à côté du nom de l'outil. Quand les outils d'un groupe ont des règles différentes, le groupe affiche Personnalisé.
| Règle | Effet |
|---|---|
| Toujours autoriser | ONE utilise l'outil sans demander. |
| Exiger une approbation | ONE demande d'abord ton accord. Clique sur Accepter pour exécuter l'outil ou sur Annuler pour l'arrêter. Disponible uniquement pour le chat : personne n'est là pour répondre pendant qu'un agent s'exécute. |
| Toujours refuser | ONE ne voit pas l'outil et ne peut pas l'utiliser. |
Règles par défaut, tant que tu ne les modifies pas :
| Outils | Autorisations du chat | Autorisations des agents |
|---|---|---|
| Lecture seule | Toujours autoriser | Toujours autoriser |
| Lecture-écriture | Exiger une approbation | Toujours autoriser |
Cela signifie que les agents peuvent utiliser immédiatement les outils en lecture-écriture. Pour limiter les agents à la lecture sur un connecteur, définis les Outils en lecture-écriture sur Toujours refuser dans Autorisations des agents. Tout agent personnalisé qui utilise déjà le connecteur a sa propre copie : modifie-la aussi dans cet agent.
Comment ONE utilise les connecteurs
Pendant une conversation, ONE a accès aux outils de chaque connecteur connecté et choisit le bon pour chaque demande. Pour le diriger vers un connecteur précis, saisis @ dans la zone de message et choisis le connecteur. ONE vérifie les Autorisations du chat du connecteur avant d'exécuter un outil. Par défaut, il te demande ton accord avant d'utiliser un outil qui écrit ou modifie des données.
Conseils et bonnes pratiques
- Vérifie les paramètres par défaut des agents juste après la connexion. Les agents peuvent utiliser les outils en lecture-écriture dès le départ. Restreins-les avant qu'un agent n'utilise le connecteur.
- Modifie les agents un par un. Un agent personnalisé conserve sa propre copie des autorisations. Modifier ensuite le connecteur ne la met pas à jour.
- Garde l'approbation pour les écritures dans le chat. Exiger une approbation te donne un dernier contrôle avant que ONE ne modifie des données dans un autre système.
- Utilise plutôt un article de la base de connaissances quand tu as seulement besoin de consignes. Un connecteur sert à accéder à un autre système, pas à apprendre tes politiques à ONE.
-
Donne aux connecteurs le nom de l'outil. Tu les sélectionneras plus facilement avec
@.
Résolution des problèmes et FAQ
Résolution des problèmes
- Le connecteur affiche une erreur. La connexion a échoué. Ouvre sa page et utilise Actions > Réauthentifier.
- Le connecteur reste en attente d'authentification. L'authentification n'est pas terminée. Réauthentifie-toi et termine la connexion sur le serveur MCP.
- Aucun outil n'apparaît sur la page du connecteur. Les outils ne s'affichent que si le connecteur est Connecté et si le serveur répond. Si un avertissement s'affiche, le serveur n'a pas répondu.
- Tu ne peux pas supprimer un connecteur. Un agent l'utilise encore. Désactive-le d'abord dans cet agent.
- La connexion échoue sur un serveur sans enregistrement dynamique de client. Enregistre Factorial IT dans la console OAuth du fournisseur et saisis l'ID client et le secret client dans Paramètres avancés.
- Une modification d'autorisation n'a pas été répercutée sur un agent. L'agent conserve sa propre copie. Modifie la règle directement dans l'agent.
FAQ
-
De quelle autorisation ai-je besoin pour ajouter un connecteur ?
Gérer les agents IA. L'autorisation Voir les agents IA permet seulement de consulter les connecteurs.
-
Puis-je modifier ou supprimer les connecteurs intégrés ?
Non. Tu peux uniquement modifier leurs autorisations d'outils.
-
Comment Factorial IT détermine-t-il si un outil est en lecture seule ?
Seuls les outils que le serveur MCP marque avecreadOnlyHintsont en lecture seule. Tous les autres sont en lecture-écriture.
-
Pourquoi l'approbation n'est-elle pas disponible pour les agents ?
Un agent fonctionne de manière autonome : personne n'est là pour approuver l'utilisation de l'outil.
-
Puis-je consulter le secret client après l'avoir enregistré ?
Non. Il n'est plus jamais affiché.