Aller au contenu

Catalogue des outils

Le serveur MCP expose 143 outils couvrant la surface /v1. Chaque outil requiert un scope (🟢 lecture, 🟡 écriture, 🔴 suppression). Les outils 🔴 exigent une confirmation (nom, slug ou UUID de la ressource). Les clients qui chargent les outils à la demande n’en paient pas le coût en contexte tant qu’ils ne les utilisent pas.

OutilScopeRôle
list_tenants / get_tenant🟢Découverte + tenant actif, rôle courant
update_tenant🟡Préférences du tenant
list_members🟢Membres du tenant
invite_member / update_member_role🟡Gestion des membres
remove_member🔴Retirer un membre
OutilScope
list_projects / get_project🟢
create_project / update_project🟡
delete_project🔴
list_environments / get_environment🟢
create_environment / duplicate_environment / update_environment🟡
plan_environment_duplication / get_blueprint_job / export_blueprint / plan_blueprint🟢
acknowledge_blueprint_job / retry_blueprint_job / apply_blueprint🟡
cancel_blueprint_job / delete_environment🔴

Une VM réservée à un environnement, facturée au coût fournisseur. add_dedicated_server engage une dépense ; release_dedicated_server détruit la VM.

OutilScopeRôle
list_environment_offers🟢Offres disponibles (fournisseur, région, prix) pour un environnement ou un projet
list_dedicated_servers🟢Serveurs dédiés existants
add_dedicated_server🟡Commande un serveur dédié
release_dedicated_server🔴Libère et détruit le serveur
OutilScopeRôle
list_catalog🟢Briques proposables (service, addon ou stack), à lire avant de créer
probe_repo🟢Analyse un dépôt (moteur de build, port) avant create_service
get_github_connection🟢État de la connexion GitHub du tenant
list_github_repos / list_github_branches🟢Dépôts et branches accessibles
OutilScope
list_services / get_service / get_service_health🟢
create_service / update_service / resize_service🟡
stop_service / start_service🟡
expose_service / unexpose_service🟡
hibernate_service / prune_service_images / delete_service🔴
deploy_service / cancel_deployment🟡
rollback_service🔴
list_deployments / get_deployment🟢
get_build_logs / get_startup_logs / get_deployment_events🟢

expose_service publie un service sur un domaine public (redéploiement requis, puis lire publicHostname). Pour diagnostiquer : get_build_logs (build), get_startup_logs (conteneur qui plante au démarrage), get_deployment_events (bloqué avant le build).

Un service en appelle un autre sans passer par Internet (<service>.<env>.<projet>.svc.cassiope.internal). Les variables {PREFIX}_URL, _HOST et _PORT sont injectées au déploiement ; les deux services doivent être sur le même serveur.

OutilScopeRôle
list_exposable_targets🟢Services joignables en interne
list_service_links / get_service_endpoint🟢Liens existants et point d’accès interne
expose_service_endpoint🟡Déclare le port interne d’un service
link_services🟡Relie un consommateur à un service cible
revoke_service_link🔴Coupe le lien
OutilScope
list_env_vars / list_platform_env_vars🟢
set_env_var / import_env_vars / mark_variables_secret🟡
delete_env_var🔴
list_service_files🟢
create_service_file / update_service_file🟡
delete_service_file🔴
list_domains / get_domain🟢
add_domain / verify_domain🟡
remove_domain🔴

list_platform_env_vars montre ce que la plateforme injecte elle-même. Les fichiers montés sont des gabarits (${CLE}) rendus avec les variables du service, effectifs au déploiement suivant.

Groupes de conteneurs déployés depuis un docker-compose (collé ou lu dans un dépôt git). Parcours type : preview_stack (dry-run) → create_stack → deploy_stack.

OutilScope
list_stacks / get_stack / preview_stack🟢
create_stack / deploy_stack / redeploy_stack🟡
start_stack / stop_stack🟡
hibernate_stack / delete_stack🔴
list_stack_updates🟢
update_stack / resize_stack_services🟡
add_stack_volume / upgrade_stack_volume_storage🟡
list_stack_deployments / get_stack_deployment_events / get_stack_startup_logs🟢
get_stack_logs / get_stack_disk / get_stack_metrics🟢
list_stack_env_vars🟢
set_stack_env_var🟡
delete_stack_env_var🔴

update_stack sauvegarde les volumes puis revient automatiquement à la version précédente si la santé échoue. Les valeurs des variables ne sont jamais renvoyées, et la révélation des secrets et l’import en masse ne sont pas exposés par le MCP.

Un volume détaché survit à sa ressource et reste facturé : list_volumes avec detached: true permet de les retrouver.

OutilScope
list_volumes / list_attachable_volumes🟢
create_volume / attach_volume / resize_volume🟡
detach_volume / delete_volume🔴
list_volume_backups🟢
backup_volume / set_volume_backup_hook / restore_volume_backup🟡
delete_volume_backup / replace_volume_from_backup🔴

restore_volume_backup écrit dans un volume neuf et ne touche pas l’original. replace_volume_from_backup remplace le contenu au même point de montage (ressource arrêtée, ancien volume conservé détaché).

OutilScope
list_addons / get_addon🟢
create_addon / resize_addon / upgrade_addon_storage🟡
delete_addon🔴
backup_addon / cancel_addon_backup🟡
list_addon_backups / get_addon_backup🟢
restore_addon_backup / delete_addon_backup🔴
list_bindings🟢
create_binding / rotate_binding🟡
delete_binding🔴
list_consultation_grants / get_consultation_grant🟢
create_consultation_grant🔴
revoke_consultation_grant🟡
OutilScope
get_logs / get_metrics / get_audit_log🟢
get_billing / get_consumption / list_invoices / list_recovery_notices🟢
create_portal_session🟡
change_plan🔴

Le serveur fournit aussi des ressources (cassiope://catalog/addons, .../plans, .../instance-types, .../regions, cassiope://tenant, cassiope://projects) et des prompts guidés : deployer-depuis-github, diagnostiquer-deploiement, connecter-addon.