Configuration
Il vous faut un jeton API Canner (cnr_…) depuis Identité → Clés d’API. Ajoutez le serveur à la configuration de votre client MCP — claude_desktop_config.json pour Claude Desktop, .cursor/mcp.json pour Cursor — puis redémarrez le client et les outils Canner apparaissent.
{
"mcpServers": {
"canner": {
"command": "npx",
"args": ["-y", "@canner-ca/mcp"],
"env": { "CANNER_TOKEN": "cnr_your_token_here" }
}
}
}Déjà utilisé canner login avec la CLI ? Retirez la ligne CANNER_TOKEN — le serveur lit alors les identifiants enregistrés dans ~/.canner/credentials.
Outils
Chaque outil enrobe un point de terminaison de l'API REST versionnée /v1 :
canner_whoami | Confirme le compte sous lequel l'agent est connecté et l'organisation pour laquelle il agit. |
canner_list_projects | Liste les projets de cette organisation. |
canner_get_project | Donne l'état, l'URL et la source d'un projet. |
canner_list_deployments | Liste les déploiements d'un projet, du plus récent au plus ancien. |
canner_get_deployment | Lit un déploiement au complet — journal de compilation inclus. |
canner_deploy | Recompile un projet relié à GitHub depuis HEAD. |
canner_list_env_vars | Liste les variables d'environnement d'un projet. |
canner_set_env_var | Ajoute une variable d'environnement. |
canner_list_domains | Liste les domaines personnalisés d'un projet. |
canner_add_domain | Relie un domaine personnalisé. |
canner_verify_domain | Revérifie le DNS et provisionne le TLS d'un domaine. |
canner_create_project | Crée un nouveau projet vide où déployer. |
canner_save_app | Déploie une app directement depuis votre agent en envoyant ses fichiers source. |
canner_list_databases | Liste les bases de données d'un projet, avec taille et version de Postgres. |
canner_get_database | Détails de connexion d'une base. Les identifiants sont masqués sauf demande explicite. |
canner_create_database | Ajoute une autre base de données à un projet (Démarrage : une par projet; les forfaits payants peuvent en ajouter). |
canner_export_database | Démarre l'exportation d'une base; interrogez canner_get_database_operation pour le résultat. |
canner_copy_database | Copie une base dans une autre base VIDE qui vous appartient. |
canner_list_database_operations / canner_get_database_operation | Liste les opérations récentes sur les bases, ou vérifie le statut de l'une d'elles. |
canner_list_backups | Liste les sauvegardes d'une base et sa politique de sauvegarde (lecture seule — créer, restaurer et supprimer des sauvegardes se fait dans le tableau de bord ou la CLI). |
canner_get_instance | L'instance Postgres dédiée d'un projet et sa fenêtre de récupération à un instant précis (lecture seule — la création, la restauration et le déplacement se font dans le tableau de bord ou la CLI). |
canner_database_security_check | Une vérification en lecture seule de la sécurité et de la performance d'une base (politiques, fonctions, vues, index, clés primaires). Lit le catalogue, jamais vos données. |
canner_audit_database_roles | Ce que peut faire chaque rôle d'une base d'instance dédiée, avec des constats pour une configuration à moindre privilège (lecture seule). |
canner_get_instance_upgrade | Indique si l'instance dédiée peut passer à une version de Postgres plus récente et ce qui l'en empêcherait (lecture seule — la mise à niveau se fait dans le tableau de bord ou la CLI). |
canner_get_instance_config | Réglages de l'instance dédiée : préréglage, délais d'expiration, fenêtre de maintenance et redémarrage en attente (lecture seule). |
canner_set_instance_config | Modifie le préréglage, les délais d'expiration et la fenêtre de maintenance. Effet immédiat, sans redémarrage. |
canner_restart_instance | Redémarre l'instance dédiée maintenant (connexions coupées quelques secondes). Exige confirm: true, seulement avec l'accord du propriétaire. |
canner_list_extensions | Extensions offertes pour une base de l'instance dédiée et celles installées (lecture seule). |
canner_install_extension | Installe une extension (pgvector, PostGIS, pg_trgm, pg_cron…). pg_cron redémarre l'instance et exige confirm: true. |
canner_remove_extension | Retire une extension; refusé tant que des objets l'utilisent. |
canner_get_replication | Réplication logique d'une base : activée ou non, limite de WAL, publications, slots et leur santé (lecture seule). |
canner_set_replication | Active ou désactive la réplication logique (redémarre l'instance, confirm: true) ou change la limite de WAL par slot. |
canner_get_instance_memory | La répartition du budget de mémoire entre l'application et son Postgres dédié, et si un changement attend (lecture seule). |
canner_apply_instance_memory | Applique la répartition de la mémoire (redémarre l'instance, confirm: true). |
canner_set_instance_monitoring | Active ou désactive les requêtes lentes et le journal (redémarre l'instance, confirm: true). |
Sécuritaire par défaut
Les opérations destructrices — supprimer un projet, révoquer un jeton, supprimer une base ou un domaine — ne sont volontairement pasexposées, afin qu’un agent ne les déclenche pas par erreur. Faites-les depuis le tableau de bord ou la CLI.