Naar inhoud springen
Clevera Help Center

Een API-token aanmaken voor een AI-agent

Maak een API-token aan in de wizard van vier stappen (Doel, Rechten, Limieten, Beoordelen): presets, rechten, verloopdatum, doc-sites, uitgavenlimieten en IP-toegangslijst. Het token wordt één keer getoond.

Bijgewerkt op 7 min leestijd

Met een API-token kunnen Claude Code, Codex, Cursor of je eigen script in je werkruimte werken als jij, met alleen de toegang die je kiest. Je maakt het aan in een wizard van vier stappen (Doel, Rechten, Limieten, Beoordelen), en Clevera toont het token één keer.

Voordat je begint

  • AI-agents & API is beschikbaar op de Pro-, Business- en Custom-abonnementen. Bij andere abonnementen zegt Nieuw token: "De API- en agenttoegang zijn beschikbaar vanaf Pro."
  • Elk werkruimtelid kan tokens voor zichzelf aanmaken. Een token kan alleen rechten krijgen die jouw rol toestaat. Zie Agent-rechten.
  • Een werkruimte kan 50 actieve tokens hebben. Bij het bereiken van de limiet is Nieuw token uitgeschakeld: "Je werkruimte heeft de limiet van 50 actieve tokens bereikt. Trek er eerst een in."
  • Gebruik één token per agent of script, zodat je kunt zien wat elk token heeft gedaan en er een kunt intrekken zonder de andere te stoppen.

Een token aanmaken

  1. Open het tabblad Tokens

    Open het werkruimtemenu en kies AI-agents & API. Klik op het tabblad Tokens op Nieuw token.

  2. Doel: geef het een naam en kies waar het voor is

    Geef het een Naam die je herkent in de tokenlijst en het activiteitenlogboek, tot 100 tekens, zoals "Docs-schrijver (Claude Code)". Kies onder Waar is het voor? een preset. Hiermee worden de rechten voor die taak aangevinkt; je kunt deze daarna nog verfijnen.

    Stap 1 van de wizard Nieuw API-token: een naam en een keuze uit doel-presets zoals Schrijver, Publicatiebeheer en Support-assistent.
    Kies de preset die het dichtst bij de taak van de agent ligt.
    Preset Gebruik het voor
    Schrijver "Agents maken concepten; een persoon beoordeelt en publiceert." Concepten voor doc-sites.
    Publicatiebeheer "Vertrouwde automatisering die kan wijzigen wat lezers zien." Doc-sites, inclusief publiceren.
    Support-assistent "Antwoorden uit gepubliceerde documentatie. Niets anders." Een help-bot.
    Alleen-lezen "Onderzoek, audits en vertaalcontroles."
    Analist "Leest inhoud en lezerssignalen om verbeteringen voor te stellen."
    Producent "Stelt inhoud op en start betaald werk binnen uitgavenlimieten." Video's, clips en artikelen aanvragen.
    Werkruimte-agent "Alles wat een agent in deze werkruimte kan doen, binnen uitgavenlimieten."

    Een grijsgemaakte preset bevat een recht dat jouw rol niet kan toekennen: "Jouw rol kan niet alle mogelijkheden in deze preset toekennen."

  3. Rechten: controleer elk recht

    De stap somt elk recht op, gegroepeerd per Documentatie, Video's en Werkruimte, elk met wat het toestaat en een badge (Lezen, Bewerken, Publiceren, Beheren of Geeft credits uit). Vink aan of uit wat je wilt. Zodra je de set van de preset wijzigt, toont de kop Aangepast en Herstellen naar preset maakt je wijzigingen ongedaan.

    Stap 2, Rechten: de rechten van de Schrijver-preset aangevinkt, gegroepeerd per toolset, elk met een korte beschrijving en een Lezen, Bewerken, Publiceren of Beheren-badge.
    Elk recht zegt wat voor soort actie het toestaat.

    Wat elk recht toestaat: Agent-rechten.

  4. Limieten: stel verloopdatum, sites, uitgaven en adressen in

    Stap 3, Limieten: verloopdatum, doc-sites, uitgavenlimieten per taak, dag en maand, Automatisch goedkeuren hieronder, en de IP-toegangslijst onder Geavanceerd.
    Uitgaven verschijnen alleen wanneer het token credits kan uitgeven.

    Zie Limietopties hieronder.

  5. Beoordelen en aanmaken

    De beoordeling zegt in duidelijke taal wat het token kan doen (Kan lezen, Kan aanmaken en bewerken, Kan publiceren, Kan sites beheren, Kan credits uitgeven) en wat de limieten zijn. "Het handelt als jij, binnen wat jouw rol toestaat." Klik op Token aanmaken.

    Stap 4, Beoordelen: wat het nieuwe token kan doen in duidelijke taal, en de verloopdatum, doc-sites en IP-toegangslijst, voordat je het aanmaakt.
    Controleer de samenvatting en klik daarna op Token aanmaken.

  6. Kopieer het token

    Token aangemaakt toont het token, beginnend met clv_agent_: "Kopieer het nu: je zult het niet opnieuw zien." Kopieer het naar een geheime opslag of een omgevingsvariabele. Verbind een agent hieronder bevat kant-en-klare instellingen voor Claude Code, Codex CLI, .mcp.json, curl en Claude.ai, ChatGPT. Klik op Ik heb het opgeslagen wanneer je klaar bent.

    Het dialoogvenster Token aangemaakt toont het nieuwe token één keer, met kant-en-klare installatiecommando's voor Claude Code, Codex CLI, .mcp.json en curl.
    Het token wordt slechts één keer getoond.

Terug behoudt alles wat je hebt ingevoerd. Als je de wizard sluit nadat je iets hebt gewijzigd, wordt gevraagd "Dit token verwijderen?": "De instellingen die je bent gestart gaan verloren. Er is geen token aangemaakt."

Limietopties

Optie Wat het doet Standaard
Verloopt na 7 dagen, 30 dagen, 90 dagen of 1 jaar. De datum staat hieronder ("Op datum"). Tokens verlopen altijd. 90 dagen
Doc-sites Getoond wanneer het token rechten voor doc-sites heeft. Alle sites ("Elke doc-site in deze werkruimte, inclusief nieuwe.") of Gekozen sites. Gekozen sites wanneer de werkruimte meer dan één doc-site heeft, anders Alle sites
Uitgaven → Per taak Het maximale bedrag waarvoor een start mag worden geciteerd, in credits. Leeg: geen limiet. geen limiet
Uitgaven → Per dag / Per maand Het maximale bedrag dat het token mag uitgeven (en reserveren voor lopende taken) in een kalenderdag of -maand. geen limiet
Uitgaven → Automatisch goedkeuren hieronder Starts die hieronder worden geciteerd, worden uitgevoerd zonder menselijke tussenkomst. "0 betekent dat een persoon elke betaalde start goedkeurt. Je abonnement staat tot 500 toe." (1.000 op Custom.) 0
Geavanceerd → IP-toegangslijst "Optioneel. Eén adres of bereik per regel; oproepen van elders worden geweigerd." Tot 20 IPv4/IPv6-adressen of CIDR-bereiken, zoals 203.0.113.7 of 198.51.100.0/24. Leeg: elk adres

Uitgaven verschijnt alleen wanneer het token credits:spend heeft (de presets Producent en Werkruimte-agent). Hoe limieten en goedkeuringen samenwerken: Agent-uitgaven en goedkeuringen beheren.

Wat gebeurt er daarna

  • Het token werkt direct via MCP (https://app.clevera.ai/mcp) en de REST API.
  • De eigenaar van de werkruimte en beheerders krijgen een melding: "Een nieuw API-token, naam, is aangemaakt voor werkruimte", met wie het heeft ingesteld en de toegang ervan.
  • Het token verschijnt op het tabblad Tokens met de laatste vier tekens, zoals clv_agent_…k7Qe, en elk gebruik werkt Laatst gebruikt bij.
  • Nadat je het hebt aangemaakt, kunnen de rechten en limieten niet meer worden gewijzigd. Om deze te wijzigen, maak je een nieuw token aan en trek je het oude in. Zie API-tokens beheren.

Problemen oplossen

Bericht Oorzaak Oplossing
"Geef het token een naam." De naam is leeg. Typ een naam.
"Kies ten minste één mogelijkheid." Geen recht is aangevinkt. Vink er ten minste één aan.
"Kies ten minste één site." Gekozen sites met niets geselecteerd. Kies een site, of kies Alle sites.
"Voer een geheel getal aan credits in." Een uitgavenveld bevat een decimaal of tekst, of 0 in een limiet. Voer een geheel getal in, of laat de limiet leeg.
"Je abonnement keurt agentwerk automatisch goed onder maximaal 500 credits." Automatisch goedkeuren hieronder is hoger dan het maximum van je abonnement. Verlaag het.
"waarde is geen IP-adres of bereik." Een regel in de IP-toegangslijst is niet geldig. Corrigeer of verwijder die regel.
"Jouw rol kan sommige van deze mogelijkheden niet toekennen." Een recht valt buiten je rol. Vink het uit, of vraag een eigenaar of beheerder om het token aan te maken.
"Je werkruimte heeft de limiet van 50 actieve tokens bereikt. Trek er eerst een in." 50 actieve tokens. Trek er een in die je niet gebruikt.
"De API- en agenttoegang zijn niet in je abonnement inbegrepen." De werkruimte heeft geen Pro, Business of Custom. Upgrade naar Pro.
"Kon het token niet aanmaken. Probeer het opnieuw." Er ging iets mis. Probeer het opnieuw; neem contact op met support als het blijft gebeuren.
AI-apps en agents verbindenStel het token in in Claude Code, Codex of Cursor.Agent-rechtenWat elk recht toestaat.API-tokens beherenOpnieuw genereren, intrekken en verloopdatum.Agent-uitgaven en goedkeuringen beherenUitgavenlimieten en goedkeuringen.