Begrijp AI-agents en de API
Wat AI-agents zoals Claude, ChatGPT, Claude Code, Codex en Cursor kunnen doen in je Clevera-workspace, hoe je ze verbindt, abonnementen (Pro en hoger), limieten, rollen, kosten en veiligheid.
AI-agents & API laat AI-apps zoals Claude, ChatGPT, Claude Code, Codex en Cursor, en je eigen scripts, werken in je Clevera-workspace: opnames vinden, video's, social clips en artikelen aanvragen, video's exporteren en werken aan Docs-sites. Je bepaalt precies wat elke agent mag doen, hoeveel credits deze mag uitgeven en wanneer een persoon moet goedkeuren.
Wat agents kunnen doen
| Gebied | Wat een agent kan doen |
|---|---|
| Video's | Je opnames, video's, artikelen en transcripties weergeven en lezen; how-to's, productdemo's, opschoon- en gestileerde video's van een opname aanvragen, social clips, artikelen van een opname en videovertalingen; MP4's exporteren tot 4K; afbeeldingen, video's en PDF's toevoegen aan je uploads. |
| Docs-sites | Docs-site-pagina's en de changelog lezen, opstellen, organiseren, vertalen en publiceren, lezers beantwoorden vanaf gepubliceerde pagina's, lezersinzichten lezen en site-instellingen wijzigen of sites aanmaken. |
Agents kunnen nog geen website-onderzoek uitvoeren of opgenomen walkthroughs maken.
De agent doet het verzoek; de eigen AI van Clevera maakt de video of het artikel, op dezelfde manier als wanneer je dit in de app start. Een agent ziet nooit meer dan de eigenaar zou kunnen zien: opnames in een privécollectie blijven verborgen, tenzij de eigenaar van het token toegang heeft.
Manieren om te verbinden
| Manier | Voor | Instellen in |
|---|---|---|
| API-token | Claude Code, Codex CLI, Cursor, elke MCP-client en je eigen scripts via de REST API | Tokens → Nieuw token. Zie Een API-token aanmaken. |
| Verbonden app | Claude (claude.ai) en ChatGPT als aangepaste connector; geen token, je logt in | De app, met de connector-URL van Verbonden apps. Zie AI-apps en agents verbinden. |
| REST API | Scripts en backend-services | Een API-token. Zie De REST API gebruiken. |
De MCP-server is https://app.clevera.ai/mcp en de REST API bevindt zich onder https://app.clevera.ai/api/v1.
De pagina vinden
Open het workspace-menu en kies AI-agents & API. Op Docs-sites staat dit ook op de Docs-startpagina en in het Instellingen-menu van een site. De pagina ("Laat Claude, Codex, ChatGPT en je scripts werken in deze workspace.") heeft vijf tabbladen, elk met een teller:
| Tabblad | Wat staat daar |
|---|---|
| Tokens | Je API-tokens; eigenaren en beheerders zien elk token. API-tokens beheren |
| Verbonden apps | De connector-URL en de apps die mensen hebben verbonden. AI-apps en agents verbinden |
| Agent-verzoeken | Betaald werk dat wacht op goedkeuring van een persoon, met een teller-badge, en de geschiedenis. Agent-uitgaven en goedkeuringen beheren |
| Webhooks | Ondertekende meldingen naar je eigen systemen. Webhooks instellen |
| Activiteit | Wat agents hebben gedaan. Agent-activiteit lezen |
Abonnementen
AI-agents & API is beschikbaar in de Pro, Zakelijk en Aangepast abonnementen. Dit omvat API-tokens, connectors voor Claude en ChatGPT, en webhooks.
Bij Free en Starter toont de pagina "AI-agents & API zijn inbegrepen in Pro": "Upgrade om Claude, ChatGPT en je scripts in deze workspace te laten werken. Bestaande tokens en apps stoppen met werken tot die tijd; je kunt ze hier nog wel intrekken." Klik op Upgrade naar Pro. Vergrendelde bedieningselementen geven aan: "De API- en agent-toegang zijn beschikbaar in Pro en hoger.", "Claude.ai- en ChatGPT-connectors zijn beschikbaar in Pro en hoger." of "Webhooks zijn beschikbaar in Pro en hoger."
| Limiet | Pro, Zakelijk, Aangepast |
|---|---|
| Actieve API-tokens per workspace | 50 |
| Verbonden apps per persoon | 20 |
| Webhooks per workspace | 10 |
| Automatisch goedkeuren hieronder maximaal | Pro en Zakelijk: 500 credits. Aangepast: 1.000 credits. |
Als de workspace Pro verlaat
Niets wordt verwijderd, maar alles pauzeert totdat je weer upgradet:
| Na overstap naar Starter of Free | |
|---|---|
| API-tokens | Blijven in de lijst staan en kunnen worden ingetrokken. Elke aanroep wordt geweigerd: "De agent-API zit niet in het abonnement van deze workspace. Deze is beschikbaar in Pro en hoger." Ze kunnen niet opnieuw worden gegenereerd (Geheim opnieuw genereren opent het upgrade-dialoogvenster). |
| Verbonden apps | Blijven in de lijst staan en kunnen worden losgekoppeld. Hun aanroepen mislukken; Claude of ChatGPT kan alleen aangeven dat er geen verbinding kon worden gemaakt. |
| Webhooks | Blijven in de lijst staan, maar er wordt niets verzonden. Testgebeurtenis verzenden en Opnieuw afleveren geven aan "Webhooks zitten niet in je abonnement." |
| Agent-verzoeken | Goedkeuren geeft aan "De API- en agent-toegang zitten niet in je abonnement." Weigeren werkt nog wel. |
| Nieuwe tokens | "De API- en agent-toegang zitten niet in je abonnement." |
Upgraden naar Pro zorgt ervoor dat tokens, apps en webhooks weer werken. Tokens verlopen nog steeds op hun oorspronkelijke datum.
Wie kan wat doen
Een agent handelt als de persoon die het token heeft aangemaakt of de app heeft verbonden, binnen de grenzen van wat de rol van die persoon toestaat. Het kan nooit meer doen dan die persoon in de app zou kunnen, en de rol wordt bij elke aanroep gecontroleerd, dus een rolwijziging is direct van kracht.
| Taak | Eigenaar | Beheerder | Editor | Content Creator |
|---|---|---|---|---|
| Tokens aanmaken en apps verbinden voor jezelf | Ja | Ja | Ja | Ja |
| Elk token en elke app in de workspace zien en intrekken | Ja | Ja | Alleen eigen | Alleen eigen |
| Een agent toestemming geven om video's aan te vragen en credits uit te geven | Ja | Ja | Nee | Ja |
| Een agent toestemming geven om Docs-sites te publiceren | Ja | Ja | Ja | Nee |
| Betaald werk goedkeuren waar agents om vragen | Ja | Ja | Nee | Nee |
| Webhooks beheren | Ja | Ja | Nee | Nee |
De volledige lijst staat in Agent-machtigingen.
Wat het kost
- API- en MCP-aanroepen zijn gratis: lezen, zoeken, citeren en het controleren van een taak kosten geen credits. Dat geldt ook voor video-exports.
- Werk dat AI gebruikt kost credits, hetzelfde als wanneer je het in de app start: video's, social clips, artikelen van opnames, vertalingen en door AI gegenereerde sitepagina's.
- Een agent kan alleen betaald werk starten met een token dat
credits:spendheeft. Elke start wordt eerst geciteerd en gecontroleerd tegen de bestedingslimieten van het token, en een persoon keurt het goed tenzij het onder de Automatisch goedkeuren hieronder-grens van het token valt. Zie Agent-uitgaven en goedkeuringen beheren.
Hoe Clevera agents veilig houdt
- Tokens verlopen altijd: na 7 dagen, 30 dagen, 90 dagen of 1 jaar. Er is geen "nooit".
- Geheimen worden één keer getoond. Clevera slaat alleen een vingerafdruk op en toont de laatste vier tekens.
- Minimale toegang. Elk token heeft alleen de machtigingen, Docs-sites en IP-adressen die jij kiest.
- Mensen keuren geld goed. Een agent kan zijn eigen uitgaven niet goedkeuren; alleen de eigenaar van de workspace of een beheerder kan dat.
- Gelekte tokens worden ingetrokken. Een Clevera-token dat wordt gevonden in een openbare GitHub-repository wordt automatisch ingetrokken.
- Ongebruikelijke activiteit wordt gestopt. Uitbarstingen van geweigerde aanroepen trekken het token in; uitbarstingen van wijzigingen of uitgaven pauzeren het, en de eigenaar krijgt een melding.
- Alles wordt gelogd onder Activiteit, bewaard gedurende 13 maanden. De bewerkingen van een agent op een Docs-site verschijnen ook in de geschiedenis van de pagina als "Agent naam (token)".