Automatisation
Référence des outils MCP
Voici les outils que le serveur MCP expose, dans ses formes locale et hébergée. Chacun relaie une seule opération de l'API de gestion, donc la permission qu'un outil requiert est la permission que cette opération requiert ; le jeton de l'agent doit la détenir. Le catalogue et les descriptions viennent du serveur lui-même ; pour le schéma exact de requête et de réponse de l'opération derrière un outil, vois la référence interactive de l'API.
Un outil ne s'exécute que si le jeton derrière lui est autorisé à effectuer l'opération sous-jacente. La colonne Permission utilise ces valeurs, qui correspondent au modèle de permissions et portée de l'équipe :
| Valeur | Signifie |
|---|
| Account | N'importe quel jeton valide sur le compte. Les outils qui génèrent des jetons et des sièges requièrent en plus un identifiant maître de compte (une session du tableau de bord ou le Personal Access Token) ; un jeton d'équipe ne peut générer ni jetons ni sièges. |
| read | La permission read. Les outils à portée de site requièrent aussi que la clé de site soit dans la portée du jeton. |
| create | La permission create sur l'équipe (créer une clé de site dedans). |
| edit | La permission edit, limitée à la clé de site que l'outil cible. |
| manage | La permission manage : administration de l'équipe (membres, jetons, réglages à l'échelle de l'équipe). |
Quelques outils requièrent aussi un niveau d'offre, noté dans la description : la marque blanche est Apex, la personnalisation de la langue et du skin du jeu est Alpha et au-dessus, et les journaux d'audit sont Apex.
| Outil | Fait | Permission |
|---|
caputchin_ping | Vérification de santé ; renvoie l'id de compte résolu quand le jeton est valide. | Account |
caputchin_get_account | Le compte authentifié (id, e-mail, offre). | Account |
caputchin_me_billing | Résumé de facturation (offre, statut, période). | Account |
caputchin_get_seats | Usage des sièges pour le compte (utilisés, total, ventilation). | Account |
| Outil | Fait | Permission |
|---|
caputchin_list_tokens | Liste les jetons du compte ; ne renvoie jamais de secrets. | Account |
caputchin_create_token | Génère un jeton (type troop ou account) ; valeur renvoyée une fois. | Account (master) |
caputchin_rotate_token | Fait tourner le secret d'un jeton ; nouvelle valeur renvoyée une fois. | Account (master) |
caputchin_revoke_token | Révoque un jeton ; effectif immédiatement. | Account (master) |
caputchin_invite_seat_user | Invite un utilisateur dans une équipe (sensible aux sièges) ; consomme un siège si nouveau. | Account (master) |
caputchin_remove_seat_user | Retire un utilisateur de chaque équipe du compte. | Account (master) |
caputchin_mint_seat_pat | Génère et attache un jeton d'équipe en un appel ; valeur renvoyée une fois. | Account (master) |
caputchin_attach_seat_pat | Attache un jeton d'équipe existant à une autre équipe. | Account (master) |
caputchin_revoke_seat_pat | Révoque un jeton d'équipe sur tout le compte. | Account (master) |
| Outil | Fait | Permission |
|---|
caputchin_list_troops | Liste les équipes du compte. | Account |
caputchin_get_troop | Une équipe par id. | read |
caputchin_create_troop | Crée une équipe partagée. | Account |
caputchin_rename_troop | Renomme une équipe. | manage |
caputchin_delete_troop | Supprime une équipe ; refuse si elle possède encore des clés de site. | manage |
caputchin_list_troop_members | Les membres d'une équipe avec leurs permissions et leur portée. | read |
caputchin_add_troop_member | Ajoute un utilisateur par e-mail avec permissions et portée ; peut consommer un siège. | manage |
caputchin_update_troop_member | Change les permissions ou la portée d'un membre. | manage |
caputchin_remove_troop_member | Retire un membre ; libère son siège si c'était son dernier. | manage |
caputchin_list_troop_pats | Les jetons d'équipe attachés à une équipe. | read |
caputchin_attach_troop_pat | Attache un jeton d'équipe avec permissions et portée ; consomme un siège. | manage |
caputchin_update_troop_pat | Change les permissions ou la portée d'un jeton attaché. | manage |
caputchin_detach_troop_pat | Détache un jeton d'équipe ; libère son siège. | manage |
caputchin_get_troop_security | Les réglages de sécurité d'une équipe (le plafond de jeu forcé). | read |
caputchin_update_troop_security | Fixe le plafond de jeu forcé pour l'équipe. | manage |
| Outil | Fait | Permission |
|---|
caputchin_list_sites | Toutes les clés de site dans les équipes du compte. | read |
caputchin_get_site | Une clé de site par id. | read |
caputchin_create_site | Crée une clé de site (dans une équipe, ou Personal) ; renvoie le secret à usage unique. | create |
caputchin_update_site | Met à jour le nom ou l'indicateur de désactivation d'une clé. | edit |
caputchin_delete_site | Supprime une clé ; cascade les sessions et la config. Irréversible. | edit |
caputchin_rotate_site_secret | Fait tourner le secret ; l'ancien cesse aussitôt ; le nouveau renvoyé une fois. | edit |
caputchin_get_site_cap_config | La config de proof of work d'une clé. | read |
caputchin_update_site_cap_config | Met à jour la config de proof of work. | edit |
caputchin_get_site_security | Les réglages de sécurité d'une clé (le gate d'exiger un jeu). | read |
caputchin_update_site_security | Bascule le gate par clé d'exiger un jeu. | edit |
caputchin_list_site_sessions | Les sessions de vérification récentes d'une clé. | read |
| Outil | Fait | Permission |
|---|
caputchin_get_hosted_verification | La config de vérification hébergée d'une clé. | read |
caputchin_set_hosted_verification | Fixe l'indicateur d'activation et les destinations. | edit |
caputchin_test_hosted_verification | Déclenche un envoi synthétique vers les destinations configurées. | edit |
| Outil | Fait | Permission |
|---|
caputchin_site_stats | Stats de vérification d'un site sur une plage. | read |
caputchin_site_stats_dashboard | Agrégat du tableau de bord des stats de site. | read |
caputchin_site_stats_activity | Série d'activité des stats de site. | read |
caputchin_site_stats_durations | Percentiles de durée des stats de site. | read |
caputchin_site_stats_rejections | Décomptes de rejets de site. | read |
caputchin_troop_stats | Totaux à vie des stats d'équipe. | read |
caputchin_troop_stats_dashboard | Agrégat du tableau de bord des stats d'équipe. | read |
caputchin_troop_stats_activity | Série d'activité des stats d'équipe. | read |
caputchin_troop_stats_durations | Percentiles de durée des stats d'équipe. | read |
caputchin_troop_stats_rejections | Décomptes de rejets d'équipe. | read |
caputchin_quick_stats_sites | Instantané compact des stats par site sur tout le compte. | read |
caputchin_quick_stats_troops | Instantané compact des stats par équipe sur tout le compte. | read |
caputchin_site_delivery_dashboard | Stats de livraison de vérification hébergée pour un site. Apex. | read |
caputchin_troop_delivery_dashboard | Stats de livraison de vérification hébergée pour une équipe. Apex. | read |
caputchin_account_audit_logs | Journal d'audit au niveau du compte. Apex. | Account |
caputchin_troop_audit_logs | Journal d'audit de l'équipe. Apex. | read |
caputchin_site_audit_logs | Journal d'audit de la clé de site. Apex. | read |
| Outil | Fait | Permission |
|---|
caputchin_list_games | Liste les jeux du marketplace. | Account |
caputchin_search_games | Cherche des jeux du marketplace par texte. | Account |
caputchin_get_game | Un jeu du marketplace par id. | Account |
Ceux-ci ciblent une portée (une clé de site ou une équipe), donc un changement à portée de site requiert edit sur cette clé et un changement à l'échelle de l'équipe requiert manage. La personnalisation de la langue et du skin est Alpha et au-dessus.
| Outil | Fait | Permission |
|---|
caputchin_list_customized_games | Les jeux enregistrés (installés) d'une portée. | read |
caputchin_register_customized_game | Enregistre (installe) un jeu sur une portée ; épingle un instantané. | edit (site) ou manage (troop) |
caputchin_repin_customized_game | Réépingle un jeu enregistré à la dernière version. | edit (site) ou manage (troop) |
caputchin_update_customized_game | Met à jour les réglages d'un jeu enregistré (mise à jour auto). | edit (site) ou manage (troop) |
caputchin_delete_customized_game | Désinstalle un jeu enregistré d'une portée. | edit (site) ou manage (troop) |
caputchin_list_game_presets | Préréglages de personnalisation pour une portée et un jeu. | read |
caputchin_set_game_preset | Crée ou met à jour un préréglage de jeu. Alpha+. | edit (site) ou manage (troop) |
caputchin_delete_game_preset | Supprime un préréglage de jeu. Alpha+. | edit (site) ou manage (troop) |
caputchin_set_game_default | Fixe le préréglage de jeu par défaut pour un axe. Alpha+. | edit (site) ou manage (troop) |
caputchin_get_custom_game_schema | Le schéma de champs d'un jeu personnalisé pour une portée. | read |
caputchin_set_custom_game_schema | Fixe le schéma de champs d'un jeu personnalisé. Alpha+. | edit (site) ou manage (troop) |
caputchin_delete_custom_game_schema | Supprime le schéma de champs d'un jeu personnalisé. Alpha+. | edit (site) ou manage (troop) |
caputchin_upload_custom_game_run | Téléverse l'artefact de run headless d'un jeu personnalisé. | edit (site) ou manage (troop) |
caputchin_get_custom_game_run | Récupère la référence de l'artefact de run stocké d'un jeu personnalisé. | read |
caputchin_delete_custom_game_run | Supprime l'artefact de run d'un jeu personnalisé. | edit (site) ou manage (troop) |
La marque blanche du shell du widget est une fonctionnalité Apex. Comme pour la personnalisation des jeux, un changement à portée de site requiert edit et un changement à l'échelle de l'équipe requiert manage.
| Outil | Fait | Permission |
|---|
caputchin_list_white_label_presets | Préréglages de marque blanche pour une portée. | read |
caputchin_set_white_label_preset | Crée ou met à jour un préréglage de marque blanche. Apex. | edit (site) ou manage (troop) |
caputchin_delete_white_label_preset | Supprime un préréglage de marque blanche. Apex. | edit (site) ou manage (troop) |
caputchin_set_white_label_default | Fixe le préréglage de marque blanche par défaut pour un axe. Apex. | edit (site) ou manage (troop) |
