Zum Inhalt springen
Clevera Help Center

KI-Agenten- und API-Fehler beheben

Jede Nachricht, die ein KI-Agent, ein Skript oder eine Person bei der Clevera-API, dem MCP-Server und auf der Seite „KI-Agenten & API“ sehen kann, gruppiert nach Ursache: Tokens, Plan, Berechtigungen, kostenpflichtige Arbeit, Ratenbegrenzungen, Konflikte und verbundene Apps, inklusive der Lösung.

Aktualisiert am 10 Min. Lesezeit

Wenn Clevera einen Aufruf eines Agenten ablehnt, erhält der Agent einen Code und eine Nachricht, die besagt, was zu tun ist. Dieser Artikel listet jede Nachricht auf, die ein Agent, ein Skript oder eine Person bei „KI-Agenten & API“ sehen kann, was die Ursache ist und wie man sie behebt. Über die REST-API steht der Code in error.code; über MCP wird dieselbe Nachricht als Tool-Fehler zurückgegeben.

Das Token wird nicht akzeptiert

Nachricht Code Ursache Lösung
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated Es wurde kein Token gesendet. Sende Authorization: Bearer <token>. Überprüfe, ob CLEVERA_TOKEN dort gesetzt ist, wo der Agent ausgeführt wird.
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated Der Wert ist falsch geschrieben, abgeschnitten oder kein Clevera-Token. Füge das vollständige Token erneut ein.
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera kennt dieses Token nicht. Erstelle ein neues Token.
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated Die Anmeldung einer verbundenen App wurde bei der REST-API verwendet. Verwende ein API-Token für REST.
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired Die Gültigkeitsdauer ist abgelaufen. Erstelle ein neues Token.
"This token was revoked." token_revoked Jemand hat es widerrufen, es wurde neu generiert, der Besitzer hat das Unternehmen verlassen oder Clevera hat es widerrufen. Siehe warum ein Token nicht mehr funktioniert.
"The account that owns this token is suspended." token_revoked Das Konto des Besitzers ist gesperrt. Kontaktiere den Support.
"This token can't be used from this IP address." ip_not_allowed Der Aufruf erfolgte von außerhalb der IP-Zulassungsliste des Tokens. Führe den Agenten von einer zugelassenen Adresse aus oder erstelle ein Token mit der neuen Adresse.

Der Plan beinhaltet dies nicht

„KI-Agenten & API“ (Tokens, verbundene Apps und Webhooks) ist in den Plänen Pro, Business und Custom enthalten. Bei Free und Starter zeigt die Seite „KI-Agenten & API sind in Pro enthalten“ mit Upgrade auf Pro an. Ein Upgrade macht bestehende Tokens, Apps und Webhooks wieder funktionsfähig; es wird nichts gelöscht.

Nachricht Code Ursache Lösung
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) Der Workspace nutzt Free oder Starter oder wurde dorthin verschoben. Jeder Token- und App-Aufruf wird abgelehnt. Upgrade auf Pro. Tokens, die nicht abgelaufen sind, funktionieren wieder.
Claude oder ChatGPT meldet nur, dass keine Verbindung hergestellt werden konnte, oder die Clevera-Tools schlagen fehl plan_locked im Hintergrund Dieselbe Plan-Ablehnung, die von der App als allgemeiner Verbindungsfehler angezeigt wird. Upgrade den Workspace auf Pro und versuche es in der App erneut.
"The API and agent access are not on your plan." — Erstellen eines Tokens oder Klicken auf Genehmigen bei einer Agentenanfrage außerhalb von Pro. Upgrade auf Pro. Ablehnen funktioniert weiterhin.
"The API and agent access are on Pro and up." / "Claude.ai and ChatGPT connectors are on Pro and up." / "Webhooks are on Pro and up." — Eine gesperrte Steuerung bei Free oder Starter. Upgrade auf Pro.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — Verbinden von Claude oder ChatGPT mit einem Workspace außerhalb von Pro. Upgrade oder wähle einen anderen Workspace auf dem Verbindungsbildschirm.
Geheimnis neu generieren öffnet den Upgrade-Dialog — Geheimnisse können außerhalb von Pro nicht neu generiert werden. Upgrade auf Pro oder widerrufe das Token.
"Webhooks are not on your plan." — Test-Event senden oder Erneut zustellen außerhalb von Pro. Es wird nichts gesendet; wartende Wiederholungsversuche enden als fehlgeschlagen mit plan_locked. Upgrade auf Pro.
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked Kostenpflichtige Arbeit in einem Plan ohne diese Funktion. Upgrade auf Pro.

Das Token ist nicht berechtigt zu

Nachricht Code Ursache Lösung
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability Dem Token fehlt die Berechtigung, die dieser Aufruf benötigt. Erstelle ein Token mit dieser Berechtigung. Siehe Agenten-Berechtigungen.
"The token owner's current role in this workspace does not allow ability." forbidden_role Die Rolle des Besitzers hat sich seit der Erstellung des Tokens geändert. Das Token zeigt Übersteigt Rolle. Jemand mit der entsprechenden Rolle erstellt das Token.
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — Erstellen eines Tokens mit Berechtigungen, die über deine Rolle hinausgehen. Deaktiviere sie oder frage einen Inhaber oder Administrator.
"You can't do this in this workspace." forbidden Die Rolle oder der Zugriff des Besitzers erlaubt diese Aktion für dieses Element nicht. Überprüfe die Rolle des Besitzers und den Sammlungszugriff.
"The token owner can view this article but not edit it (collection access)." forbidden_item Das Element befindet sich in einer Sammlung, die der Besitzer nur ansehen kann. Gib dem Besitzer Bearbeitungszugriff auf die Sammlung.
"No item with that id in this token's scope. List or search first and use a returned id." not_found Falsche ID oder das Element liegt außerhalb der Websites des Tokens oder des Zugriffs des Besitzers. Liste auf oder suche, dann verwende eine zurückgegebene ID.
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish Bearbeiten (oder Übersetzen) eines Artikels auf einer Live-Dokumentationsseite ohne Veröffentlichungsrechte. Gib dem Token site:publish oder lass es zur Überprüfung einreichen.
"This article is also shown on a site this token cannot change. …" shared_outside_scope Der Artikel erscheint auf einer Website außerhalb der Websites des Tokens. Verwende ein Token, das alle Websites abdeckt, auf denen er angezeigt wird, oder hinterlasse eine Überprüfungsnotiz.
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused Die Dokumentationsseite ist pausiert. Reaktivieren die Website.
Nachricht Code Ursache Lösung
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded Das Angebot passt nicht zum Limit des Tokens für Pro Job, Pro Tag oder Pro Monat. Warte auf den nächsten Tag oder Monat oder erstelle ein Token mit höheren Limits.
Eine Nachricht über aufgebrauchte Credits insufficient_credits Der Workspace hat nicht genügend Credits. Kaufe Credits oder warte auf die Zuteilung.
"Your workspace cannot spend credits right now." plan_locked Die Abrechnung blockiert Ausgaben, z. B. weil eine Zahlung fällig ist. Überprüfe die Abrechnung.
"This quote has expired. Ask for a new quote." quote_expired Angebote sind 15 Minuten lang gültig. Frage ein neues Angebot an.
"This quote was already used. Ask for a new quote." quote_used Ein Angebot startet einen Job. Frage ein neues Angebot an.
"This quote is for another kind of job." quote_mismatch Ein Video-Angebot wurde z. B. verwendet, um einen Clip zu starten. Verwende den passenden Start-Aufruf.
"Another start is being checked. Try again in a moment." busy Zwei Starts im selben Moment. Versuche es nach einer Sekunde erneut.
Der Job wartet mit needs_input — Er wartet auf Genehmigung unter Agentenanfragen. Ein Inhaber oder Administrator genehmigt oder lehnt ihn innerhalb von 24 Stunden ab.
Der Job endet expired — Niemand hat innerhalb von 24 Stunden entschieden. Starte erneut und genehmige ihn.
"This job can no longer be canceled." not_cancelable Der Job ist bereits abgeschlossen oder kann nicht mehr abgebrochen werden. —

Häufige Eingabenachrichten bei der Anforderung von Videos: "This recording is still processing. Please wait until it is ready.", "Choose how_to, product_demo, cleanup or styled_video.", "Choose 1080p, 2k or 4k.", "Exports are always 60 fps.", "This item is an article; only videos can be exported.", "Social clips cannot be translated by agents yet.", "This language is already translated.", "That material was not found in this workspace. Upload it first."

Zu viele Anfragen

Nachricht Code Limit
"This token is over its request rate. Wait and retry." rate_limited 300 Anfragen pro Minute pro Token
"This workspace is over its agent request rate. Wait and retry." rate_limited 1.200 pro Minute pro Workspace
"Too many writes from this token. Wait and retry." rate_limited 60 Schreibvorgänge pro Minute pro Token
"This token reached its daily write limit. Try again tomorrow." rate_limited 2.000 Schreibvorgänge pro Tag pro Token
"This token reached its hourly publish limit. Try again later." rate_limited 10 Veröffentlichungen pro Stunde pro Token
"Too many uploads from this token. Wait and retry." rate_limited 30 Uploads pro Minute
"This token reached its daily upload volume. Try again tomorrow." rate_limited 500 MB pro Tag pro Token
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited Ungewöhnliche Aktivität: Schreibvorgänge pausieren für 10 Minuten
"Too many requests. Wait and retry." rate_limited 60 pro Minute pro IP-Adresse ohne gültiges Token

Bezahlte Starts sind außerdem auf 20 pro Stunde pro Token und 100 pro Tag pro Workspace begrenzt. Jedes 429 hat einen Retry-After-Header; warte so lange.

Inhalt und Wiederholungsversuche

Nachricht Code Lösung
„Der Inhalt hat sich geändert, seit du ihn gelesen hast. Lies ihn erneut …, führe deine Änderung zusammen und versuche es erneut mit dieser ID.“ revision_conflict Der Agent liest die Seite erneut und wendet seine Änderung wieder an.
„Dieser Idempotenz-Schlüssel wurde für eine andere Anfrage verwendet.“ idempotency_conflict / idempotency_key_reused Verwende ein neues Idempotency-Key für eine neue Anfrage.
— idempotency_in_progress Die erste Anfrage mit diesem Schlüssel läuft noch. Warte und versuche es dann mit demselben Schlüssel erneut.

Tokens und die Seite

Situation Ursache Lösung
Neues Token ist deaktiviert „Dein Workspace hat das Limit von 50 aktiven Tokens erreicht. Widerrufe zuerst eines.“ Widerrufe ein Token, das du nicht verwendest.
Keine Option Geheimnis neu generieren Nur der Ersteller des Tokens kann es neu generieren, und das nur einmal. „Nur die Person, die dieses Token erstellt hat, kann es neu generieren. Du kannst es widerrufen.“ Generiere das neuere Token neu oder erstelle ein neues.
„Dieses Token wurde bereits neu generiert, widerrufen oder ist abgelaufen; verwende seinen Ersatz oder erstelle ein neues.“ Das Geheimnis wurde bereits zuvor neu generiert. Verwende das Ersatz-Token.
Du siehst das Token eines Kollegen nicht Nur Eigentümer und Administratoren sehen jedes Token. Frage einen Eigentümer oder Administrator.
Du kannst eine Anfrage nicht genehmigen: „Ein Eigentümer oder Administrator entscheidet“ Nur Eigentümer und Administratoren genehmigen Ausgaben. Frage einen Eigentümer oder Administrator.
„Nur Eigentümer und Administratoren verwalten Webhooks“ Deine Rolle kann keine Webhooks verwalten. Frage einen Eigentümer oder Administrator.

Claude oder ChatGPT verbinden

Auf dem Bildschirm Lösung
„Diese Anfrage ist abgelaufen“ „Es ist zu viel Zeit vergangen, seit die App gefragt hat. Starte die Verbindung erneut aus der App heraus.“
„Diese App ist nicht registriert“ Entferne den Connector in der App und füge ihn erneut hinzu.
„Dieser Anfrage kann nicht vertraut werden“ „Es wurde nichts geteilt. Starte die Verbindung erneut aus der App heraus.“ Verbinde dich nicht, wenn dies weiterhin passiert.
„Wähle einen Workspace aus, dessen Mitglied du bist.“ Wähle einen deiner Workspaces aus.
„Widerrufen: Token-Wiederverwendung erkannt“ bei einer verbundenen App Die Anmeldung der App wurde wiederverwendet, daher hat Clevera sie widerrufen. Verbinde die App erneut.

Immer noch nicht weitergekommen

Kontaktiere den Support mit dem request_id aus der Fehlermeldung, dem Namen des Tokens (niemals dem Token selbst) und der Uhrzeit des Aufrufs.

API-Tokens verwaltenWarum ein Token nicht mehr funktioniert.Agenten-BerechtigungenWelche Berechtigung ein Aufruf benötigt.Agenten-Ausgaben und Genehmigungen steuernLimits, Kontingente und Genehmigungen.Die REST-API verwendenFehlerformat und Ratenbegrenzungen.