https://mcp.squarecloud.app/mcp. Il modo in cui accedono dipende dal client:
In entrambi i casi, il tuo account ha bisogno di un piano attivo.
Claude
1
Aggiungi un connettore personalizzato
In Claude, apri Customize > Connectors, fai clic su + Add e poi su Add custom connector. Nei piani Team ed Enterprise, un Owner lo aggiunge prima in Organization settings > Connectors (Add > Custom > Web), e poi ogni membro lo collega da Customize > Connectors.
2
Inserisci l'indirizzo
Chiamalo
Square Cloud, inserisci https://mcp.squarecloud.app/mcp e fai clic su Continue.3
Mantieni l'identità di Claude
Mantieni un’opzione di accesso (Sign in now o Sign in when needed) e, come client OAuth, Use Claude’s published identity (Recommended). Lascia vuoto Request headers e fai clic su Add.
4
Autorizza su Square Cloud
Claude apre una pagina di Square Cloud. Accedi se necessario, controlla i permessi che Claude richiede e fai clic per autorizzare. Puoi deselezionare dei permessi per dare a Claude meno accesso;
mcp resta sempre, perché è ciò che stabilisce la connessione.5
Usalo in una chat
Tornato in Claude, fai clic su + nella casella della chat, apri Connectors e attiva Square Cloud.
Square Cloud accetta solo l’identità pubblicata di Claude. Register automatically e Use your own OAuth client non funzionano con Square Cloud.
ChatGPT
1
Aggiungi un server MCP personalizzato
Apri ChatGPT Plugins, seleziona + e poi Add custom MCP server. A seconda del tuo piano ChatGPT, un amministratore del workspace potrebbe dover prima consentire i server MCP personalizzati.
2
Inserisci l'indirizzo
Chiamalo
Square Cloud, scegli l’endpoint pubblico come connessione e inserisci https://mcp.squarecloud.app/mcp. Scegli OAuth come autenticazione.3
Crealo
Leggi l’avviso, seleziona I understand and want to continue e poi Create as a plugin.
4
Autorizza su Square Cloud
Quando ChatGPT ti chiede di accedere, apre una pagina di Square Cloud. Accedi se necessario, controlla i permessi e fai clic per autorizzare. Puoi deselezionare dei permessi;
mcp resta sempre.5
Usalo in una chat
Inizia una nuova conversazione, digita
@ e scegli Square Cloud.ChatGPT cambia di tanto in tanto i nomi di questi menu. Se sono diversi, segui la guida di OpenAI per collegare un server MCP.
Claude Code
Aggiungi il server:/mcp dentro Claude Code, scegli squarecloud e seleziona Authenticate. Il browser apre la pagina di consenso di Square Cloud: controlla i permessi e fai clic per autorizzare. Funziona allo stesso modo nel terminale e nell’estensione di VS Code.
Con una chiave API
Su una macchina senza browser, o per collegare Claude Code su più di una macchina (vedi Quanto dura una connessione), invia invece una chiave API in un header. Salva la chiave nella variabile d’ambienteSQUARECLOUD_API_KEY ed esegui:
.mcp.json del progetto; Claude Code legge la variabile a ogni avvio:
.mcp.json
claude mcp list, oppure con /mcp dentro Claude Code.
VS Code
Aggiungi il server a.vscode/mcp.json nel tuo progetto, oppure alla tua configurazione utente con MCP: Open User Configuration dal riquadro comandi:
.vscode/mcp.json
Cursor
Aggiungi il server a.cursor/mcp.json nel tuo progetto, oppure a ~/.cursor/mcp.json per tutti i progetti:
.cursor/mcp.json
SQUARECLOUD_API_KEY nel tuo ambiente prima di aprire Cursor. Attiva il server nel menu Customize di Cursor; se non si connette, il canale MCP Logs del pannello Output ne mostra il motivo.
Altri client
Qualsiasi client che supporti i server MCP remoti su Streamable HTTP con un header personalizzato funziona allo stesso modo: usa l’indirizzohttps://mcp.squarecloud.app/mcp e invia la chiave API nell’header Authorization. Il prefisso Bearer è facoltativo.
Crea una chiave API
Crea la chiave nelle impostazioni di sicurezza del tuo account:- Assegnale lo scope
mcp, più gli scope dei tool che vuoi far usare al client. Funziona anche una chiave con accesso completo. Vedi Scope. - Per un accesso in sola lettura, scegli
mcp,apps:read,files:read,envs:read,snapshots:readedatabases:read. - Per limitare il client ad alcune applicazioni e database, limita la chiave a quelle risorse. Vedi Chiavi limitate.
Quanto dura una connessione
Claude, ChatGPT e Claude Code (OAuth). L’autorizzazione crea una chiave API per quel client, con il suo nome (Claude, ChatGPT o Claude Code):
- Dura 90 giorni e non ha un refresh token. Quando scade, il client ti chiede di accedere e autorizzare di nuovo.
- Funziona solo sul server MCP. Sulla REST API risponde
403 MISSING_SCOPE. - Collegare di nuovo lo stesso client revoca la sua chiave precedente. Ogni account mantiene una connessione per client, quindi collegare un secondo account Claude, o Claude Code su una seconda macchina, disconnette la prima connessione.
Authorization in Request headers. Nei piani Team ed Enterprise, tutti quelli che usano quel connettore condividono l’accesso della chiave.
Le chiavi API che crei non scadono. Qualunque sia il modo di accesso, tutte le connessioni MCP di un account condividono gli stessi limiti.
Disconnettere
Revoca la chiave nelle impostazioni di sicurezza del tuo account: la chiaveClaude, ChatGPT o Claude Code per una connessione OAuth, oppure la chiave che hai creato. L’accesso termina alla richiesta successiva del client. Rimuovere il connettore o il server nel client gli impedisce di fare chiamate, ma solo la revoca della chiave su Square Cloud la invalida.
