Connecter un client MCP
Une adresse de serveur pour les outils de votre toolset.
Le client liste et appelle les outils exposés par Vela.
find_customerREADget_available_slotsREADread_order_statusREADVotre parcours, en trois étapes.
- 01
Copiez la configuration MCP
La fiche du toolset fournit l’adresse du serveur et la configuration à adapter à votre client.
- 02
Configurez l’authentification
Utilisez le token du toolset avec Authorization: Bearer. Le token est distinct de la clé d’un connecteur.
- 03
Vérifiez les outils exposés
Contrôlez la liste des outils dans le client et commencez par une lecture. Les restrictions du toolset restent applicables.
Un point à approfondir ?
Ouvrez uniquement le sujet dont vous avez besoin.
Vue d’ensemble
Un Toolset est un serveur MCP en Streamable HTTP. Si vous utilisez Claude Desktop ou Cursor, la page Créer un toolset suffit — celle-ci sert à le brancher dans quelque chose que vous avez écrit.
find_customerREADget_available_slotsREADread_order_statusREADSe connecter
{
"mcpServers": {
"vela": {
"url": "https://api.example.com/mcp/{toolsetId}",
"headers": { "Authorization": "Bearer vela_ts_…" }
}
}
}Les deux erreurs que tout le monde fait
La valeur de l’en-tête doit commencer par Bearer — sans cela aucun token n’est lu et tout appel est refusé en 401. Et l’URL est celle de l’API, pas celle du tableau de bord : l’adresse lue dans votre navigateur répond 404 sans rien expliquer.
Les méthodes
| Méthode | Comportement |
|---|---|
initialize | Négocie la version du protocole, annonce la capacité tools. |
tools/list | Les connecteurs actifs et autorisés de ce Toolset. Les schémas d’entrée viennent du contrat de chaque connecteur. |
tools/call | En exécute un. Un connecteur qui refuse renvoie un résultat d’outil avec isError: true plutôt qu’une erreur JSON-RPC : c’est au modèle de réagir à une mauvaise date. |
ping | Répond {}. |
notifications/* | 202, corps vide. |
Les annotations
| Annotation | Connecteur de lecture | Connecteur d’action |
|---|---|---|
readOnlyHint | true | false |
destructiveHint | false | true |
idempotentHint | false | false — une réservation posée deux fois fait deux réservations |
openWorldHint | true | true |
Ce sont des indications que votre client peut ignorer. Le contrôle qui s’impose vraiment est l’interrupteur lecture seule du Toolset, qui cache les connecteurs d’action dans tools/list et les refuse dans tools/call — le second compte, parce qu’un agent peut travailler depuis une liste récupérée plus tôt.
Ce que fait réellement un appel
Il exécute le connecteur par le même chemin que votre propre code : la limite de débit, la gestion de session, l’historique d’exécution et la réparation automatique s’appliquent donc. Un appel d’agent est une exécution, et il est facturé comme telle.
Les tokens
- Le token d’un Toolset n’est pas une clé de connecteur. Le révoquer ne casse aucune intégration directe.
- Il est stocké sous forme d’empreinte et peut être renouvelé ; l’ancien cesse de fonctionner immédiatement.
- Un mauvais token et un Toolset inconnu renvoient le même message : l’endpoint ne permet donc pas de découvrir quels Toolsets existent.
Regroupez les bonnes actions dans un toolset MCP.
↗Votre situation ne correspond pas au guide ?
Échanger avec l’équipe ↗