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 personne se connectera à ce serveur avec son propre compte.


​

Prérequis

Exigence

Comment vérifier

Une adresse HTTPS publique

Elle commence par https:// et fonctionne de l'extérieur du réseau de votre entreprise. Les adresses accessibles seulement par VPN et les adresses localhost ne peuvent pas être enregistrées.

Une connexion par OAuth

Le serveur envoie les utilisateurs vers une page de connexion. Un serveur qui demande de coller une clé API n'est pas admissible.

Un Client ID et un Client secret, parfois

Seulement si le serveur n'enregistre pas les applications automatiquement. Sa documentation l'indique et les fournit. Voir Enregistrer l'Agent Workleap dans un autre outil. Les membres n'en ont jamais besoin.


​

Comment ça fonctionne

  1. Un administrateur enregistre le serveur avec son adresse, un Nom d'affichage et une Description que l'agent lira. Par exemple : « Notre système de billets de soutien. À utiliser pour les questions sur les billets, les incidents et les gardes. »

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

  3. Chaque personne 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 au nom de cette personne. Demandez « Quels billets sont ouverts pour mon équipe? » et il répond avec ce que votre compte peut voir.


​

Configuration


​

Administrateurs : enregistrer le serveur

Seuls les administrateurs d'organisation peuvent ouvrir les paramètres de l'agent. Toute autre personne voit une erreur « page introuvable ».

  1. Ouvrez les paramètres de l'agent et allez à Serveurs MCP personnalisés.

  2. Cliquez sur Ajouter un serveur.

  3. Entrez l'URL du serveur, un Nom d'affichage et une Description.

  4. Entrez l'ID client et le Secret client seulement si l'outil vous les a fournis. Le secret n'est plus affiché après l'enregistrement.

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


​

Tout le monde : connecter votre compte

  1. Ouvrez Applications connectées à partir des paramètres de votre compte. Le serveur apparaît sous le Nom d'affichage choisi par votre administrateur. Dans l'agent, vous pouvez aussi le trouver sous Sources.

  2. Cliquez sur Connecter et connectez-vous à l'outil.

L'agent peut utiliser le serveur dès votre prochain message.


​

Si l'outil vous demande de créer une application d'abord

Certains outils n'enregistrent pas les applications automatiquement. Leur documentation vous demande de créer une application, une intégration ou un client, et demande une Redirect URI. Utilisez les valeurs de Enregistrer l'Agent Workleap dans un autre outil. Si l'outil vous fournit ensuite un Client ID et un Client secret, entrez-les dans les champs ID client et Secret client au moment d'ajouter le serveur.


​

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 le doublon.

  • Pour changer un Secret client, supprimez le serveur et ajoutez-le de nouveau.

  • Supprimer un serveur déconnecte tout le monde dans Workleap. L'accès n'est pas révoqué du côté de l'outil.


​

Dépannage

Message

Quoi faire

The MCP server could not be reached at a public https address, or it does not implement the MCP authorization specification.

Confirmez que l'adresse est publique, répond en HTTPS en moins de 10 secondes et offre une connexion OAuth. L'équipe de soutien de l'outil peut confirmer ce dernier point.

The MCP server's authorization server supports neither dynamic client registration nor client-id metadata documents.

Enregistrez l'Agent Workleap auprès de l'outil pour obtenir un Client ID, puis ajoutez le serveur de nouveau avec celui-ci. Voir Enregistrer l'Agent Workleap dans un autre outil.

Vous avez atteint la limite maximale de serveurs

Supprimez un serveur que vous n'utilisez plus.

La section Serveurs MCP personnalisés n'apparaît pas

Seuls les administrateurs d'organisation la voient. Demandez à un administrateur d'enregistrer le serveur.

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