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

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.

Client con OAuth: ChatGPT e Claude
Altri client: Claude Code, Codex, Visual Studio Code e altri client MCP

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

ChatGPT

ChatGPT si connette inserendo l’URL del server e approvando la connessione in SuperSaaS. ChatGPT richiede un piano a pagamento (Plus, Pro o Business) per i connettori personalizzati.

Vai su https://chatgpt.com per connetterti. Usa la versione web; l’app mobile e quella desktop di ChatGPT non hanno ancora un’opzione MCP, ma una volta connesso puoi utilizzare gli strumenti dall’app.
Apri Settings > Apps, scorri fino a Advanced settings e attiva la Developer mode.
Di nuovo in Apps, scegli Create app, chiamala “SuperSaaS” e sotto la connessione inserisci “https://www.supersaas.it/mcp”.
Sotto Authentication, assicurati che OAuth sia selezionato, spunta la casella di conferma e completa la creazione del connettore. Quando ti connetti, si apre una pagina SuperSaaS nel browser; accedi e clicca su Approva per tornare a ChatGPT con gli strumenti disponibili.

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 Settings > Connectors e clicca su 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, che ora elenca gli strumenti SuperSaaS sotto l’icona degli strumenti nella casella della chat.

Configurazione manuale per client senza OAuth

Alcuni client non supportano ancora il flusso di accesso tramite browser. Questi client hanno bisogno dell’URL del server e di 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)

Esegui questo unico comando, sostituendo il segnaposto con il tuo valore Authorization:

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

Codex

Il modo più semplice è tramite l’app Codex:

Apri Settings in Codex.
Vai su MCP servers e clicca su Add.
Scegli un server remoto/HTTP e inserisci l’URL del tuo server.
Aggiungi un’intestazione HTTP chiamata Authorization con il tuo valore Authorization (inclusa la parola Bearer).
Salva il server e avvia una nuova chat Codex. Gli strumenti SuperSaaS dovrebbero essere disponibili in quella chat.

Se preferisci il terminale o vuoi configurare Codex manualmente, 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"
      }
    }
  }
}