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‘ 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)

Claude stellt als „custom connector“ (benutzerdefinierter Konnektor) eine Verbindung zu SuperSaaS her. Diese benötigt lediglich die Server-URL; melden Dich in Deinem Browser bei SuperSaaS an und genehmige die Verbindung.

In Claude, öffne Settings > Connectors (Einstellungen > Konnektor) und klicke auf Add custom connector (füge benutzerdefinierten Konnektor hinzu).
Gib einen Namen ein, wie „SuperSaaS“ und gib die Server URL (https://www.supersaas.de/mcp) ein, klicke dann Add (hinzufügen).
Klicke Connect (verbinden). Eine SuperSaaS Seite öffnet sich in Deinem Browser; logge Dich mit Deinem Konto-Namen und Passwort ein (wenn Du nicht bereits eingeloggt bist) und klicke Approve (bestätigen).
Zurück bei Claude werden nun die SuperSaaS Tools unter dem Symbol für die „Tools“ in dem Chat-Feld gezeigt.

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"
      }
    }
  }
}