Een AI-assistent verbinden met SuperSaaS

SuperSaaS biedt een MCP-server (Model Context Protocol) waarmee AI-assistenten zoals Claude of ChatGPT uw agenda in gewone taal kunnen beheren: beschikbaarheid controleren, afspraken maken, gebruikers opzoeken en meer. De assistent heeft dezelfde toegang als uw account, dus behandel de verbindingsgegevens als een wachtwoord.

Wat u ermee kunt doen

Na de configuratie kunt u uw AI-assistent vragen en opdrachten geven zoals:

“Welke afspraken heb ik morgen?”
“Zoek volgende week een vrij tijdslot voor een consult van 30 minuten en boek het voor jan@example.com”
“Welke boekingen zijn sinds gisteren gewijzigd?”
“Maak een nieuwe gebruiker aan met de naam jim@example.com en wachtwoord ‘geheim’ en geef hem €20 tegoed”

De meeste assistenten vragen om bevestiging voordat ze iets belangrijks aanpassen, maar wees ervan bewust dat de assistent werkt met de rechten van de beheerder.

Stapt u over van een ander boekingssysteem? Bestaande afspraken kunt u niet importeren via de gewone import van een csv-bestand, die alleen gebruikers verwerkt, maar een AI-assistent kan dit voor u doen. Exporteer de afspraken uit uw oude systeem, geef het bestand aan uw assistent en vraag hem de boekingen in de juiste SuperSaaS-agenda aan te maken. Probeer eerst een klein aantal en controleer het resultaat voordat u de rest laat importeren.

Welke AI-assistent gebruikt u?

De meeste mensen kunnen de verbinding het makkelijkste maken via OAuth. U voert de URL van de server in (https://www.supersaas.com/mcp), logt in bij SuperSaaS in uw browser en keurt de toegang goed.

Configuratie via de browser: ChatGPT en Claude
Configuratie via desktop of terminal: Claude Code, ChatGPT-desktop-app en Codex, Visual Studio Code en andere MCP-clients

ChatGPT (webversie)

U laat ChatGPT verbinding maken door de URL van de server in te voeren en de verbinding in SuperSaaS goed te keuren. U voegt de verbinding toe als persoonlijke plug-in. De beschikbaarheid van de ontwikkelaarsmodus hangt af van uw account en het beleid van uw werkruimte. De onderstaande stappen gebruiken de Engelse namen van de knoppen en menu’s.

Ga naar https://chatgpt.com om verbinding te maken.
Open Settings > Security and login en schakel Developer mode in.
Open Plugins en kies Create app. Geef in het formulier New Plugin de naam “SuperSaaS” op en voer “https://www.supersaas.nl/mcp” in bij MCP Server URL. De beschrijving is optioneel.
Laat Authentication op OAuth staan, lees de melding, vink I understand and want to continue aan en klik op Create. Bij het verbinden opent een SuperSaaS-pagina in uw browser; log in en klik op Goedkeuren om terug te keren naar ChatGPT.
Zoek SuperSaaS bij uw persoonlijke plug-ins, open deze en klik op het plusje om de plug-in te installeren.
Ga terug naar de startpagina van ChatGPT, schakel van Chat naar Work en start een nieuwe chat. Typ @ in het chatvak en selecteer SuperSaaS om de tools te gebruiken.

Claude (desktop-app en webversie)

Claude maakt verbinding met SuperSaaS als custom connector. U voert de URL van de server in, u logt in bij SuperSaaS in uw browser en keurt de verbinding goed.

Open in Claude Customize > Connectors (het pictogram met de gereedschapskist onder in de zijbalk), klik op de knop + en kies Add custom connector.
Voer een naam in zoals “SuperSaaS” en plak de URL van de server (https://www.supersaas.nl/mcp), klik daarna op Add.
Klik op Connect. Er opent een SuperSaaS-pagina in uw browser; log in met uw accountnaam en wachtwoord (als u nog niet bent ingelogd) en klik op Goedkeuren.
U keert terug naar Claude. Zet de connector aan voor een gesprek door op de knop + in het chatvak te klikken (of door / te typen), de muis boven Connectors te houden en SuperSaaS aan te zetten. De SuperSaaS-tools zijn dan beschikbaar in dat gesprek.

Bij een Team- of Enterprise-abonnement wordt de connector toegevoegd door de eigenaar van de werkruimte onder Organization settings > Connectors; de overige leden hoeven alleen op Connect te klikken en in te loggen bij SuperSaaS. Een gratis Claude-account kan één custom connector bevatten, de betaalde abonnementen staan er meerdere toe. Zodra de connector via de webversie of de desktop-app is toegevoegd, werkt deze ook in de Claude-apps voor iOS en Android.

Handmatige configuratie met een Authorization-waarde

Als uw client geen OAuth ondersteunt of u liever handmatig configureert, gebruikt u de URL van de server en een Authorization-waarde die begint met Bearer …. U vindt deze waarde door te klikken op AI-assistent verbinden. Hiermee opent u de pagina Accountbeheer met een extra sectie. Klik op Tonen om de Authorization-code te zien.

Als u later op Opnieuw genereren klikt, verandert de Authorization-waarde en werkt elke verbonden assistent die deze gebruikt niet meer totdat u deze bijwerkt.

Claude Code (terminal, desktop-app en ontwikkelomgeving)

Claude Code ondersteunt ook OAuth, zodat u geen Authorization-waarde nodig hebt. Voeg de server toe met deze opdracht:

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

Typ daarna /mcp in Claude Code, kies SuperSaaS en volg de stappen in uw browser om in te loggen en de toegang goed te keuren. Claude Code bewaart de toegangscode en vernieuwt deze automatisch. Dezelfde opdracht werkt in de terminal, in de desktop-app van Claude Code en in de uitbreidingen voor Visual Studio Code en JetBrains.

Wilt u in plaats daarvan de Authorization-waarde uit de sectie over handmatige configuratie hierboven gebruiken, geef die dan mee als header:

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

ChatGPT-desktop-app en Codex

De ChatGPT-desktop-app ondersteunt het rechtstreeks instellen van MCP, inclusief inloggen via OAuth. Codex is de naam voor de programmeeromgeving en de toepassing in de terminal. Zo maakt u verbinding via de desktop-app, met de Engelse namen van de knoppen en menu’s:

Schakel naar Codex in de ChatGPT-desktop-app en open Settings.
Ga naar Plugins, open het menu Add en kies Add MCP server. Heeft uw versie een aparte sectie MCP servers in de instellingen, open dan die sectie en klik op Add server.
Noem de server SuperSaaS, kies Streamable HTTP en voer https://www.supersaas.nl/mcp in.
Sla de server op en kies Restart.
Open het tabblad MCPs onder Settings > Plugins en kies Authenticate bij SuperSaaS. Log in bij SuperSaaS in uw browser en klik op Goedkeuren.
Start een nieuwe lokale Codex-chat en controleer met /mcp of de SuperSaaS-server verbonden is.

De desktop-app, Codex in de terminal en de uitbreiding voor uw ontwikkelomgeving delen de instellingen voor MCP op dezelfde computer. Als alternatief voor OAuth kunt u de Authorization-waarde uit de sectie over handmatige configuratie hierboven gebruiken. Bewerk ~/.codex/config.toml (maak het bestand aan als het nog niet bestaat) en voeg toe:

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

Start Codex daarna opnieuw; de SuperSaaS-tools verschijnen automatisch. In de terminal kunt u de verbinding controleren met codex mcp list en binnen Codex kunt u /mcp gebruiken om verbonden servers te inspecteren.

Visual Studio Code (GitHub Copilot)

In VS Code worden MCP-servers gebruikt door de chat van GitHub Copilot in agent mode, dus een Copilot-abonnement is vereist (de gratis versie werkt ook).

Open het Command Palette (Ctrl/Cmd + Shift + P) en voer MCP: Add Server uit.
Kies HTTP en voer uw Server URL in.
Wanneer het bestand mcp.json wordt geopend, voegt u de vermelding headers toe zodat de serverdefinitie er zo uitziet:

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

Open het Copilot-chatpaneel, zet het keuzemenu voor de modus op Agent en klik op het toolspictogram om te controleren of de SuperSaaS-tools worden vermeld.

Andere MCP-clients (Cursor, Le Chat en meer)

Elke client die externe MCP-servers met aangepaste headers ondersteunt, werkt. Gebruik het volgende wanneer de client om servergegevens vraagt:

Type / transport: Streamable HTTP
URL: uw Server URL, bijvoorbeeld https://www.supersaas.nl/mcp
Header: Authorization ingesteld op uw Authorization-waarde (inclusief het woord Bearer)

Voor clients die met een JSON-bestand worden geconfigureerd (zoals mcp.json van Cursor), is het equivalent:

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