> ## 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.

# Server MCP di Square Cloud

> Collega Claude, ChatGPT, Claude Code, VS Code o Cursor al tuo account Square Cloud con il server MCP remoto e gestisci applicazioni e database dalla chat.

Il server MCP di Square Cloud permette a un client AI di lavorare sul tuo account tramite il [Model Context Protocol](https://modelcontextprotocol.io). Chiedi a parole semplici e il client chiama i [tool](https://docs.squarecloud.app/it/mcp/tools.md) al posto tuo: controlla stato, log, metriche e traffico edge, legge e modifica file, gestisce le variabili d'ambiente, avvia e riavvia applicazioni, crea applicazioni, database e snapshot, e molto altro.

* **Remoto, niente da installare:** un solo indirizzo HTTPS per tutti i client.
* **Due modi per connettersi:** Claude e ChatGPT accedono con OAuth su una pagina di consenso di Square Cloud. Claude Code, VS Code, Cursor e gli altri client inviano una chiave API.
* **Decidono i tuoi permessi:** una connessione vede solo i tool coperti dai suoi scope, e una chiave limitata ad alcune applicazioni e database raggiunge solo quelli.
* **Il tuo client chiede, i tuoi dati restano al sicuro:** la richiesta di permesso del tuo client decide quali modifiche vengono eseguite, e l'eliminazione di un'applicazione o di un database o il ripristino di uno snapshot fanno prima uno snapshot di sicurezza.

## Endpoint

```text theme={"system"}
https://mcp.squarecloud.app/mcp
```

Questo è l'unico indirizzo del server MCP. Su `api.squarecloud.app` o su qualsiasi altro indirizzo di Square Cloud, le richieste MCP rispondono `421 WRONG_HOST` con l'indirizzo corretto. Al contrario, `mcp.squarecloud.app` serve solo il server MCP, mai la REST API.

## Requisiti

* **Un [piano](https://docs.squarecloud.app/it/platform/plans.md) attivo.** Il server MCP fa parte di tutti i piani di Square Cloud, da Hobby in su. Senza un piano attivo, ogni richiesta risponde `403 UPGRADE_REQUIRED`. Se il tuo piano scade, le tue connessioni vengono mantenute e tornano a funzionare non appena il piano viene rinnovato.
* **Un client MCP che supporti i server remoti** su Streamable HTTP, come Claude, ChatGPT, Claude Code, VS Code o Cursor. Vedi [Collegare un client](https://docs.squarecloud.app/it/mcp/connect.md).

## Protocollo

| Argomento | Dettagli |
| - | - |
| Trasporto | Streamable HTTP, solo `POST`. Il server non mantiene sessioni, e `GET` risponde `405`. |
| Versioni del protocollo | `2026-07-28`, `2025-11-25`, `2025-06-18` e `2025-03-26`. I client della revisione `2026-07-28` chiamano senza handshake; i client più vecchi iniziano con `initialize`. Una richiesta senza `MCP-Protocol-Version` viene letta come `2025-03-26`, e una versione non supportata risponde `400` con l'elenco di quelle supportate. |
| Capacità | Solo tool, niente risorse né prompt. |
| Risultati | Ogni tool risponde con un oggetto JSON in un blocco di testo, con `ok`, un `summary` e, quando qualcosa è fallito o richiede il tuo intervento, un `code`. |
| Chiamate lunghe | Una chiamata che richiede più di qualche secondo riceve la risposta come stream (SSE) con keepalive. Chiudere la connessione annulla la chiamata, e nessuna chiamata dura più di 3 minuti. |

## Cosa resta fuori dall'MCP

* **I progetti oltre 1 MB.** Il client può inviare un progetto dal tuo computer come zip fino a 1 MB, con `upload_application` per una nuova applicazione o `commit_application` per una nuova versione, e file di testo con `create_application` e `commit_application`. Per un progetto più grande, usa la [CLI](https://docs.squarecloud.app/it/cli-reference/deploy.md), l'[estensione per VS Code](https://docs.squarecloud.app/it/vscode-extension/features.md) o i [deploy da GitHub](https://docs.squarecloud.app/it/cli-reference/github-deploys.md).
* **Il download di snapshot e certificati dei database.** Il link di download firmato finirebbe nella conversazione e presso il provider del modello AI. Scaricali dalla dashboard.
* **L'attività dell'account.** Mostra gli indirizzi IP e i dispositivi del tuo account, quindi resta nella dashboard.
* **I valori segreti.** I valori delle variabili d'ambiente, i file `.env` e le chiavi private non arrivano mai al client AI. Vedi [Segreti](https://docs.squarecloud.app/it/mcp/permissions-and-safety.md#segreti).
* **Impostazioni dell'account, fatturazione, chiavi API e membri dei workspace.** Si gestiscono nella dashboard.

## Prossimi passi

> [card] [Collegare un client](https://docs.squarecloud.app/it/mcp/connect.md)
>
> Configura Claude, ChatGPT, Claude Code, VS Code o Cursor.

> [card] [Permessi e sicurezza](https://docs.squarecloud.app/it/mcp/permissions-and-safety.md)
>
> Scope, chiavi limitate e snapshot di sicurezza.

> [card] [Tool](https://docs.squarecloud.app/it/mcp/tools.md)
>
> Tutti i tool e lo scope che richiedono.

> [card] [Limiti ed errori](https://docs.squarecloud.app/it/mcp/limits-and-errors.md)
>
> I limiti delle richieste e dei tool, e cosa significa ogni errore.


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