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 jane@example.com”
“Welke boekingen zijn sinds gisteren gewijzigd?”
“Maak een nieuwe gebruiker aan met de naam jim@example en wachtwoord ‘secret’ 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.

Welke AI-assistent gebruikt u?

De meeste mensen kunnen de verbinding het makkelijkste maken via OAuth. U voert de Server URL in, logt in bij SuperSaaS in uw browser en keurt de toegang goed.

Clients met OAuth: ChatGPT en Claude
Andere clients: Claude Code, Codex, Visual Studio Code en andere MCP-clients

Gebruik voor clients met OAuth deze Server URL: https://www.supersaas.nl/mcp

ChatGPT

ChatGPT maakt verbinding door de Server URL in te voeren en de verbinding in SuperSaaS goed te keuren. ChatGPT vereist een betaald abonnement (Plus, Pro of Business) voor aangepaste connectors.

Ga naar https://chatgpt.com om verbinding te maken. Gebruik de webversie; de mobiele en desktop-app van ChatGPT hebben nog geen MCP-optie, maar na het verbinden kunt u de tools wel vanuit de app gebruiken.
Open Settings > Apps, scrol naar Advanced settings en schakel Developer mode in.
Ga terug naar Apps, kies Create app, noem deze “SuperSaaS” en voer “https://www.supersaas.nl/mcp” in als verbinding.
Kies onder Authentication voor OAuth, vink het vakje ter bevestiging aan en rond het aanmaken van de connector af. Bij het verbinden opent een SuperSaaS-pagina in uw browser; log in en klik op Goedkeuren om terug te keren naar ChatGPT met de tools beschikbaar.

Claude (desktop-app en webversie)

Claude maakt verbinding met SuperSaaS als aangepaste connector. U hebt alleen de Server URL nodig; u logt in bij SuperSaaS in uw browser en keurt de verbinding goed.

Open in Claude Settings > Connectors en klik op Add custom connector.
Voer een naam in zoals “SuperSaaS” en plak uw Server URL (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, waar de SuperSaaS-tools nu worden vermeld onder het toolspictogram in het chatvak.

Handmatige configuratie voor clients zonder OAuth

Sommige clients ondersteunen de browserlogin nog niet. Deze clients hebben de Server URL nodig 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)

Voer deze ene opdracht uit en vervang de tijdelijke aanduiding door uw Authorization-waarde:

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

Codex

De eenvoudigste manier is via de Codex-app:

Open Settings in Codex.
Ga naar MCP servers en klik op Add.
Kies een externe/HTTP-server en voer uw Server URL in.
Voeg een HTTP-header toe met de naam Authorization en uw Authorization-waarde (inclusief het woord Bearer).
Sla de server op en start een nieuwe Codex-chat. De SuperSaaS-tools zouden in die chat beschikbaar moeten zijn.

Als u liever de terminal gebruikt of Codex handmatig wilt configureren, bewerk dan ~/.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"
      }
    }
  }
}