Vai al contenuto principale
Il server MCP di Square Cloud permette a un client AI di lavorare sul tuo account tramite il Model Context Protocol. Chiedi a parole semplici e il client chiama i tool 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

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

​
Protocollo

​
Cosa resta fuori dall’MCP

  • Il deploy di una cartella dal tuo computer. L’MCP lavora su ciò che è già su Square Cloud. Carica un progetto con la CLI, l’estensione per VS Code o i deploy da GitHub.
  • 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.
  • Impostazioni dell’account, fatturazione, chiavi API e membri dei workspace. Si gestiscono nella dashboard.

​
Prossimi passi

Collegare un client

Configura Claude, ChatGPT, Claude Code, VS Code o Cursor.

Permessi e sicurezza

Scope, chiavi limitate e snapshot di sicurezza.

Tool

Tutti i tool e lo scope che richiedono.

Limiti ed errori

I limiti delle richieste e dei tool, e cosa significa ogni errore.