ok, un summary et, lorsque quelque chose a échoué ou nécessite votre intervention, un code.
Tous les outils s’exécutent immédiatement. La suppression d’une application ou d’une base de données et la restauration d’un snapshot prennent d’abord un snapshot de sécurité.
Applications
| Outil | Ce qu’il fait | Scope |
|---|---|---|
list_applications | Liste vos applications (ID, nom, langage, en cours d’exécution ou non, domaine), 100 par page. | apps:read |
get_application_status | Statut en direct d’une application : CPU, RAM, uptime, adresse, domaine personnalisé, mémoire et redémarrage automatique. | apps:read |
get_all_applications_status | Si chacune de vos applications est en cours d’exécution, en un seul appel. | apps:read |
get_application_logs | Les derniers logs d’une application, environ les 4 000 derniers caractères. | apps:read |
get_deployments | Historique des deploys Git (GitHub App ou webhook) d’une application : commit, branche, résultat, durée et erreur d’un deploy échoué. | apps:read |
get_metrics_history | Historique CPU et RAM d’une application ou d’une base de données, avec les valeurs moyenne, maximale et la plus récente. 24 heures, ou 7 jours sur Pro et Enterprise (pour une application, seulement à partir de 512 Mo). | apps:read ou databases:read |
start_application | Démarre une application arrêtée. | apps:control |
stop_application | Arrête une application en cours d’exécution. | apps:control |
restart_application | Redémarre une application, ce qui applique aussi les modifications de fichiers et de configuration. | apps:control |
create_application | Crée et déploie une nouvelle application à partir d’un starter (Node.js, Python, site statique, Go, Rust, Elixir, .NET, PHP ou Ruby), avec vos premiers fichiers si vous le souhaitez. | apps:write |
delete_application | Supprime une application, après un snapshot de sécurité. | apps:write |
Fichiers et configuration
| Outil | Ce qu’il fait | Scope |
|---|---|---|
list_files | Liste un dossier d’une application. | files:read |
read_file | Lit un fichier texte de 10 Mo au maximum, page par page. | files:read |
search_files | Recherche un texte ou une expression régulière dans les fichiers d’une application, en ignorant node_modules, .git, la sortie de build, les fichiers de verrouillage et les binaires. | files:read |
create_file | Écrit un fichier avec tout son contenu (128 Ko au maximum), en créant ses dossiers. Remplace un fichier qui existe déjà. | files:write |
edit_file | Remplace le contenu d’un fichier existant (128 Ko au maximum). | files:write |
patch_file | Modifie un fichier de 10 Mo au maximum par des remplacements exacts de type rechercher-remplacer. Si une modification ne correspond pas, rien n’est écrit. | files:write |
rename_file | Renomme ou déplace un fichier ou un dossier. | files:write |
delete_file | Supprime un fichier ou un dossier. Refuse la racine de l’application, le fichier de configuration et les fichiers .env. | files:write |
edit_config_file | Modifie le fichier de configuration champ par champ : nom d’affichage, description, mémoire, redémarrage automatique, sous-domaine, MAIN et START. | files:write |
MAIN et START au prochain redémarrage.
Variables d’environnement
| Outil | Ce qu’il fait | Scope |
|---|---|---|
list_env_vars | Liste les noms des variables d’environnement d’une application, jamais leurs valeurs. | envs:read |
set_env_vars | Ajoute, modifie ou supprime des variables en un seul appel, avec un redémarrage facultatif. | envs:write (avec restart, aussi apps:control) |
Snapshots
| Outil | Ce qu’il fait | Scope |
|---|---|---|
list_snapshots | Snapshots d’une application ou d’une base de données, du plus récent au plus ancien. Sans cible, une vue d’ensemble du compte, y compris les applications supprimées dont il reste des snapshots. | snapshots:read |
create_snapshot | Prend un snapshot d’une application ou d’une base de données. Compte dans la limite quotidienne de snapshots de votre plan. | snapshots:write |
restore_snapshot | Restaure une application ou une base de données existante à partir d’un snapshot, après un snapshot de son état actuel. | snapshots:write |
Bases de données
| Outil | Ce qu’il fait | Scope |
|---|---|---|
list_databases | Liste vos bases de données (ID, nom, moteur, RAM, hôte, port, en cours d’exécution ou non). | databases:read |
create_database | Crée une base de données (plans Standard et supérieurs), ce qui prend jusqu’à 90 secondes environ. Avec connect_to_app, écrit aussi l’URL de connexion et le fichier de certificat dans une application. | databases:write (avec connect_to_app, aussi databases:credentials et envs:write) |
start_database | Démarre une base de données arrêtée. | databases:write |
stop_database | Arrête une base de données en cours d’exécution. Les applications qui l’utilisent perdent leur connexion jusqu’à son redémarrage. | databases:write |
update_database | Modifie la RAM d’une base de données, appliquée à chaud. | databases:write |
connect_database | Connecte une base de données existante à une application : renouvelle son mot de passe, écrit la nouvelle URL et le certificat dans l’application, et met à jour les autres applications qui l’utilisent. | databases:credentials et envs:write |
rotate_database_credentials | Renouvelle le mot de passe ou le certificat TLS d’une base de données et nomme les applications mises à jour. | databases:credentials |
delete_database | Supprime une base de données et ses données, après un snapshot de sécurité. | databases:write |
Domaines et réseau
Les outils réseau fonctionnent sur les sites web (applications avec un domaine), sur des périodes de 7 jours au maximum.| Outil | Ce qu’il fait | Scope |
|---|---|---|
list_account_domains | Tous les domaines de toutes les applications : adresses squareweb.app et domaines personnalisés, 100 par page. | apps:read |
list_dns_records | Les enregistrements DNS à créer pour le domaine personnalisé d’une application, avec leur statut. | apps:read |
set_custom_domain | Connecte, remplace ou supprime le domaine personnalisé d’une application et renvoie les enregistrements DNS à créer. | apps:write |
purge_network_cache | Purge le cache edge de 50 applications au maximum en un seul appel. | apps:write |
get_network_analytics | Trafic edge : requêtes, visites et octets, avec des répartitions par pays, chemin, référent, appareil et plus encore. | apps:read |
get_network_errors | Erreurs HTTP edge par code de statut, chemin et méthode. 5xx par défaut, 4xx sur demande. | apps:read |
get_network_performance | Temps jusqu’au premier octet et temps de réponse de l’origine (p50, p95, p99) et les chemins les plus lents. Pro et Enterprise. | apps:read |
get_network_logs | Les 40 dernières requêtes edge, avec les adresses IP masquées. Pro et Enterprise. | apps:read |
Workspaces
| Outil | Ce qu’il fait | Scope |
|---|---|---|
list_workspaces | Les workspaces dont vous êtes propriétaire ou membre, avec les membres et les applications partagées. Lecture seule : les autres outils n’atteignent que vos propres applications. | workspaces:manage |
Aide et statut
Ces outils n’ont besoin que du scopemcp.
| Outil | Ce qu’il fait | Scope |
|---|---|---|
get_platform_knowledge | La référence propre à Square Cloud sur les limites, les plans, les codes d’erreur et la configuration. | mcp |
search_help_center | Recherche dans le centre d’aide ou lit l’un de ses articles. | mcp |
list_help_center | Liste tous les articles du centre d’aide par catégorie. | mcp |
get_platform_status | Le statut des services de Square Cloud et des fournisseurs dont ils dépendent. | mcp |
get_discord_status | Le statut propre à Discord et la latence de son API, pour distinguer une panne de Discord d’un problème de bot. | mcp |
Volontairement exclus
| Non disponible | Pourquoi | À la place |
|---|---|---|
| Téléchargement des snapshots | Le lien signé contient votre code et vos variables d’environnement, et il se retrouverait dans la conversation et chez le fournisseur du modèle d’IA. | Téléchargez-le depuis le tableau de bord. |
| Téléchargement des certificats de base de données | Même raison : le certificat quitterait Square Cloud en passant par le modèle. | Téléchargez-le depuis le tableau de bord. |
| Activité du compte | Elle affiche les adresses IP et les appareils de votre compte. | Consultez votre fil d’activité. |