KI-Agenten und die API verstehen
Was KI-Agenten wie Claude, ChatGPT, Claude Code, Codex und Cursor in deinem Clevera-Workspace tun können, wie du sie verbindest, Pläne (Pro und höher), Limits, Rollen, Kosten und Sicherheit.
AI agents & API ermöglicht es KI-Apps wie Claude, ChatGPT, Claude Code, Codex und Cursor sowie deinen eigenen Skripten, in deinem Clevera-Workspace zu arbeiten: Aufnahmen finden, Videos, Social-Clips und Artikel anfordern, Videos exportieren und an Dokumentations-Websites arbeiten. Du entscheidest genau, was jeder Agent tun darf, wie viele Credits er ausgeben darf und wann eine Person eine Genehmigung erteilen muss.
Was Agenten tun können
| Bereich | Was ein Agent tun kann |
|---|---|
| Videos | Deine Aufnahmen, Videos, Artikel und Transkripte auflisten und lesen; How-to-Videos, Produktdemos, bereinigte und stilisierte Videos aus einer Aufnahme, Social-Clips, Artikel aus einer Aufnahme sowie Videoübersetzungen anfordern; MP4s bis zu 4K exportieren; Bilder, Videos und PDFs zu deinen Uploads hinzufügen. |
| Dokumentations-Websites | Dokumentations-Websites-Seiten und das Changelog lesen, entwerfen, organisieren, übersetzen und veröffentlichen, Leser von veröffentlichten Seiten aus beantworten, Leser-Einblicke lesen sowie Website-Einstellungen ändern oder Websites erstellen. |
Agenten können noch keine Website-Recherchen oder aufgezeichnete Walkthroughs durchführen.
Der Agent stellt die Anfrage; Cleveras eigene KI erstellt das Video oder den Artikel, genau wie wenn du es in der App startest. Ein Agent sieht nie mehr, als sein Besitzer sehen könnte: Aufnahmen in einer privaten Sammlung bleiben verborgen, es sei denn, der Besitzer des Tokens hat Zugriff.
Verbindungsmöglichkeiten
| Weg | Für | Einrichten unter |
|---|---|---|
| API-Token | Claude Code, Codex CLI, Cursor, jeden MCP-Client und deine eigenen Skripte über die REST-API | Token → Neues Token. Siehe API-Token erstellen. |
| Verbundene Apps | Claude (claude.ai) und ChatGPT als benutzerdefinierter Connector; kein Token, du meldest dich an | Die App, mit der Connector-URL aus Verbundene Apps. Siehe KI-Apps und Agenten verbinden. |
| REST-API | Skripte und Backend-Dienste | Ein API-Token. Siehe REST-API verwenden. |
Der MCP-Server ist https://app.clevera.ai/mcp und die REST-API befindet sich unter https://app.clevera.ai/api/v1.
Die Seite finden
Öffne das Workspace-Menü und wähle AI agents & API. Auf Dokumentations-Websites befindet es sich auch auf der Docs-Startseite und im Einstellungen-Menü einer Website. Die Seite („Lasse Claude, Codex, ChatGPT und deine Skripte in diesem Workspace arbeiten.“) hat fünf Tabs, jeder mit einer Anzahl:
| Tab | Was ist dort |
|---|---|
| Token | Deine API-Token; Besitzer und Administratoren sehen jedes Token. API-Token verwalten |
| Verbundene Apps | Die Connector-URL und die Apps, die Personen verbunden haben. KI-Apps und Agenten verbinden |
| Agentenanfragen | Bezahltes Arbeitsaufkommen, das auf die Genehmigung durch eine Person wartet, mit einem Zähler-Badge, sowie die Historie. Ausgaben und Genehmigungen von Agenten steuern |
| Webhooks | Signierte Benachrichtigungen an deine eigenen Systeme. Webhooks einrichten |
| Aktivität | Was Agenten getan haben. Agenten-Aktivität lesen |
Pläne
AI agents & API ist in den Plänen Pro, Geschäftlich und Benutzerdefiniert enthalten. Das beinhaltet API-Token, Connectoren für Claude und ChatGPT sowie Webhooks.
Bei Free und Starter zeigt die Seite „AI agents & API sind in Pro enthalten“ an: „Upgrade, damit Claude, ChatGPT und deine Skripte in diesem Workspace arbeiten können. Bestehende Token und Apps funktionieren bis dahin nicht mehr; du kannst sie hier weiterhin widerrufen.“ Klicke auf Upgrade auf Pro. Gesperrte Steuerelemente zeigen an: „Der API- und Agentenzugriff ist in Pro und höher enthalten.“, „Claude.ai- und ChatGPT-Connectoren sind in Pro und höher enthalten.“ oder „Webhooks sind in Pro und höher enthalten.“
| Limit | Pro, Geschäftlich, Benutzerdefiniert |
|---|---|
| Aktive API-Token pro Workspace | 50 |
| Verbundene Apps pro Person | 20 |
| Webhooks pro Workspace | 10 |
| Automatisch genehmigen unter maximal | Pro und Geschäftlich: 500 Credits. Benutzerdefiniert: 1.000 Credits. |
Wenn der Workspace Pro verlässt
Nichts wird gelöscht, aber alles pausiert, bis du erneut ein Upgrade durchführst:
| Nach dem Wechsel zu Starter oder Free | |
|---|---|
| API-Token | Bleiben aufgelistet und können widerrufen werden. Jeder Aufruf wird verweigert: „Die Agenten-API ist nicht im Plan dieses Workspaces enthalten. Sie ist in Pro und höher enthalten.“ Sie können nicht neu generiert werden (Geheimnis neu generieren öffnet den Upgrade-Dialog). |
| Verbundene Apps | Bleiben aufgelistet und können getrennt werden. Ihre Aufrufe schlagen fehl; Claude oder ChatGPT melden möglicherweise nur, dass keine Verbindung hergestellt werden konnte. |
| Webhooks | Bleiben aufgelistet, aber es wird nichts gesendet. Test-Event senden und Erneut zustellen melden „Webhooks sind nicht in deinem Plan enthalten.“ |
| Agentenanfragen | Genehmigen meldet „Der API- und Agentenzugriff ist nicht in deinem Plan enthalten.“ Ablehnen funktioniert weiterhin. |
| Neue Token | „Der API- und Agentenzugriff ist nicht in deinem Plan enthalten.“ |
Ein Upgrade zurück auf Pro lässt Token, Apps und Webhooks wieder funktionieren. Token laufen weiterhin an ihren ursprünglichen Daten ab.
Wer kann was tun
Ein Agent handelt als die Person, die sein Token erstellt oder es verbunden hat, im Rahmen dessen, was die Rolle dieser Person erlaubt. Er kann nie mehr tun, als diese Person in der App tun könnte, und die Rolle wird bei jedem Aufruf überprüft, sodass eine Rollenänderung sofort wirksam wird.
| Aufgabe | Besitzer | Admin | Editor | Content Creator |
|---|---|---|---|---|
| Token erstellen und Apps für dich selbst verbinden | Ja | Ja | Ja | Ja |
| Jedes Token und jede App im Workspace sehen und widerrufen | Ja | Ja | Nur eigene | Nur eigene |
| Einem Agenten die Erlaubnis geben, Videos anzufordern und Credits auszugeben | Ja | Ja | Nein | Ja |
| Einem Agenten die Erlaubnis geben, Dokumentations-Websites zu veröffentlichen | Ja | Ja | Ja | Nein |
| Bezahltes Arbeitsaufkommen genehmigen, das Agenten anfordern | Ja | Ja | Nein | Nein |
| Webhooks verwalten | Ja | Ja | Nein | Nein |
Die vollständige Liste findest du unter Agenten-Berechtigungen.
Was es kostet
- API- und MCP-Aufrufe sind kostenlos: Lesen, Suchen, Zitieren und das Überprüfen eines Jobs kosten keine Credits. Das gilt auch für Videoexporte.
- Arbeit, die KI nutzt, kostet Credits, genau wie wenn du sie in der App startest: Videos, Social-Clips, Artikel aus Aufnahmen, Übersetzungen und KI-generierte Website-Seiten.
- Ein Agent kann bezahlte Arbeit nur mit einem Token starten, das über
credits:spendverfügt. Jeder Start wird zuerst kalkuliert und gegen die Ausgabenobergrenzen des Tokens geprüft, und eine Person genehmigt ihn, es sei denn, er liegt unter der Zeile Automatisch genehmigen unter des Tokens. Siehe Ausgaben und Genehmigungen von Agenten steuern.
Wie Clevera Agenten sicher hält
- Token laufen immer ab: nach 7 Tagen, 30 Tagen, 90 Tagen oder 1 Jahr. Es gibt kein „nie“.
- Geheimnisse werden nur einmal angezeigt. Clevera speichert nur einen Fingerabdruck und zeigt die letzten vier Zeichen an.
- Minimaler Zugriff. Jedes Token hat nur die Berechtigungen, Dokumentations-Websites und IP-Adressen, die du auswählst.
- Personen genehmigen Geld. Ein Agent kann seine eigenen Ausgaben nicht genehmigen; nur der Workspace-Besitzer oder ein Admin kann das.
- Geleakte Token werden widerrufen. Ein Clevera-Token, das in einem öffentlichen GitHub-Repository gefunden wird, wird automatisch widerrufen.
- Ungewöhnliche Aktivität wird gestoppt. Häufungen abgelehnter Aufrufe führen zum Widerruf des Tokens; Häufungen von Änderungen oder Ausgaben pausieren es, und der Besitzer wird benachrichtigt.
- Alles wird protokolliert unter Aktivität und 13 Monate lang aufbewahrt. Die Bearbeitungen eines Agenten an einer Dokumentations-Website erscheinen auch in der Seitenhistorie als „Agent Name (Token)“.