Connettere un assistente IA a SuperSaaS

SuperSaaS fornisce un server MCP (Model Context Protocol) che consente ad assistenti IA come Claude o ChatGPT di gestire il tuo calendario in linguaggio naturale: verificare la disponibilità, creare e spostare prenotazioni, cercare utenti e molto altro. L’assistente ha lo stesso accesso del tuo account, quindi tratta i dati di connessione come una password.

Cosa potrai fare

Dopo la configurazione, puoi fare domande e richieste al tuo assistente IA come:

“Quali appuntamenti ho domani?”
“Trova uno slot libero per una consulenza di 30 minuti la prossima settimana e prenotalo per jane@example.com”
“Quali prenotazioni sono cambiate da ieri?”
“Crea un nuovo utente con il nome jim@example.com e la password ‘secret’ e dagli 20 € di credito”

La maggior parte degli assistenti chiederà conferma prima di apportare modifiche importanti, ma ricorda che la connessione agisce con le autorizzazioni di amministratore.

Stai passando da un altro sistema di prenotazione? Gli appuntamenti esistenti non possono essere importati con la normale importazione CSV, che gestisce solo gli utenti, ma un assistente IA può farlo per te. Esporta gli appuntamenti dal vecchio sistema, consegna il file al tuo assistente e chiedigli di creare le prenotazioni nell’agenda SuperSaaS corrispondente. Prova prima con un piccolo gruppo e controlla il risultato prima di lasciargli importare il resto.

Scegli il tuo client

La maggior parte degli utenti dovrebbe connettersi tramite OAuth. Inserisci l’URL del server, accedi a SuperSaaS nel tuo browser e approva l’accesso.

Configurazione via web: ChatGPT e Claude
Configurazione da desktop o terminale: Claude Code, app desktop di ChatGPT e Codex, Visual Studio Code e altri client MCP

Per i client con OAuth, usa questo URL del server: https://www.supersaas.it/mcp

ChatGPT (versione web)

ChatGPT si connette inserendo l’URL del server e approvando la connessione in SuperSaaS. Aggiungi la connessione come plugin personale. La disponibilità della modalità sviluppatore dipende dal tuo account e dalle regole del tuo spazio di lavoro. I passaggi seguenti usano i nomi inglesi dei pulsanti e dei menu.

Vai su https://chatgpt.com per connetterti.
Apri Settings > Security and login e attiva la Developer mode.
Apri Plugins e scegli Create app. Nel modulo New Plugin, chiamalo “SuperSaaS” e inserisci “https://www.supersaas.it/mcp” nel campo MCP Server URL. La descrizione è facoltativa.
Lascia Authentication impostato su OAuth, leggi l’avviso, seleziona I understand and want to continue e clicca su Create. Quando ti connetti, si apre una pagina SuperSaaS nel browser; accedi e clicca su Approva per tornare a ChatGPT.
Trova SuperSaaS tra i tuoi plugin personali, aprilo e clicca sul pulsante più per installarlo.
Torna alla pagina iniziale di ChatGPT, passa da Chat a Work e avvia una nuova chat. Digita @ nella casella del messaggio e seleziona SuperSaaS per usarne gli strumenti.

Claude (app desktop e web)

Claude si connette a SuperSaaS come connettore personalizzato. Hai bisogno solo dell’URL del server; accedi a SuperSaaS nel tuo browser e approvi la connessione.

In Claude, apri Customize > Connectors (l’icona della cassetta degli attrezzi in fondo alla barra laterale), clicca sul pulsante + e scegli Add custom connector.
Inserisci un nome come “SuperSaaS” e incolla l’URL del tuo server (https://www.supersaas.it/mcp), poi clicca su Add.
Clicca su Connect. Si apre una pagina SuperSaaS nel browser; accedi con il tuo nome account e la password (se non hai già effettuato l’accesso) e clicca su Approva.
Torni a Claude. Attiva il connettore per una conversazione cliccando sul pulsante + nella casella della chat (o digitando /), passando il mouse su Connectors e attivando SuperSaaS. Gli strumenti SuperSaaS sono quindi disponibili in quella chat.

Con un piano Team o Enterprise il connettore viene aggiunto dal proprietario dello spazio di lavoro in Organization settings > Connectors; gli altri membri devono solo cliccare su Connect e accedere a SuperSaaS. Un account Claude gratuito può contenere un solo connettore personalizzato, i piani a pagamento ne consentono diversi. Una volta aggiunto il connettore nella versione web o nell’app desktop, funziona anche nelle app Claude per iOS e Android.

Configurazione manuale con un valore Authorization

Se il tuo client non supporta OAuth, o se preferisci la configurazione manuale, usa l’URL del server e un valore Authorization che inizia con Bearer …. Puoi trovare questo valore cliccando su Connettere un assistente IA, che aprirà la tua pagina Info account con una sezione aggiuntiva. Clicca su Mostra per vedere il codice Authorization.

Se in seguito clicchi su Rigenera chiave, il valore Authorization cambia e qualsiasi assistente connesso che lo utilizza smette di funzionare finché non lo aggiorni con il nuovo valore.

Claude Code (terminale, app desktop e IDE)

Anche Claude Code supporta OAuth, quindi non serve alcun valore Authorization. Aggiungi il server con questo comando:

claude mcp add --transport http supersaas https://www.supersaas.it/mcp

Poi digita /mcp in Claude Code, seleziona SuperSaaS e segui i passaggi nel browser per accedere e approvare l’accesso. Claude Code memorizza il token e lo rinnova automaticamente. Lo stesso comando funziona nel terminale, nell’app desktop di Claude Code e nelle estensioni per Visual Studio Code e JetBrains.

Per usare invece il valore Authorization della sezione sulla configurazione manuale qui sopra, passalo come intestazione:

claude mcp add --transport http supersaas https://www.supersaas.it/mcp \
  --header "Authorization: Bearer INCOLLA_IL_TUO_VALORE_QUI"

App desktop di ChatGPT e Codex

L’app desktop di ChatGPT permette di configurare MCP direttamente, incluso l’accesso tramite OAuth. Codex è il nome dell’ambiente di programmazione e del client per il terminale. Per connetterti tramite l’app desktop, con i nomi inglesi dei pulsanti e dei menu:

Passa a Codex nell’app desktop di ChatGPT, poi apri Settings.
Vai su Plugins, apri il menu Add e scegli Add MCP server. Se la tua versione ha una sezione MCP servers separata nelle impostazioni, apri quella sezione e clicca su Add server.
Chiama il server SuperSaaS, scegli Streamable HTTP e inserisci https://www.supersaas.it/mcp.
Salva il server e scegli Restart.
Apri la scheda MCPs in Settings > Plugins e scegli Authenticate per SuperSaaS. Accedi a SuperSaaS nel browser e clicca su Approva.
Avvia una nuova chat Codex locale e usa /mcp per verificare che il server SuperSaaS sia connesso.

L’app desktop, il client Codex per il terminale e l’estensione per IDE condividono la configurazione MCP sullo stesso computer. In alternativa a OAuth, puoi usare il valore Authorization della sezione sulla configurazione manuale qui sopra. Modifica ~/.codex/config.toml (crealo se non esiste) e aggiungi:

[mcp_servers.supersaas]
url = "https://www.supersaas.it/mcp"
http_headers = { "Authorization" = "Bearer INCOLLA_IL_TUO_VALORE_QUI" }

Riavvia Codex; gli strumenti SuperSaaS appariranno automaticamente. Nel terminale puoi verificare la connessione con codex mcp list, e all’interno di Codex puoi usare /mcp per ispezionare i server connessi.

Visual Studio Code (GitHub Copilot)

In VS Code, i server MCP sono utilizzati dalla chat di GitHub Copilot in modalità agente, quindi è richiesto un abbonamento Copilot (il livello gratuito funziona).

Apri il Command Palette (Ctrl/Cmd + Shift + P) ed esegui MCP: Add Server.
Scegli HTTP e inserisci l’URL del tuo server.
Quando si apre il file mcp.json, aggiungi la voce headers in modo che la definizione del server sia così:

{
  "servers": {
    "supersaas": {
      "type": "http",
      "url": "https://www.supersaas.it/mcp",
      "headers": {
        "Authorization": "Bearer INCOLLA_IL_TUO_VALORE_QUI"
      }
    }
  }
}

Apri il pannello chat di Copilot, passa il menu a discesa della modalità su Agent e clicca sull’icona degli strumenti per confermare che gli strumenti SuperSaaS siano elencati.

Altri client MCP (Cursor, Le Chat e altri)

Qualsiasi client che supporti server MCP remoti con intestazioni personalizzate funzionerà. Dove il client chiede i dettagli del server, usa:

Tipo / trasporto: Streamable HTTP
URL: l’URL del tuo server, ad es. https://www.supersaas.it/mcp
Intestazione: Authorization impostato sul tuo valore Authorization (inclusa la parola Bearer)

Per i client configurati con un file JSON (come il mcp.json di Cursor), l’equivalente è:

{
  "mcpServers": {
    "supersaas": {
      "url": "https://www.supersaas.it/mcp",
      "headers": {
        "Authorization": "Bearer INCOLLA_IL_TUO_VALORE_QUI"
      }
    }
  }
}