Dokumentation · Anleitung
API-Schlüssel und REST-API
Für eigene Programme, Skripte und Assistenten ohne Anmeldung im Browser legen Sie API-Schlüssel an. Damit nutzen Sie die REST-API und den MCP-Server.
Schlüssel anlegen
- Öffnen Sie Einstellungen › API & KI-Zugang und klicken Sie im Abschnitt „API-Schlüssel“ auf „Neuer Schlüssel“.
- Vergeben Sie einen Namen, an dem Sie den Schlüssel wiedererkennen, z. B. „Import-Skript – Büro-Mac“. Den Namen sehen nur Sie.
- Wählen Sie unter „Was darf der Schlüssel?“ die Rechte – dieselben wie bei verbundenen Apps (siehe „KI-Assistenten verbinden“) – und klicken Sie auf „Schlüssel anlegen“.
- Kopieren Sie den Schlüssel (
kp_live_…) sofort: Er wird nur dieses eine Mal angezeigt. Der Dialog zeigt dazu fertige Befehle für Claude Code, Cursor und die REST-API.
Verbindungsdaten
| Angabe | Wert |
|---|---|
| MCP-Adresse | <Ihre KlickPlayer-Adresse>/mcp. Die frühere Adresse /api/mcp funktioniert weiter. |
| REST-API | <Ihre KlickPlayer-Adresse>/api/v1, Beschreibung unter /api/v1/openapi.json. Die REST-API funktioniert nur mit Schlüssel. |
| Anmeldung | Header Authorization: Bearer kp_live_… |
| Grenzen | 120 Anfragen und 30 Änderungen pro Minute je Verbindung oder Schlüssel. Jede Änderung wird protokolliert. |
Schlüssel widerrufen
Mit „Widerrufen …“ und „Endgültig widerrufen“ sperren Sie einen Schlüssel. Das lässt sich nicht rückgängig machen: Programme, die ihn nutzen, verlieren sofort den Zugriff. Schlüssel laufen nicht von selbst ab. Pro Konto sind höchstens 20 Schlüssel gleichzeitig gültig.
Tipps aus der Praxis
- Legen Sie für jedes Programm und jedes Gerät einen eigenen Schlüssel an. So können Sie jeden Zugang einzeln widerrufen.
- Behandeln Sie den Schlüssel wie ein Passwort und geben Sie ihm nur die Rechte, die das Programm braucht.
- Für Claude, ChatGPT und Cursor brauchen Sie keinen Schlüssel – dort genügt die Anmeldung über die Adresse.
Noch kein Konto? Testzugang starten