> ## 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. # Collegare un client AI al server MCP di Square Cloud > Collega Claude e ChatGPT con OAuth, oppure Claude Code, VS Code e Cursor con una chiave API, al server MCP di Square Cloud, e scopri quanto dura una connessione. 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) (claude.ai e le app di Claude) | OAuth: incolla l'indirizzo e autorizza su Square Cloud | | [ChatGPT](#chatgpt) | OAuth: incolla l'indirizzo e autorizza su Square Cloud | | [Claude Code](#claude-code) | [Chiave API](#crea-una-chiave-api) nell'header `Authorization` | | [VS Code](#vs-code) | [Chiave API](#crea-una-chiave-api) nell'header `Authorization` | | [Cursor](#cursor) | [Chiave API](#crea-una-chiave-api) nell'header `Authorization` | | [Altri client](#altri-client) | [Chiave API](#crea-una-chiave-api) nell'header `Authorization` | In entrambi i casi, il tuo account ha bisogno di un [piano](https://docs.squarecloud.app/it/platform/plans.md) 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**. > [!NOTE] > > 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](https://chatgpt.com/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**. > [!NOTE] > > ChatGPT cambia di tanto in tanto i nomi di questi menu. Se sono diversi, segui la [guida di OpenAI per collegare un server MCP](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt). ## Claude Code Claude Code si connette con una [chiave API](#crea-una-chiave-api) in un header, non con OAuth. Salva la chiave nella variabile d'ambiente `SQUARECLOUD_API_KEY` ed esegui: ```bash theme={"system"} 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: ```json .mcp.json theme={"system"} { "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: ```json .vscode/mcp.json theme={"system"} { "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](#crea-una-chiave-api) all'avvio del server, quindi la chiave non resta mai nel file. Avvia, arresta o riavvia il server con **MCP: List Servers**. > [!TIP] > > Questo server è separato dall'[estensione Square Cloud per VS Code](https://docs.squarecloud.app/it/vscode-extension/installation.md), 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: ```json .cursor/mcp.json theme={"system"} { "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. ```http theme={"system"} Authorization: Bearer ``` ## Crea una chiave API Crea la chiave nelle [impostazioni di sicurezza del tuo account](https://squarecloud.app/it/account/security): * **Assegnale lo scope `mcp`**, più gli scope dei tool che vuoi far usare al client. Funziona anche una chiave con accesso completo. Vedi [Scope](https://docs.squarecloud.app/it/mcp/permissions-and-safety.md#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](https://docs.squarecloud.app/it/mcp/permissions-and-safety.md#chiavi-limitate-ad-applicazioni-e-database). 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](https://docs.squarecloud.app/it/mcp/limits-and-errors.md). ## Disconnettere Revoca la chiave nelle [impostazioni di sicurezza del tuo account](https://squarecloud.app/it/account/security): 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.