---
type: reference
title: Référence des outils MCP
summary: Chaque outil MCP de Caputchin, ce qu'il fait, et la permission que son jeton doit détenir, regroupés par domaine.
---

Voici les outils que le [serveur MCP](/docs/automation/mcp) expose, dans ses formes locale et hébergée. Chacun relaie une seule opération de l'[API de gestion](/docs/automation/management-api), donc la permission qu'un outil requiert est la permission que cette opération requiert ; le [jeton](/docs/automation/management-api#mint-an-access-token) 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](/docs/api-reference).

## Comment les permissions fonctionnent ici

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](/docs/troops/permissions) 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](/docs/account-management/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**.

## Compte et santé

| 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 |

## Jetons et sièges

| 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) |

## Équipes

| 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é plus les valeurs par défaut du mode Aperçu et de la Réutilisation de vérification). | read |
| `caputchin_update_troop_security` | Fixe le plafond de jeu forcé et les valeurs par défaut de toute l'équipe du mode Aperçu et de la Réutilisation de vérification. | manage |

## Clés de site

| 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, le mode Aperçu et la Réutilisation de vérification). | read |
| `caputchin_update_site_security` | Bascule par clé le gate d'exiger un jeu, le mode Aperçu et la Réutilisation de vérification. | edit |
| `caputchin_list_site_sessions` | Les sessions de vérification récentes d'une clé. | read |

## Vérification hébergée

| 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 |

## Statistiques, livraison et journaux d'audit

| 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 |

## Jeux du marketplace

| 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 |

## Personnalisation des jeux

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) |

## Marque blanche

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) |

## Voir aussi

- [Utiliser le serveur MCP](/docs/automation/mcp) : connecter un agent via l'un ou l'autre transport.
- [Permissions et portée](/docs/troops/permissions) : le modèle read / create / edit / manage que la table ci-dessus utilise.
- [Référence interactive de l'API](/docs/api-reference) : le schéma exact de l'opération derrière chaque outil.