ok, un summary e, quando qualcosa è fallito o richiede il tuo intervento, un code.
Tutti i tool vengono eseguiti subito. L’eliminazione di un’applicazione o di un database e il ripristino di uno snapshot fanno prima uno snapshot di sicurezza.
Applicazioni
| Tool | Cosa fa | Scope |
|---|---|---|
list_applications | Elenca le tue applicazioni (ID, nome, linguaggio, in esecuzione o meno, dominio), 100 per pagina. | apps:read |
get_application_status | Stato in tempo reale di un’applicazione: CPU, RAM, uptime, indirizzo, dominio personalizzato, memoria e riavvio automatico. | apps:read |
get_all_applications_status | Se ciascuna delle tue applicazioni è in esecuzione, in una sola chiamata. | apps:read |
get_application_logs | Gli ultimi log di un’applicazione, circa gli ultimi 4.000 caratteri. | apps:read |
get_deployments | Cronologia dei deploy Git (GitHub App o webhook) di un’applicazione: commit, branch, risultato, durata e l’errore di un deploy fallito. | apps:read |
get_metrics_history | Cronologia di CPU e RAM di un’applicazione o di un database, con valore medio, di picco e più recente. 24 ore, oppure 7 giorni su Pro ed Enterprise (per un’applicazione, solo da 512 MB in su). | apps:read o databases:read |
start_application | Avvia un’applicazione arrestata. | apps:control |
stop_application | Arresta un’applicazione in esecuzione. | apps:control |
restart_application | Riavvia un’applicazione, applicando anche le modifiche a file e configurazione. | apps:control |
create_application | Crea e fa il deploy di una nuova applicazione a partire da un modello iniziale (Node.js, Python, sito statico, Go, Rust, Elixir, .NET, PHP o Ruby), facoltativamente con i tuoi primi file. | apps:write |
delete_application | Elimina un’applicazione, dopo aver fatto uno snapshot di sicurezza. | apps:write |
File e configurazione
| Tool | Cosa fa | Scope |
|---|---|---|
list_files | Elenca una cartella di un’applicazione. | files:read |
read_file | Legge un file di testo fino a 10 MB, pagina per pagina. | files:read |
search_files | Cerca un testo o un’espressione regolare nei file di un’applicazione, saltando node_modules, .git, l’output di build, i file di lock e i binari. | files:read |
create_file | Scrive un file con il suo contenuto completo (fino a 128 KB), creando le sue cartelle. Sostituisce un file già esistente. | files:write |
edit_file | Sostituisce il contenuto di un file esistente (fino a 128 KB). | files:write |
patch_file | Modifica un file fino a 10 MB con modifiche esatte di tipo trova e sostituisci. Se una modifica non trova corrispondenza, non viene scritto nulla. | files:write |
rename_file | Rinomina o sposta un file o una cartella. | files:write |
delete_file | Elimina un file o una cartella. Rifiuta la radice dell’applicazione, il file di configurazione e i file .env. | files:write |
edit_config_file | Modifica il file di configurazione campo per campo: nome visualizzato, descrizione, memoria, riavvio automatico, sottodominio, MAIN e START. | files:write |
MAIN e START al riavvio successivo.
Variabili d’ambiente
| Tool | Cosa fa | Scope |
|---|---|---|
list_env_vars | Elenca i nomi delle variabili d’ambiente di un’applicazione, mai i loro valori. | envs:read |
set_env_vars | Aggiunge, modifica o rimuove variabili in una sola chiamata, con un riavvio facoltativo. | envs:write (con restart, anche apps:control) |
Snapshot
| Tool | Cosa fa | Scope |
|---|---|---|
list_snapshots | Gli snapshot di un’applicazione o di un database, dal più recente. Senza indicare una risorsa, una panoramica dell’account, incluse le applicazioni eliminate di cui restano gli snapshot. | snapshots:read |
create_snapshot | Crea uno snapshot di un’applicazione o di un database. Conta nel limite giornaliero di snapshot del tuo piano. | snapshots:write |
restore_snapshot | Ripristina un’applicazione o un database esistente a uno snapshot, dopo aver fatto uno snapshot del suo stato attuale. | snapshots:write |
Database
| Tool | Cosa fa | Scope |
|---|---|---|
list_databases | Elenca i tuoi database (ID, nome, motore, RAM, host, porta, in esecuzione o meno). | databases:read |
create_database | Crea un database (piani Standard e superiori), operazione che richiede fino a circa 90 secondi. Con connect_to_app, scrive anche l’URL di connessione e il file del certificato in un’applicazione. | databases:write (con connect_to_app, anche databases:credentials ed envs:write) |
start_database | Avvia un database arrestato. | databases:write |
stop_database | Arresta un database in esecuzione. Le applicazioni che lo usano perdono la connessione finché non viene avviato di nuovo. | databases:write |
update_database | Modifica la RAM di un database, applicata a caldo. | databases:write |
connect_database | Collega un database esistente a un’applicazione: ruota la sua password, scrive il nuovo URL e il certificato nell’applicazione e aggiorna le altre applicazioni che lo usano. | databases:credentials ed envs:write |
rotate_database_credentials | Ruota la password o il certificato TLS di un database e indica le applicazioni che ha aggiornato. | databases:credentials |
delete_database | Elimina un database e i suoi dati, dopo aver fatto uno snapshot di sicurezza. | databases:write |
Domini e rete
I tool di rete funzionano sui siti web (applicazioni con un dominio), su finestre di tempo fino a 7 giorni.| Tool | Cosa fa | Scope |
|---|---|---|
list_account_domains | Tutti i domini di tutte le applicazioni: indirizzi squareweb.app e domini personalizzati, 100 per pagina. | apps:read |
list_dns_records | I record DNS da creare per il dominio personalizzato di un’applicazione, con il loro stato. | apps:read |
set_custom_domain | Collega, sostituisce o rimuove il dominio personalizzato di un’applicazione e restituisce i record DNS da creare. | apps:write |
purge_network_cache | Svuota la cache edge di un massimo di 50 applicazioni in una sola chiamata. | apps:write |
get_network_analytics | Traffico edge: richieste, visite e byte, con suddivisioni per paese, percorso, referrer, dispositivo e altro. | apps:read |
get_network_errors | Errori HTTP edge per codice di stato, percorso e metodo. 5xx per impostazione predefinita, 4xx su richiesta. | apps:read |
get_network_performance | Tempo al primo byte e tempo di risposta dell’origine (p50, p95, p99) e i percorsi più lenti. Pro ed Enterprise. | apps:read |
get_network_logs | Le 40 richieste edge più recenti, con indirizzi IP mascherati. Pro ed Enterprise. | apps:read |
Workspace
| Tool | Cosa fa | Scope |
|---|---|---|
list_workspaces | I workspace di cui sei proprietario o membro, con membri e applicazioni condivise. Sola lettura: gli altri tool raggiungono solo le tue applicazioni. | workspaces:manage |
Aiuto e stato
Questi tool richiedono solo lo scopemcp.
| Tool | Cosa fa | Scope |
|---|---|---|
get_platform_knowledge | La documentazione di riferimento di Square Cloud su limiti, piani, codici di errore e configurazione. | mcp |
search_help_center | Cerca nel centro assistenza o legge uno dei suoi articoli. | mcp |
list_help_center | Elenca tutti gli articoli del centro assistenza per categoria. | mcp |
get_platform_status | Lo stato dei servizi di Square Cloud e dei provider da cui dipendono. | mcp |
get_discord_status | Lo stato di Discord e la latenza della sua API, per distinguere un disservizio di Discord da un problema del bot. | mcp |
Esclusi di proposito
| Non disponibile | Perché | In alternativa |
|---|---|---|
| Download degli snapshot | Il link firmato contiene il tuo codice e le tue variabili d’ambiente, e finirebbe nella conversazione e presso il provider del modello AI. | Scaricalo dalla dashboard. |
| Download dei certificati dei database | Stesso motivo: il certificato uscirebbe da Square Cloud attraverso il modello. | Scaricalo dalla dashboard. |
| Attività dell’account | Mostra gli indirizzi IP e i dispositivi del tuo account. | Consulta il tuo feed delle attività. |