> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool MCP di Square Cloud

> I 49 tool del server MCP di Square Cloud per area, con lo scope richiesto da ciascuno.

Il server MCP ha 49 tool. Un client vede solo quelli coperti dagli [scope](https://docs.squarecloud.app/it/mcp/permissions-and-safety.md#scope) della sua chiave. I tool identificano un'applicazione tramite il suo ID, il nome esatto o l'hostname, e un database tramite il suo ID o nome. Ogni tool risponde in JSON con `ok`, un `summary` e, quando qualcosa è fallito o richiede il tuo intervento, un `code`.

Tutti i tool [vengono eseguiti subito](https://docs.squarecloud.app/it/mcp/permissions-and-safety.md#ogni-modifica-viene-eseguita-subito). L'eliminazione di un'applicazione o di un database e il ripristino di uno snapshot fanno prima uno [snapshot di sicurezza](https://docs.squarecloud.app/it/mcp/permissions-and-safety.md#eliminazioni-e-ripristini).

## 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` |
| `upload_application` | Crea e fa il deploy di una nuova applicazione a partire da uno zip di un progetto che hai già, inviato in base64 (fino a 1 MB). Il [file di configurazione](https://docs.squarecloud.app/it/getting-started/config-file.md) `squarecloud.app` deve trovarsi nella radice dello zip, non dentro una cartella. | `apps:write` |
| `commit_application` | Invia una nuova versione a un'applicazione esistente, come file di testo o come zip (fino a 1 MB), nella cartella che scegli (la radice per impostazione predefinita). I file con lo stesso nome vengono sostituiti e nient'altro viene eliminato. Non riavvia l'applicazione e, con `snapshot`, fa prima uno snapshot. | `files:write` (con `snapshot`, anche `snapshots: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](https://docs.squarecloud.app/it/getting-started/config-file.md) campo per campo: nome visualizzato, descrizione, memoria, riavvio automatico, sottodominio, `MAIN` e `START`. | `files:write` |

Le modifiche ai file hanno effetto al riavvio successivo. Nel file di configurazione, memoria e sottodominio si applicano subito, mentre `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` ed `envs:write` |
| `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 scope `mcp`.

| 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](https://help.squarecloud.app) 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à](https://squarecloud.app/it/dashboard/activity). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.