AIエージェントとAPIについて
Claude、ChatGPT、Claude Code、Codex、CursorなどのAIエージェントがCleveraワークスペースでできること、接続方法、プラン（Pro以上）、制限、権限、コスト、安全性について解説します。
AIエージェントとAPIを使用すると、Claude、ChatGPT、Claude Code、Codex、CursorなどのAIアプリや独自のスクリプトをCleveraワークスペースで活用できます。録画の検索、動画・ソーシャルクリップ・記事の作成依頼、動画のエクスポート、ドキュメントサイトの編集などが可能です。各エージェントに許可する操作、使用可能なクレジット数、人間による承認が必要なタイミングを細かく設定できます。
エージェントでできること
| エリア | エージェントでできること |
|---|---|
| 動画 | 録画、動画、記事、トランスクリプトの一覧表示と読み取り。録画からのハウツー動画、製品デモ動画、クリーンアップ動画、スタイライズ動画、ソーシャルクリップ、記事、動画翻訳の作成依頼。最大4KのMP4エクスポート。アップロードへの画像、動画、PDFの追加。 |
| ドキュメントサイト | ドキュメントサイトページの読み取り、下書き、整理、翻訳、公開、変更履歴の管理。公開ページに対する読者からの質問への回答。読者インサイトの閲覧。サイト設定の変更やサイトの作成。 |
現時点では、エージェントによるWebサイトのリサーチや録画されたウォークスルーの実行はできません。
エージェントが依頼を行い、CleveraのAIがアプリ内で実行する場合と同じように動画や記事を作成します。エージェントが閲覧できる範囲は、そのトークンの所有者が閲覧できる範囲を超えることはありません。非公開コレクション内の録画は、トークンの所有者にアクセス権がない限り非表示のままです。
接続方法
| 方法 | 用途 | 設定場所 |
|---|---|---|
| APIトークン | Claude Code、Codex CLI、Cursor、MCPクライアント、REST API経由の独自スクリプト | トークン → 新しいトークン。APIトークンの作成を参照してください。 |
| 接続済みアプリ | Claude (claude.ai) およびChatGPT（カスタムコネクタとして使用）。トークン不要、サインインのみ | 接続済みアプリにあるコネクタURLを使用してアプリ側で設定。AIアプリとエージェントの接続を参照してください。 |
| REST API | スクリプトおよびバックエンドサービス | APIトークン。REST APIの使用を参照してください。 |
MCPサーバーは https://app.clevera.ai/mcp であり、REST APIは https://app.clevera.ai/api/v1 にあります。
ページを見つける
ワークスペースメニューを開き、AIエージェントとAPIを選択します。ドキュメントサイトでは、Docsのホーム画面やサイトの設定メニューからもアクセスできます。このページ（「Claude、Codex、ChatGPT、および独自のスクリプトをこのワークスペースで実行」）には5つのタブがあり、それぞれに件数が表示されます。
| タブ | 内容 |
|---|---|
| トークン | APIトークン。所有者と管理者はすべてのトークンを確認できます。APIトークンの管理 |
| 接続済みアプリ | コネクタURLおよび接続されたアプリ。AIアプリとエージェントの接続 |
| エージェントのリクエスト | 人間の承認待ちの有料タスク（件数バッジ付き）および履歴。エージェントの支出と承認の管理 |
| Webhook | 独自のシステムへの署名付き通知。Webhookの設定 |
| アクティビティ | エージェントの実行履歴。エージェントのアクティビティを読む |
プラン
AIエージェントとAPIは、Pro、ビジネス、カスタムプランで利用可能です。これにはAPIトークン、ClaudeおよびChatGPT用コネクタ、Webhookが含まれます。
FreeおよびStarterプランでは、ページに「AIエージェントとAPIはProに含まれています」と表示されます。「アップグレードして、Claude、ChatGPT、独自のスクリプトをこのワークスペースで実行しましょう。既存のトークンやアプリはそれまで動作を停止しますが、ここから取り消すことは可能です。」Proにアップグレードをクリックしてください。ロックされたコントロールには「APIとエージェントへのアクセスはPro以上で利用可能です」、「Claude.aiおよびChatGPTコネクタはPro以上で利用可能です」、「WebhookはPro以上で利用可能です」と表示されます。
| 制限 | Pro、ビジネス、カスタム |
|---|---|
| ワークスペースごとの有効なAPIトークン数 | 50 |
| 1人あたりの接続済みアプリ数 | 20 |
| ワークスペースごとのWebhook数 | 10 |
| 以下を自動的に承認 の上限 | Proおよびビジネス：500クレジット。カスタム：1,000クレジット。 |
ワークスペースがProプランを終了した場合
データは削除されませんが、再度アップグレードするまで以下の機能が一時停止されます。
| StarterまたはFreeへ移行後 | |
|---|---|
| APIトークン | リストには残り、取り消しは可能。すべての呼び出しが拒否されます：「エージェントAPIはこのワークスペースのプランに含まれていません。Pro以上で利用可能です。」再生成はできません（シークレットを再生成をクリックするとアップグレードダイアログが開きます）。 |
| 接続済みアプリ | リストには残り、接続解除は可能。呼び出しは失敗します。ClaudeやChatGPTは接続できなかった旨のメッセージを表示する場合があります。 |
| Webhook | リストには残りますが、通知は送信されません。テストイベントを送信および再配信は「Webhookは現在のプランに含まれていません」と表示します。 |
| エージェントのリクエスト | 承認をクリックすると「APIとエージェントへのアクセスは現在のプランに含まれていません」と表示されます。拒否は引き続き機能します。 |
| 新しいトークン | 「APIとエージェントへのアクセスは現在のプランに含まれていません」と表示されます。 |
Proに再度アップグレードすると、トークン、アプリ、Webhookが再び機能するようになります。トークンの有効期限は元のままです。
権限について
エージェントは、そのトークンを作成または接続したユーザーとして、そのユーザーのロールが許可する範囲内で動作します。ユーザーがアプリ内で実行できる範囲を超えることはなく、呼び出しのたびにロールがチェックされるため、ロールの変更は即座に反映されます。
| タスク | 所有者 | 管理者 | エディター | コンテンツクリエイター |
|---|---|---|---|---|
| 自分のトークン作成とアプリ接続 | はい | はい | はい | はい |
| ワークスペース内の全トークン・アプリの閲覧と取り消し | はい | はい | 自分のもののみ | 自分のもののみ |
| エージェントへの動画作成依頼とクレジット使用の許可 | はい | はい | いいえ | はい |
| エージェントへのドキュメントサイト公開の許可 | はい | はい | はい | いいえ |
| エージェントによる有料タスクの承認 | はい | はい | いいえ | いいえ |
| Webhookの管理 | はい | はい | いいえ | いいえ |
詳細なリストはエージェントの権限をご覧ください。
コストについて
- APIおよびMCPの呼び出しは無料です。読み取り、検索、引用、ジョブの確認、動画のエクスポートにはクレジットは消費されません。
- AIを使用する作業（動画、ソーシャルクリップ、録画からの記事作成、翻訳、AI生成のサイトページ）には、アプリ内で実行する場合と同様にクレジットが消費されます。
- エージェントは、
credits:spendを持つトークンでのみ有料タスクを開始できます。開始のたびにまず見積もりが提示され、トークンの支出上限と照合されます。トークンの 以下を自動的に承認 の設定を下回らない限り、人間による承認が必要です。エージェントの支出と承認の管理を参照してください。
Cleveraの安全対策
- トークンには必ず有効期限があります：7日、30日、90日、または1年。「無期限」の設定はありません。
- シークレットは一度しか表示されません。 Cleveraはフィンガープリントのみを保存し、末尾の4文字のみを表示します。
- 最小権限の原則。 各トークンには、選択した権限、ドキュメントサイト、IPアドレスのみが割り当てられます。
- 人間による支払い承認。 エージェントは自身の支出を承認できません。ワークスペースの所有者または管理者のみが承認可能です。
- 漏洩したトークンの取り消し。 公開GitHubリポジトリで発見されたCleveraトークンは自動的に取り消されます。
- 異常なアクティビティの停止。 拒否された呼び出しが多発した場合はトークンが取り消されます。変更や支出が急増した場合は一時停止され、所有者に通知されます。
- すべてのアクティビティが記録されます。 アクティビティに13ヶ月間保存されます。エージェントによるドキュメントサイトの編集は、ページ履歴に「エージェント 名前 (トークン)」として表示されます。