Verbinde einen KI Assistenten mit SuperSaaS

SuperSaaS bietet einen MCP (Model Context Protocol) Server, damit KI-Assistenten, wie Claude oder ChatGPT, Deinen Terminbuchungskalender in natürlicher Sprache verwalten können: Verfügbarkeit prüfen, Termine erstellen und verschieben, Benutzer suchen und vieles mehr. Der Assistent verfügt über denselben Zugriff wie Dein Konto; behandele die Anmeldedaten daher wie ein Passwort.

Was Du damit tun kannst

Nach der Einrichtung kannst Du Deinem KI-Assistenten Fragen stellen und ihm Aufgaben geben, wie zum Beispiel:

„Welche Termine habe ich morgen?“
„Suche nächste Woche einen freien Termin für eine 30-minütige Beratung und buche diesen für jane@example.com.“
„Welche Buchungen haben sich seit gestern geändert?“
„Erstelle einen neuen Benutzer mit dem Namen ‚jim@example.com‘ und dem Passwort ‚secret‘ und gib ihm ein Guthaben von 20 €.“

Die meisten Assistenten bitten vor wichtigen Änderungen um Bestätigung, aber denke daran, dass die Verbindung mit Deinen Rechten als Administrator agiert.

Wähle Deinen Clienten

Die meisten Leute sollten eine Verbindung herstellen mit OAuth. Gib die Server-URL ein, melde Dich in Deinem Browser bei SuperSaaS an und genehmige den Zugriff.

Clients mit OAuth: ChatGPT und Claude
Andere Clients: Claude Code, Codex, Visual Studio Code, und andere MCP Clients

Für Clients mit OAuth verwende diese Server URL: https://www.supersaas.de/mcp

ChatGPT

Die Verbindung zu ChatGPT wird hergestellt, indem die Server-URL eingegeben und die Verbindung in SuperSaaS bestätigt wird. Dafür ist ChatGPT mit einem kostenpflichtigen Tarif (Plus, Pro oder Business) erforderlich.

Gehe zu https://chatgpt.com, um eine Verbindung herzustellen. Nutze dafür die Webversion – in der ChatGPT-App für Mobilgeräte oder den Desktop gibt es noch keine MCP-Option, aber sobald Du Dich angemeldet hast, kannst Du diese Funktion über die App nutzen.
Öffne Settings > Apps (Einstellungen > Apps), scrolle zu Erweiterte Einstellungen und aktiviere den Entwickler modus
Zurück in Apps, wähle Create app (App erstellen), nenne sie „SuperSaaS“, und unter Verbindung (connection) gib die folgende URL ein „https://www.supersaas.de/mcp“
Unter Authentication (Authentifizierung), stelle sicher, dass OAuth ausgewählt ist, aktiviere die Box zur Bestätigungs und beende die Erstellung für diese Verbindung. Wenn Du die Verbindung herstellst, öffnet sich eine SuperSaaS-Seite in Deinem Browser; melde Dich an und klicke auf Approve (Genehmigen), um mit den verfügbaren Tools zu ChatGPT zurückzukehren.

Claude (Desktop- und Web-App)

Nutze die bezahlte Version von Claude, damit der „benutzerdefinierte Connektor“ (custom connector) eine Verbindung zu SuperSaaS herstellt. Diese benötigt die Server-URL; melde Dich in Deinem Browser bei SuperSaaS an und genehmige die Verbindung.

In Claude, klicke ganz unten auf Deinen Benutzer und öffne dort die Einstellungen
Aktiviere unter Einstellungen > Fähigkeiten den MPC-Server von SuperSaaS.
Aktiviere unter Einstellungen > Konnektoren den benutzerdefinierten Konnector.
Gib oben einen Namen ein, wie „SuperSaaS“ und gib die Server URL (https://www.supersaas.de/mcp) ein und klicke dann auf unten den Button „Hinzufügen“, um SuperSaaS zu den Konnektoren hinzuzufügen.
Verbinde die KI Claude mit SuperSaaS.
Anschließend wirst Du zu SuperSaaS weitergeleitet und meldest Dich dort in Deinem SuperSaaS-Konto an; logge Dich mit Deinem Konto-Namen und Passwort ein (wenn Du nicht bereits eingeloggt bist). Daraufhin gibst Du den Zugang zum SuperSaaS-Konto frei.
Zum Schluss aktivierst Du die Tool-Berechtigungen, indem Du bei allen Berechtigungen auf das Häkchen klickst und damit alle diese Berechtigungen in der Verbindung erlaubst.
Und damit hast Du Claude erfolgreich mit SuperSaaS verbunden und wirst bei Claude willkommen geheißen. Und Du kannst dann sofort loslegen und Claude im Chat Aufgeben stellen, die in SuperSaaS ausgeführt werden.
Bei Claude findest Du SuperSaaS nun auch mit Klick auf das Plus-Zeichen im Chat-Feld unter „Konnektoren“, wo Du SuperSaaS aktivieren oder deaktivieren kannst.

Manuelle Einrichtung für Clients ohne OAuth

Einige Clients unterstützen den Anmeldeprozess über den Browser noch nicht. Diese Clients benötigen die Server-URL und einen Authorization value (Autorisierungs-Wert), der mit dem Code Bearer … beginnt. Diesen Wert kannst Du finden, indem Du unter Dashboard im Menü zu „Integrationen“ gehst und dort auf KI-Assistenten verbinden klickst, womit Deine Kontoinfos Seite einen zusätzlichen Bereich erhält. Klicke Zeigen um den Autorisierungscode sehen zu können.

Wenn Du später auf Schlüsselrolle (Roll key) klickst, ändert sich der Wert der Autorisierung und alle damit verbundenen Assistenten, die diesen Wert verwenden, funktionieren nicht mehr, bis Du ihn mit dem neuen Wert aktualisierst.

Claude Code (terminal)

Führe diesen einzelnen Befehl aus und ersetze dabei den Platzhalter durch Deinen Autorisierungswert (authoriazation value):

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

Codex

Am einfachsten geht das über die Codex-App:

Öffne Settings (Einstellungen) in Codex.
Gehe zu MCP servers (MCP Server) und klicke Add (hinzufügen).
Wähle einen remote/HTTP Server und gib Deine Server URL ein.
Gib einen HTTP header mit dem Namen Authorization (Autorisierung) mit Deinem Autorisierungswert (Authorization value) inklusive der Kennung Bearer ein.
Speichere den Server und starte einen neuen Codex-Chat. Die SuperSaaS Tools sollten in diesem Chat verfügbar sein.

Wenn Du das „Terminal“ als Eingabe bevorzugst oder die Konfiguration von Codex manuell vornehmen möchtest, bearbeite den folgenden Code ~/.codex/config.toml (Erstelle es, falls es noch nicht existiert) und füge das hinzu:

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

Starte Codex anschließend erneut; die SuperSaaS Tools erscheinen automatisch. Im Terminal kannst Du die Verbindung mit codex mcp list prüfen, und in Codex kannst Du folgenden Code nutzen, um die verbundenen Server zu prüfen: /mcp

Visual Studio Code (GitHub Copilot)

In VS Code werden MCP Server von GitHub Copilot Chat genutzt im agent mode (Agenten-Modus), daher ist ein Copilot-Abonnement erforderlich (die kostenlose Version ist ausreichend).

Öffne die Befehlspalette (command palette) (Ctrl/Cmd + Shift + P) und führe MCP: Add Server aus.
Wähle HTTP und gib Deine Server URL ein.
Wenn sich die mcp.json Code-Datei öffnet, gib die Angabe für die Kopfzeile headers so ein, dass die Server Definition (server definition) folgendermaßen aussieht:

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

Öffne die Chat-Box (chat panel) von Copilot, wechsle den Modus im Dropdown zu Agent, und klicke auf das Symbol der Tools, um zu überprüfen, ob die SuperSaaS-Tools aufgeführt sind.

Andere MCP Clients (Cursor, Le Chat, und weitere)

Jeder Client, der Remote-MCP-Server mit benutzerdefinierten Headern unterstützt, ist geeignet. Wann immer der Client nach Serverdetails fragt, verwende Folgendes:

Type / transport: Streamable HTTP
URL: Deine Server URL, z.B. https://www.supersaas.de/mcp
Header: Authorization setze den Wert Deiner Autorisierung ein (einschließlich des Wortes Bearer)

Für Clients, die mit einer JSON-Datei konfiguriert sind (wie mcp.json von Cursor), ist das Äquivalent:

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