Zum Hauptinhalt springen

API-Anbindung

API-Anbindung (beta)​

Mit der kutego® REST API verbindest du deinen kutego®-Account mit anderen Programmen, Automatisierungstools und KI-Assistenten. So kannst du Daten aus kutego® abrufen und in anderen Systemen weiterverarbeiten, ohne sie von Hand übertragen zu müssen.

Wo du die API findest​

Alles rund um die API findest du in deinem kutego®-Adminbereich unter /admin/api. Du hängst dafür einfach /admin/api an deine kutego®-URL an.

Dort kannst du:

  • die Dokumentation der API einsehen, also alle verfügbaren Endpunkte und welche Daten sie liefern
  • deine API-Token erzeugen und verwalten

Eine lesende Schnittstelle​

Die kutego® API ist eine lesende Schnittstelle. Angebundene Programme können Daten aus deinem Account abrufen, aber nichts anlegen, ändern oder löschen. Buchungen, Kundendaten, Rechnungen und Einstellungen bearbeitest du weiterhin direkt in kutego®.
Das gilt auch für KI-Assistenten: Sie können deine Daten auswerten und dir Fragen dazu beantworten, aber aktuell noch keine Änderungen in deinem Account vornehmen.

API-Token erzeugen​

Für jeden Zugriff auf die API brauchst du einen API-Token. Damit meldet sich das jeweilige Programm bei deinem Account an.

  1. Öffne in deinem kutego®-Adminbereich die Seite /admin/api.
  2. Erzeuge einen neuen API-Token.
  3. Kopiere den Token und trage ihn in dem Programm ein, das du anbinden möchtest.

Die Anmeldung erfolgt immer über diesen Header:

Authorization: Bearer DEIN-API-TOKEN
warnung

Behandle deinen API-Token wie ein Passwort. Auch wenn die Schnittstelle nur lesend ist, kann jeder mit deinem Token die Daten deines Accounts abrufen, einschließlich der Daten deiner Kunden. Gib ihn nicht weiter und speichere ihn nicht an unsicheren Orten. Lege am besten für jedes Programm einen eigenen Token an. So kannst du einzelne Verbindungen gezielt wieder entfernen. Tokens, die du nicht mehr brauchst, löschst du unter /admin/api.

Einsatzmöglichkeiten​

Die API ist überall dort nützlich, wo du Daten aus kutego® in anderen Systemen nutzen möchtest. Hier ein paar Beispiele:

Daten automatisch weitergeben​

Mit Automatisierungstools wie Make, n8n oder Zapier holst du Daten aus kutego® und gibst sie an deine anderen Programme weiter. Du kannst zum Beispiel neue Buchungen automatisch in eine Tabelle übertragen, Kundendaten übernehmen oder andere weiterverarbeitende Funktionen nutzen.

Eigene Auswertungen erstellen​

Über die API holst du deine Daten in Tabellen- oder Dashboard-Tools. So kannst du Auswertungen bauen, die genau auf deinen Betrieb zugeschnitten sind, zum Beispiel zu Auslastung, Umsatz oder Teilnehmerentwicklung.

Daten in eigenen Anwendungen anzeigen​

Hast du eine eigene Webseite, App oder ein internes System, kann dein Entwickler oder deine Agentur dort Daten aus kutego® anzeigen, zum Beispiel aktuelle Kurse oder freie Termine.

KI-Assistenten und KI-Agenten nutzen​

KI-Assistenten wie Claude, ChatGPT oder Gemini können über die API direkt auf deine kutego®-Daten zugreifen. Du kannst ihnen Fragen zu deinen Daten stellen, Auswertungen erstellen lassen oder eigene KI-Agenten aufbauen, die regelmäßig Berichte und Übersichten für dich zusammenstellen. Wie das geht, erklären wir im nächsten Abschnitt.

KI-Assistenten mit kutego® verbinden (MCP)​

Über das Model Context Protocol (MCP) können KI-Assistenten und KI-Agenten direkt auf deinen kutego®-Account zugreifen. Jeder Endpunkt der REST API steht dort automatisch als Werkzeug bereit. Die Anmeldung läuft auch hier über einen deiner API-Token.

Endpunkthttps://api.kutego.io/mcp/
AnmeldungAuthorization: Bearer <API-Token>
warnung

Datenschutz beachten: Wenn du einen KI-Assistenten mit kutego® verbindest, werden personenbezogene Daten deiner Kunden (zum Beispiel Namen, Kontaktdaten, Buchungen und Rechnungen) an den jeweiligen KI-Anbieter übermittelt. Für diese Übermittlung bist du als Verantwortlicher im Sinne der DSGVO selbst zuständig. Nutze deshalb einen Geschäftstarif deines KI-Anbieters, bei dem deine Daten nicht zum Training verwendet werden, und schließe mit dem Anbieter einen Auftragsverarbeitungsvertrag (AVV) ab. Prüfe außerdem, ob du dein Verarbeitungsverzeichnis und deine Datenschutzerklärung anpassen musst. Im Zweifel stimme dich vorab mit deinem Datenschutzbeauftragten ab.

Voraussetzungen​

Dein KI-Tool muss MCP-Server unterstützen, die über eine URL erreichbar sind (sogenannte Remote-MCP-Server). Außerdem muss es dir erlauben, einen eigenen Header für die Anmeldung einzutragen. Ob und wo das möglich ist, findest du in der Hilfe deines KI-Tools.

So richtest du die Verbindung ein​

  1. Erzeuge unter /admin/api einen neuen API-Token.
  2. Öffne in deinem KI-Tool den Bereich, in dem du MCP-Server oder Connectoren hinzufügst.
  3. Lege einen neuen MCP-Server an und gib ihm einen Namen, zum Beispiel „kutego“.
  4. Trage als URL https://api.kutego.io/mcp/ ein.
  5. Trage als Header Authorization ein. Als Wert gibst du Bearer, ein Leerzeichen und dann deinen API-Token ein.
  6. Speichere die Verbindung. Dein KI-Assistent kann jetzt auf deine kutego®-Daten zugreifen.

Beispiel: Verbindung in Claude​

In Claude findest du die Einstellung unter Einstellungen > Connectors > Custom connector hinzufügen. Dort trägst du die URL ein und hinterlegst den Token im Bereich Request headers.

info

Der Bereich Request headers wird bei Claude derzeit schrittweise freigeschaltet und ist noch nicht in jedem Account sichtbar. Alternativ kannst du die Verbindung in Claude Code mit dem folgenden Befehl einrichten.

claude mcp add --transport http kutego https://api.kutego.io/mcp/ --header "Authorization: Bearer DEIN-API-TOKEN"

Beispiel: Konfigurationsdatei​

Viele KI-Tools und Agenten-Frameworks nutzen Konfigurationsdateien im JSON-Format. Der Eintrag für kutego® sieht dort meist so aus:

{
  "mcpServers": {
    "kutego": {
      "url": "https://api.kutego.io/mcp/",
      "headers": {
        "Authorization": "Bearer DEIN-API-TOKEN"
      }
    }
  }
}