AIエージェントとAPIのエラーを修正する
CleveraのAPI、MCPサーバー、および「AIエージェントとAPI」ページで、AIエージェント、スクリプト、またはユーザーが表示する可能性のあるすべてのメッセージを原因別に分類しました（トークン、プラン、権限、有料作業、レート制限、競合、アプリ連携）。それぞれの修正方法も記載しています。
更新日: 読了時間 6 分
Cleveraがエージェントからの呼び出しを拒否した場合、エージェントにはコードと、対処方法を示すメッセージが返されます。この記事では、AIエージェントとAPIでエージェント、スクリプト、またはユーザーが表示する可能性のあるすべてのメッセージ、その原因、および修正方法を一覧にしています。REST API経由の場合、コードは error.code に含まれます。MCP経由の場合、同じメッセージがツールエラーとして返されます。
トークンが受け付けられません
| メッセージ | コード | 原因 | 修正方法 |
|---|---|---|---|
| "Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." | unauthenticated |
トークンが送信されていません。 | Authorization: Bearer <token> を送信してください。エージェントの実行環境で CLEVERA_TOKEN が設定されていることを確認してください。 |
| "That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." | unauthenticated |
値の入力ミス、切り捨て、またはCleveraのトークンではありません。 | トークン全体を再度貼り付けてください。 |
| "Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." | unauthenticated |
Cleveraがこのトークンを認識できません。 | 新しいトークンを作成してください。 |
| "OAuth connector tokens work on the MCP server only. Use a static token for the REST API." | unauthenticated |
接続済みアプリのサインイン情報がREST APIで使用されました。 | REST APIにはAPIトークンを使用してください。 |
| "This token has expired. Create a new one in Integrations → AI agents & API." | token_expired |
有効期限が切れています。 | 新しいトークンを作成してください。 |
| "This token was revoked." | token_revoked |
誰かが取り消した、再生成された、所有者が退職した、またはCleveraによって取り消されました。 | トークンが機能しなくなった理由 を参照してください。 |
| "The account that owns this token is suspended." | token_revoked |
トークンの所有者のアカウントが停止されています。 | サポートにお問い合わせください。 |
| "This token can't be used from this IP address." | ip_not_allowed |
トークンのIP許可リスト外から呼び出しが行われました。 | 許可されたアドレスからエージェントを実行するか、新しいアドレスでトークンを作成してください。 |
プランに含まれていません
AIエージェントとAPI（トークン、接続済みアプリ、Webhook）は、Pro、Business、およびCustomプランで利用可能です。FreeおよびStarterプランでは、ページに「AIエージェントとAPIはProに含まれています」と表示され、Proにアップグレードボタンが表示されます。アップグレードすると、既存のトークン、アプリ、Webhookが再び機能するようになります。データが削除されることはありません。
| メッセージ | コード | 原因 | 修正方法 |
|---|---|---|---|
| "The agent API is not on this workspace's plan. It is on Pro and up." | plan_locked (HTTP 403) |
ワークスペースがFreeまたはStarterプランであるか、それらのプランに変更されました。すべてのトークンおよび接続済みアプリの呼び出しが拒否されます。 | Proにアップグレードしてください。期限切れでないトークンは再び機能します。 |
| ClaudeまたはChatGPTが接続できないと表示される、またはCleveraツールが失敗する | plan_locked (内部) |
同じプラン制限です。アプリ側では一般的な接続エラーとして表示されます。 | ワークスペースをProにアップグレードし、アプリで再試行してください。 |
| "The API and agent access are not on your plan." | — | Proプラン以外でトークンを作成、またはエージェントのリクエストで 承認 をクリックした場合。 | Proにアップグレードしてください。拒否 は引き続き機能します。 |
| "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." | — | FreeまたはStarterプランでロックされているコントロールです。 | Proにアップグレードしてください。 |
| workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." | — | Proプラン以外でClaudeまたはChatGPTをワークスペースに接続しようとした場合。 | アップグレードするか、接続画面で別のワークスペースを選択してください。 |
| シークレットを再生成 をクリックするとアップグレードダイアログが開く | — | Proプラン以外ではシークレットを再生成できません。 | Proにアップグレードするか、トークンを取り消してください。 |
| "Webhooks are not on your plan." | — | Proプラン以外で テストイベントを送信 または 再配信 を行った場合。何も送信されず、待機中の再試行は plan_locked で失敗します。 |
Proにアップグレードしてください。 |
| "Your plan does not include paid agent work. Upgrade to let agents start it." | plan_locked |
有料作業が含まれていないプランでの有料作業。 | Proにアップグレードしてください。 |
トークンに許可されていません
| メッセージ | コード | 原因 | 修正方法 |
|---|---|---|---|
| "This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." | forbidden_ability |
トークンにこの呼び出しに必要な権限がありません。 | その権限を持つトークンを作成してください。エージェントの権限 を参照してください。 |
| "The token owner's current role in this workspace does not allow ability." | forbidden_role |
トークン作成後に所有者のロールが変更されました。トークンには ロールの上限を超えています と表示されます。 | 適切なロールを持つユーザーがトークンを作成してください。 |
| "Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." | — | 自分のロールを超える権限でトークンを作成しようとしています。 | 権限のチェックを外すか、オーナーまたは管理者に依頼してください。 |
| "You can't do this in this workspace." | forbidden |
所有者のロールまたはアクセス権では、このアイテムに対するこの操作が許可されていません。 | 所有者のロールとコレクションへのアクセス権を確認してください。 |
| "The token owner can view this article but not edit it (collection access)." | forbidden_item |
アイテムが、所有者が閲覧のみ可能なコレクション内にあります。 | コレクションへの編集権限を所有者に付与してください。 |
| "No item with that id in this token's scope. List or search first and use a returned id." | not_found |
IDが間違っているか、アイテムがトークンのサイト範囲外、または所有者のアクセス権外にあります。 | 一覧表示または検索を行い、返されたIDを使用してください。 |
| "This content is live on a published site, so changing it needs the site:publish ability." | live_content_needs_publish |
公開権限なしで、公開中のドキュメントサイトの記事を編集（または翻訳）しようとしています。 | トークンに site:publish を付与するか、レビュー用に送信させてください。 |
| "This article is also shown on a site this token cannot change. …" | shared_outside_scope |
記事がトークンのサイト範囲外のサイトにも表示されています。 | すべての表示サイトをカバーするトークンを使用するか、レビューメモを残してください。 |
| "This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." | site_paused |
ドキュメントサイトが一時停止されています。 | サイトを再アクティブ化してください。 |
有料作業が拒否されました
| メッセージ | コード | 原因 | 修正方法 |
|---|---|---|---|
| "This would pass the token's spend cap. A workspace admin can raise it." | cap_exceeded |
見積もりがトークンの ジョブあたり、1日あたり、または 1ヶ月あたり の上限を超えています。 | 翌日または翌月まで待つか、より高い上限を持つトークンを作成してください。 |
| クレジット不足に関するメッセージ | insufficient_credits |
ワークスペースのクレジットが不足しています。 | クレジットを購入するか、付与されるまで待ってください。 |
| "Your workspace cannot spend credits right now." | plan_locked |
支払期限などにより、請求がクレジットの使用をブロックしています。 | 請求 を確認してください。 |
| "This quote has expired. Ask for a new quote." | quote_expired |
見積もりの有効期限は15分です。 | 新しい見積もりを依頼してください。 |
| "This quote was already used. Ask for a new quote." | quote_used |
1つの見積もりで開始できるジョブは1つです。 | 新しい見積もりを依頼してください。 |
| "This quote is for another kind of job." | quote_mismatch |
動画の見積もりをクリップの開始に使用するなど、種類が一致しません。 | 一致する開始呼び出しを使用してください。 |
| "Another start is being checked. Try again in a moment." | busy |
同時に2つの開始リクエストがありました。 | 少し待ってから再試行してください。 |
ジョブが needs_input で待機中 |
— | エージェントのリクエスト で承認待ちです。 | オーナーまたは管理者が24時間以内に承認または拒否します。 |
ジョブが expired で終了 |
— | 24時間以内に決定されませんでした。 | 再度開始して承認してください。 |
| "This job can no longer be canceled." | not_cancelable |
ジョブがすでに完了しているか、キャンセル可能な時間を過ぎています。 | — |
動画リクエスト時の一般的な入力メッセージ: "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."
リクエストが多すぎます
| メッセージ | コード | 制限 |
|---|---|---|
| "This token is over its request rate. Wait and retry." | rate_limited |
トークンあたり毎分300リクエスト |
| "This workspace is over its agent request rate. Wait and retry." | rate_limited |
ワークスペースあたり毎分1,200リクエスト |
| "Too many writes from this token. Wait and retry." | rate_limited |
トークンあたり毎分60書き込み |
| "This token reached its daily write limit. Try again tomorrow." | rate_limited |
トークンあたり1日2,000書き込み |
| "This token reached its hourly publish limit. Try again later." | rate_limited |
トークンあたり1時間10公開 |
| "Too many uploads from this token. Wait and retry." | rate_limited |
毎分30アップロード |
| "This token reached its daily upload volume. Try again tomorrow." | rate_limited |
トークンあたり1日500 MB |
| "Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." | rate_limited |
異常なアクティビティ：10分間書き込みを一時停止 |
| "Too many requests. Wait and retry." | rate_limited |
有効なトークンなしでIPアドレスあたり毎分60リクエスト |
有料プランの開始回数は、トークンごとに1時間あたり20回、ワークスペースごとに1日あたり100回までに制限されています。すべての 429 には Retry-After ヘッダーが含まれています。その時間分お待ちください。
コンテンツと再試行
| メッセージ | コード | 修正方法 |
|---|---|---|
| "The content changed since you read it. Re-read it …, merge your change and retry with that id." | revision_conflict |
エージェントがページを再読み込みし、変更を再適用します。 |
| "This idempotency key was used for a different request." | idempotency_conflict / idempotency_key_reused |
新しいリクエストには新しい Idempotency-Key を使用してください。 |
| — | idempotency_in_progress |
このキーを使用した最初のリクエストがまだ実行中です。待機してから、同じキーで再試行してください。 |
トークンとページ
| 状況 | 原因 | 修正方法 |
|---|---|---|
| 新しいトークン が無効 | "Your workspace has reached its limit of 50 active tokens. Revoke one first." | 使用していないトークンを取り消してください。 |
| シークレットを再生成 オプションがない | トークンの作成者のみが、一度だけ再生成できます。 "Only the person who created this token can regenerate it. You can revoke it." | 新しいトークンを再生成するか、作成してください。 |
| "This token was already regenerated, revoked or has expired; use its replacement or create a new one." | シークレットが以前に再生成されています。 | 代替のトークンを使用してください。 |
| 同僚のトークンが表示されない | オーナーと管理者のみがすべてのトークンを確認できます。 | オーナーまたは管理者に依頼してください。 |
| リクエストを承認できない: "An owner or admin decides" | オーナーと管理者のみが支出を承認できます。 | オーナーまたは管理者に依頼してください。 |
| "Only owners and admins manage webhooks" | あなたのロールではWebhookを管理できません。 | オーナーまたは管理者に依頼してください。 |
ClaudeまたはChatGPTの接続
| 画面表示 | 修正方法 |
|---|---|
| "This request expired" | "Too much time passed since the app asked. Start connecting again from the app." |
| "This app isn’t registered" | アプリ内のコネクタを削除し、再度追加してください。 |
| "This request can’t be trusted" | "Nothing was shared. Start connecting again from the app." 繰り返し発生する場合は接続しないでください。 |
| "Choose a workspace you are a member of." | 所属しているワークスペースを選択してください。 |
| "Revoked: token reuse detected" on a connected app | アプリのサインインが再利用されたため、Cleveraが取り消しました。アプリを再度接続してください。 |
解決しない場合
エラーに含まれる request_id、トークン名（トークン自体は含めないでください）、および呼び出し時刻を添えてサポートまでお問い合わせください。