Donner des outils à un agent IA

Un Toolset est un groupe nommé de connecteurs derrière une seule adresse et une seule clé, que vous remettez à un agent IA. L’agent voit alors chaque connecteur du groupe comme un outil qu’il peut appeler : consulter les créneaux libres, poser une réservation, lire une facture. Cela fonctionne avec Claude, Cursor, et tout ce qui parle le même standard (MCP).

• Au moins un connecteur. Un connecteur en pause n’est pas proposé à votre agent tant que vous ne l’avez pas réactivé.
• Un nom correspondant au métier de l’agent — « Accueil », « Facturation » — plutôt qu’un nom construit sur les sites qui sont derrière.
• Un endroit où coller le résultat : la page de réglages de votre agent, là où se déclarent les outils personnalisés ou les serveurs MCP.

1. 1

   Ouvrez Toolsets et cliquez sur New Toolset

   Toolsets est dans le menu de gauche. Le bouton ouvre une fenêtre intitulée Create New MCP Toolset.

2. 2

   Renseignez Toolset Name

   C’est obligatoire : la fenêtre ne vous laissera pas créer le Toolset sans cela. Utilisez le métier, par exemple Front desk.

3. 3

   Renseignez Description (Optional)

   Une ligne sur l’usage de ce groupe. Elle s’affiche sur la page du Toolset et vous aidera plus tard à distinguer deux Toolsets voisins.

4. 4

   Décidez tout de suite de la case Read-Only Server

   Cochez Read-Only Server et tout connecteur qui modifie quelque chose est refusé à l’entrée, avant même d’être proposé à l’agent. Cochez-la dès que l’agent n’est pas un agent que vous avez construit et en qui vous avez confiance. L’état se consulte ensuite sur la page du Toolset ; considérez que c’est le réglage le plus important.

5. 5

   Cliquez sur Create Toolset

   La fenêtre se ferme et le Toolset apparaît dans la liste.

1. 1

   Ouvrez le Toolset, puis cliquez sur Attach Connector

   Le bouton est à côté de Exposed Connector Tools, en haut de la liste des outils. Une fenêtre intitulée Attach Connector as MCP Tool s’ouvre.

2. 2

   Choisissez le connecteur dans Select Active Connector

   La liste ne contient que les connecteurs que l’agent a le droit de voir : les actifs, filtrés encore par le réglage lecture seule. Si celui que vous voulez n’y est pas, c’est qu’il n’est pas en Live, ou que le Toolset est en lecture seule et que ce connecteur modifie quelque chose.

3. 3

   Renseignez Toolset Name (for Agent Calls)

   C’est le nom que verra l’agent : faites-lui décrire la tâche et le compte, read_slots_example_booking, pas tool1. Lettres, chiffres, tirets bas et traits d’union uniquement.

4. 4

   Renseignez Tool Description (Instructions for LLM)

   Une ou deux phrases disant à l’agent quand utiliser cet outil et ce que signifient les valeurs. Ce texte est sa seule consigne : soyez direct.

5. 5

   Cliquez sur Attach Tool

   Le connecteur apparaît dans Exposed Connector Tools, avec une étiquette READ (GET) ou WRITE (POST) et le nom que l’agent appellera.

6. 6

   Répétez pour chaque connecteur nécessaire à l’agent

   Un Toolset contenant une lecture et une action sur le même site est la forme habituelle : un outil consulte, l’autre modifie.

1. 1

   Copiez le token au moment où il s’affiche

   À la création d’un Toolset, et à chaque fois que vous appuyez sur Rotate Token, Vela affiche le token une seule fois, dans une fenêtre intitulée Save your MCP Bearer Token. Copiez-le à ce moment-là : seule une empreinte est conservée, donc il ne peut pas être réaffiché.

2. 2

   Collez le bloc de configuration dans votre agent

   La page du Toolset vous donne l’adresse et le token déjà disposés comme votre agent les attend. Collez ce bloc dans ses réglages MCP ou d’outils personnalisés, et non l’adresse lue dans la barre du navigateur.

3. 3

   Gardez le mot d’en-tête devant le token

   Le token doit être envoyé exactement tel quel, mot d’en-tête compris. S’il saute, aucun token n’est lu du tout et chaque appel est refusé.

Read-Only Server se règle à la création du Toolset. Les connecteurs qui modifient quelque chose sont alors cachés à l’agent et refusés s’il essaie quand même, y compris quand il travaille depuis une liste récupérée plus tôt. C’est le réglage à utiliser pour un agent que vous n’avez pas construit : on ne peut pas l’en dissuader par la parole.

• Renommer ou redécrire un outil : ouvrez le Toolset et modifiez le nom ou la description sur la carte du connecteur. L’agent en tiendra compte au prochain listage des outils.
• Retirer un outil : l’icône corbeille sur la carte du connecteur. L’agent ne peut plus ni le voir ni l’appeler.
• Remplacer la clé : Rotate Token sur la page du Toolset. Copiez le nouveau token immédiatement — l’ancien cesse de fonctionner aussitôt, donc collez le nouveau dans votre agent dans la foulée.

• Le connecteur voulu n’est pas dans Select Active Connector. Il n’est pas encore en Live, ou le Toolset est en lecture seule et ce connecteur modifie quelque chose. Ce refus, c’est l’interrupteur lecture seule qui fait son travail.
• Votre agent ne voit aucun outil. L’adresse collée est probablement celle de la barre du navigateur plutôt que celle affichée sur la page du Toolset, ou bien le mot d’en-tête manque devant le token.
• Un appel est refusé comme si aucune clé n’avait été envoyée. Le token a été renouvelé après votre copie. Collez le nouveau.
• Un outil que l’agent voyait a disparu. Le connecteur derrière n’est plus en Live, ou il a été retiré du Toolset.

Un appel par un agent est une utilisation comme une autre : il apparaît dans l’historique du connecteur et compte dans votre quota, exactement comme si vous aviez appelé le connecteur vous-même.

• Montages sans code (n8n, Make, Zapier, CloseBot, Vapi) : Brancher vos autres outils.
• Votre propre code en MCP : Connecter un client MCP.
• Rien ne marche et il vous faut une sortie : Résoudre un problème.