Collegare un client AI al server MCP di Square Cloud

Tutti i client usano lo stesso indirizzo, https://mcp.squarecloud.app/mcp. Il modo in cui accedono dipende dal client:

Client	Come si connette
Claude (claude.ai e le app di Claude)	OAuth: incolla l’indirizzo e autorizza su Square Cloud
ChatGPT	OAuth: incolla l’indirizzo e autorizza su Square Cloud
Claude Code	Chiave API nell’header `Authorization`
VS Code	Chiave API nell’header `Authorization`
Cursor	Chiave API nell’header `Authorization`
Altri client	Chiave API nell’header `Authorization`

In entrambi i casi, il tuo account ha bisogno di un piano attivo.

Claude

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.

Inserisci l'indirizzo

Chiamalo Square Cloud, inserisci https://mcp.squarecloud.app/mcp e fai clic su Continue.

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.

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.

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

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.

Inserisci l'indirizzo

Chiamalo Square Cloud, scegli l’endpoint pubblico come connessione e inserisci https://mcp.squarecloud.app/mcp. Scegli OAuth come autenticazione.

Crealo

Leggi l’avviso, seleziona I understand and want to continue e poi Create as a plugin.

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.

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

Claude Code si connette con una chiave API in un header, non con OAuth. Salva la chiave nella variabile d’ambiente SQUARECLOUD_API_KEY ed esegui:

claude mcp add --transport http squarecloud https://mcp.squarecloud.app/mcp \
  --header "Authorization: Bearer $SQUARECLOUD_API_KEY"

La tua shell inserisce la chiave quando esegui il comando, e Claude Code la salva nella propria configurazione. Per condividere il server con un progetto senza condividere la chiave, aggiungilo invece al file .mcp.json del progetto; Claude Code legge la variabile a ogni avvio:

.mcp.json

{
  "mcpServers": {
    "squarecloud": {
      "type": "http",
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${SQUARECLOUD_API_KEY}"
      }
    }
  }
}

Verifica la connessione con 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

{
  "inputs": [
    {
      "type": "promptString",
      "id": "squarecloud-api-key",
      "description": "Square Cloud API key",
      "password": true
    }
  ],
  "servers": {
    "squarecloud": {
      "type": "http",
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${input:squarecloud-api-key}"
      }
    }
  }
}

VS Code chiede la chiave API all’avvio del server, quindi la chiave non resta mai nel file. Avvia, arresta o riavvia il server con MCP: List Servers.

Questo server è separato dall’estensione Square Cloud per VS Code, che gestisce le tue applicazioni dalla barra laterale. Puoi usarli entrambi.

Cursor

Aggiungi il server a .cursor/mcp.json nel tuo progetto, oppure a ~/.cursor/mcp.json per tutti i progetti:

.cursor/mcp.json

{
  "mcpServers": {
    "squarecloud": {
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SQUARECLOUD_API_KEY}"
      }
    }
  }
}

Imposta 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’indirizzo https://mcp.squarecloud.app/mcp e invia la chiave API nell’header Authorization. Il prefisso Bearer è facoltativo.

Authorization: Bearer <your API key>

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:read e databases:read.
Per limitare il client ad alcune applicazioni e database, limita la chiave a quelle risorse. Vedi Chiavi limitate.

Il segreto viene mostrato una sola volta. Conservalo in una variabile d’ambiente o nell’archivio dei segreti del tuo client, mai in una chat o in un file di cui fai il commit. Le chiavi che crei non scadono: revoca la chiave quando smetti di usarla. Un account può avere fino a 10 chiavi.

Quanto dura una connessione

Claude e ChatGPT (OAuth). L’autorizzazione crea una chiave API per quel client, con il suo nome (Claude o ChatGPT):

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 Claude e una connessione ChatGPT, quindi collegare un secondo account Claude disconnette il primo.

Per mantenere più connessioni contemporaneamente, dai a ogni connessione aggiuntiva una chiave API propria. In Claude, anche un connettore personalizzato può inviare una chiave API: scegli No sign in in Authentication e aggiungi l’header 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 chiave Claude o ChatGPT 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.

CLI

VS Code

MCP

SDKs

Collegare un client AI al server MCP di Square Cloud

Claude

ChatGPT

Claude Code

VS Code

Cursor

Altri client

Crea una chiave API

Quanto dura una connessione

Disconnettere

​Claude

​ChatGPT

​Claude Code

​VS Code

​Cursor

​Altri client

​Crea una chiave API

​Quanto dura una connessione

​Disconnettere

Claude

ChatGPT

Claude Code

VS Code

Cursor

Altri client

Crea una chiave API

Quanto dura una connessione

Disconnettere