Passer au contenu principal

Connecter un serveur MCP personnalisé à l’Agent Workleap

Enregistrez un serveur MCP que votre équipe utilise déjà pour que l’agent puisse utiliser ses outils.

Si un outil utilisé par votre équipe dispose d’un serveur MCP, ou si vous en avez créé un pour un système interne, un administrateur d’organisation peut l’enregistrer dans Workleap. L’agent Workleap pourra alors utiliser ses outils, et chaque utilisateur se connectera à ce serveur avec son propre compte.


Prérequis

Exigence

Comment vérifier

Une adresse HTTPS publique

Elle commence par https:// et fonctionne en dehors du réseau de votre entreprise. Les adresses accessibles uniquement via VPN ou localhost ne peuvent pas être enregistrées.

Connexion via OAuth

Le serveur redirige les utilisateurs vers une page de connexion. Un serveur qui demande de coller une clé API n’est pas accepté.

Un identifiant client et un secret, parfois

Uniquement si le serveur ne gère pas l’enregistrement automatique des applications. La documentation du fournisseur le précise et les fournit. Les membres n’en ont jamais besoin.


Comment ça fonctionne

  1. Un administrateur enregistre le serveur avec son adresse, un nom et une description que l’agent lira. Par exemple : « Notre système de tickets de support. Utilisez-le pour les questions sur les tickets, les incidents et l’astreinte. »

  2. Workleap vérifie que le serveur répond bien en HTTPS et propose une connexion OAuth avant de l’enregistrer.

  3. Chaque utilisateur se connecte une fois avec son propre compte sur ce serveur.

  4. Quand une question correspond à la description, l’agent utilise les outils du serveur en tant que cet utilisateur. Par exemple, demandez « Quels tickets sont ouverts pour mon équipe ? » et il répondra selon ce que votre compte peut voir.


Configuration


Administrateurs : enregistrer le serveur

  1. Ouvrez les paramètres Workleap AI et allez à la section Serveurs MCP personnalisés.

  2. Cliquez sur Ajouter un serveur.

  3. Saisissez l’URL du serveur, un nom d’affichage et la description.

  4. Saisissez l’ID client et le secret client uniquement si le fournisseur vous les a donnés. Le secret ne sera plus affiché après l’enregistrement.

  5. Cliquez sur Enregistrer. La vérification prend quelques secondes. Le serveur apparaîtra ensuite dans la liste.


Tout le monde : connectez votre compte

Ouvrez l’agent, trouvez le serveur dans Sources, cliquez sur Connecter et connectez-vous auprès du fournisseur. L’agent pourra utiliser le serveur dès votre prochain message.


Bon à savoir

  • Jusqu’à 25 serveurs par organisation, et jusqu’à 50 outils par serveur.

  • Enregistrer deux fois la même adresse crée des outils en double. Supprimez l’excédent.

  • Pour changer un secret, supprimez le serveur puis ajoutez-le à nouveau.

  • Supprimer un serveur déconnecte tous les utilisateurs dans Workleap. Cela ne révoque pas l’accès côté fournisseur.


Dépannage

Message

Que faire

Le serveur MCP n’a pas pu être joint à une adresse https publique, ou il n’implémente pas la spécification d’autorisation MCP.

Vérifiez que l’adresse est publique, qu’elle répond en HTTPS en moins de 10 secondes et qu’elle propose une connexion OAuth. Le fournisseur peut confirmer ce dernier point.

Le serveur d’autorisation du serveur MCP ne prend en charge ni l’enregistrement dynamique des clients ni les documents de métadonnées client-id.

Demandez un ID client au fournisseur et réessayez.

Vous avez atteint le nombre maximal de serveurs.

Supprimez un serveur que vous n’utilisez plus.

La section Serveurs MCP personnalisés est absente.

Vous n’êtes pas administrateur d’organisation, ou la fonctionnalité n’est pas encore disponible sur votre compte. Contactez votre représentant de compte.

Avez-vous trouvé la réponse à votre question ?