betool betool

Documentation

Piloter betool depuis Claude (MCP)

Branchez Claude (Claude Code) sur betool via le serveur MCP pour lire votre configuration et proposer des changements en langage naturel — sous gouvernance et validation humaine.

Piloter betool depuis Claude (serveur MCP)

betool expose un serveur MCP (Model Context Protocol) : un client MCP externe — typiquement Claude Code — peut lire la configuration de votre organisation et proposer des changements en langage naturel (créer/éditer un pipeline, un rôle, une mission, une évaluation…). C'est l'équivalent d'un assistant qui configure betool avec vous, sous gouvernance complète.

Propose, ne modifie jamais directement. Toute modification passe par une proposition que vous validez d'un bouton Accepter dans betool. Claude ne peut rien appliquer seul. C'est plus sûr qu'un outil qui écrit directement.

Ce que Claude peut faire

  • Lire : inventaire des modèles, graphe et nœuds d'un pipeline, contrats de configuration, rôles/missions, outils disponibles, base de connaissances.
  • Proposer : via l'outil proposals.create, une proposition de changement en attente — vous l'acceptez ou la refusez dans l'interface.

Claude découvre le contrat exact de chaque nœud (champs, valeurs autorisées) avant de proposer : pas d'invention, pas de configuration invalide.

Créer une clé MCP

  1. Dans betool, ouvrez Paramètres → MCP.
  2. Donnez un nom à la clé et choisissez son périmètre :
    • Lecture seule — Claude lit la configuration, ne propose rien ;
    • Lecture + propositions (recommandé) — Claude lit et peut soumettre des propositions ;
    • Complet — l'ensemble des droits de la clé.
  3. La clé brute n'est affichée qu'une seule fois — copiez-la immédiatement (elle n'est plus jamais relisible). Vous pouvez révoquer une clé à tout moment.

Brancher Claude Code

Ajoutez le serveur MCP betool à Claude Code (la clé passe dans l'en-tête Authorization) :

claude mcp add betool \
  --transport http \
  --header "Authorization: Bearer <votre-clé-MCP>" \
  https://platform.betool.ai/mcp

Demandez ensuite à Claude, en langage naturel : « inspecte mon pipeline X et propose une étape qui résume le ticket avant l'envoi ». Claude lit la configuration, compose une proposition, et vous la validez dans betool.

Ne collez jamais de secret en clair dans le chat. Le périmètre de Claude est borné par le scope de la clé, et chaque appel d'outil est tracé dans Paramètres → MCP → journal (RGPD art. 15).

Périmètre & isolation

  • Par défaut, une clé n'opère que sur votre propre organisation — l'org cible est forcée côté serveur ; vous ne passez jamais d'identifiant d'organisation en argument.
  • Les clés vendor (organisation backoffice) peuvent cibler une autre organisation, sous le consentement explicite de celle-ci et avec traçabilité — utile pour un usage d'éditeur multi-tenant.

Journal d'audit

Chaque appel d'outil (externe via MCP et interne) écrit une ligne d'audit : qui, quel outil, quel canal, quel périmètre, quel résultat, quelle latence. Consultable dans Paramètres → MCP, scopé strictement à votre organisation.

À venir

  • Claude Desktop via OAuth 2.1 (connexion « grand public » sans manipuler de clé en en-tête).
  • Exposition fine, par outil, de la surface accessible via MCP.

Voir aussi