API-Integrationen und KI-Agenten

Mit einem API-Schlüssel kann Ihre eigene Software – ein HR-System, ein Reporting-Skript oder ein KI-Agent – mit den Daten Ihrer Organisation arbeiten, ohne dass sich eine Person anmeldet. Der Schlüssel gehört der Organisation, nicht Ihnen. Er funktioniert also weiter, wenn Sie die Stelle wechseln, und Sie können ihn mit einem Klick widerrufen.

Wer kann das?

Für Administratoren der Organisation. Öffnen Sie Organisationseinstellungen → Integrationen. Entwickler erstellen ihre Schlüssel unter Anwendungen → Integrationen.

Ihre Schlüssel ansehen

Die Karte API-Schlüssel listet alle Schlüssel der Organisation mit Umfang, Rollen, Ablaufdatum, wann sie Zuletzt genutzt wurden, und Status (Aktiv, Widerrufen oder Abgelaufen). Unter dem Namen sehen Sie nur den Anfang des Schlüssels, nie den vollständigen Wert.

Karte API-Schlüssel mit aktiven und widerrufenen Schlüsseln

Schlüssel erstellen

1Öffnen Sie Organisationseinstellungen → Integrationen.
2Klicken Sie auf Schlüssel erstellen.
3Benennen Sie ihn unter Name nach dem Tool, das ihn nutzen wird – diesen Namen sehen Sie im Anfrageprotokoll.
4Wählen Sie unter Rollen, was der Schlüssel bekommt: Administrator, Analyst oder Geräte-Administrator. Ein Schlüssel kann nie mehr als Sie, deshalb sehen Sie nur die Rollen, die Sie selbst haben.
5Wählen Sie unter Umfang Nur lesen oder Lesen und schreiben.
6Wählen Sie unter Gültigkeit 30, 90 oder 365 Tage.
7Klicken Sie auf Schlüssel erstellen.

Wir zeigen den Schlüssel einmal, direkt nach dem Erstellen. Kopieren Sie ihn in Ihren Passwortmanager oder Ihren Secret-Store, bevor Sie das Fenster schließen. Geht er verloren, rotieren Sie den Schlüssel und verwenden Sie den neuen.

Behandeln Sie den Schlüssel wie ein Passwort

Wer ihn besitzt, kann die Daten Ihrer Organisation im Rahmen der vergebenen Rollen lesen. Fügen Sie ihn nie in einen Chat, ein Ticket oder ein öffentliches Repository ein.

So sieht der Schlüssel aus

Jeder Schlüssel beginnt mit sk_live_, zum Beispiel sk_live_7Hq2mZk1_…. Das Panel speichert nur seinen Hash und das sichtbare Präfix – deshalb können wir Ihnen den vollständigen Schlüssel nicht erneut anzeigen.

Senden Sie ihn im Header Authorization:

Authorization: Bearer sk_live_7Hq2mZk1_…

Rollen und Umfang

Rollen entscheiden, welche Daten der Schlüssel sieht – nach genau denselben Regeln wie für eine Person mit dieser Rolle.
Umfang entscheidet, was er tun darf: Ein Schlüssel mit Leserechten wird bei jedem Schreibzugriff mit 403 abgewiesen.
Der Schlüssel funktioniert nur in der Organisation, in der er erstellt wurde. Auf das Panel (api/web) hat er keinerlei Zugriff.

Ablauf und Rotation

Ein Schlüssel funktioniert ab dem Moment nicht mehr, in dem er abläuft. Beide Aktionen unten finden Sie im Menü am Ende der Zeile eines aktiven Schlüssels.

Rotieren gibt Ihnen einen neuen Schlüsselwert, während der alte noch 24 Stunden funktioniert – genug, um Ihr Tool ohne Ausfall neu auszurollen.
Widerrufen sperrt einen Schlüssel sofort; jeder Aufruf damit wird innerhalb einer Minute abgewiesen. Das kann nicht rückgängig gemacht werden.

Zeilenmenü eines API-Schlüssels mit Rotieren und Widerrufen

Limits

10 aktive Schlüssel pro Organisation und pro Kontext.
120 Anfragen pro Minute pro Schlüssel. Darüber antwortet die API mit 429 und dem Header Retry-After.

Das Anfrageprotokoll

Die Karte Anfrageprotokoll auf derselben Seite listet jeden Aufruf mit einem Schlüssel dieser Organisation: den Schlüssel, Methode und Pfad, den Antwortstatus, die Dauer und ob er über REST oder MCP kam. Filtern Sie nach Schlüssel oder nach Status, wenn Sie eine Integration debuggen – ein 429 bedeutet, dass der Schlüssel das Anfragelimit erreicht hat. Einträge werden 90 Tage aufbewahrt.

Anfrageprotokoll mit den Filtern für Schlüssel und Status

Die API-Referenz

Die vollständige Liste der Endpunkte sowie die Formate von Anfragen und Antworten stehen in der API-Referenz: api.skillsive.com/core/docs/v1. Die Schaltfläche API-Dokumentation auf der Seite Integrationen öffnet dieselbe Seite.

KI-Agenten anbinden (MCP)

Derselbe Schlüssel authentifiziert Sie beim Skillsive-MCP-Server unter https://api.skillsive.com/core/mcp, der die API als Tools bereitstellt, die ein Agent direkt aufrufen kann.

Claude Code – ein Befehl in Ihrem Terminal:

claude mcp add --transport http skillsive https://api.skillsive.com/core/mcp --header "Authorization: Bearer sk_live_…"

Cursor – fügen Sie den Server zu ~/.cursor/mcp.json hinzu (oder zu .cursor/mcp.json im Projekt):

{
	"mcpServers": {
		"skillsive": {
			"type": "http",
			"url": "https://api.skillsive.com/core/mcp",
			"headers": { "Authorization": "Bearer sk_live_…" }
		}
	}
}

Konnektoren in Claude.ai und ChatGPT

Die Konnektoren in den Web-Apps von Claude und ChatGPT verlangen eine Anmeldung per OAuth, die Skillsive noch nicht unterstützt. Agenten, die sich über einen Header authentifizieren – Claude Code, Cursor und Ihre eigenen Agenten –, funktionieren schon heute.

FAQ

Ich habe das Fenster geschlossen, bevor ich den Schlüssel kopiert habe. Kann ich ihn noch einmal sehen?

Nein – wir speichern nur seinen Hash. Öffnen Sie das Menü des Schlüssels, klicken Sie auf Rotieren und kopieren Sie den neuen Wert.

Welche Rolle sollte ein HR- oder Reporting-Tool bekommen?

Administrator. Um Teilnehmer, Kursabschlüsse und Zertifikate zu lesen, ist ein Administrator-Schlüssel nötig – ein Analyst-Schlüssel kann nur die eigenen Angaben der Organisation lesen. Damit der Schlüssel keinen Schaden anrichten kann, geben Sie ihm den Umfang Nur lesen: Er kann Daten lesen, aber nie ändern.

Hört ein Schlüssel auf zu funktionieren, wenn die Person, die ihn erstellt hat, das Unternehmen verlässt?

Nein. Der Schlüssel gehört der Organisation. Widerrufen Sie ihn selbst, wenn das Tool nicht mehr genutzt wird.