権限とロール
作品ごとのロール（閲覧者・編集者・管理者）と、機能ごとに必要な権限、メンバー追加やログインでつまずいたときの対処です。
Mage Search でできることは、付与された**権限（ロール）**によって変わります。ここでは利用者が知っておくとよい範囲をまとめます。
プロジェクト（作品）ロール
作品ごとに、次の 3 段階のロールがあります（右にいくほど強い権限）。
| ロール | できること |
|---|---|
| 閲覧者 | 動画・カットの閲覧と検索。 |
| 編集者 | 閲覧者の権限に加え、台詞・キャラクター・制作情報の編集、保存フォルダの作成・共有、台本・設定資料・素材のアップロードなど。 |
| 管理者 | 編集者の権限に加え、動画のアップロード／AI 処理（自動カット割）／削除、プロジェクト設定・メンバー管理など。 |
機能ごとの必要権限（目安）
| 操作 | 閲覧者 | 編集者 | 管理者 |
|---|---|---|---|
| 動画・カットの閲覧・検索 | ✅ | ✅ | ✅ |
| 台詞・キャラクター・制作情報の編集 | — | ✅ | ✅ |
| 保存フォルダの作成・編集・共有 | — | ✅ | ✅ |
| 台本・設定資料・素材のアップロード | — | ✅ | ✅ |
| 動画のアップロード | — | — | ✅ |
| 動画の AI 処理（自動カット割） | — | — | ✅ |
| 動画の削除・AI 結果のリセット | — | — | ✅ |
| プロジェクト設定・メンバー管理 | — | — | ✅ |
編集者と管理者の境目は「動画そのものの操作」です。台本や設定資料のアップロード・各種メタデータの編集は編集者でも可能ですが、動画のアップロードと AI 処理は管理者のみが行えます。
そのほかの権限
- 組織管理者 — 組織配下の作品全体を管理できます（メンバー管理・アクセス管理など）。
- システム管理者（AI Mage 運営） — すべての作品・機能を扱えます。Box 連携による大容量取り込みなどはこの権限が必要です（データ登録）。
- API キー — 開発者向け設定から発行できます。閲覧専用スコープの API キーは、読み取り以外の操作ができません。
メンバーを追加する（管理者向け）
組織管理者は、次の手順でメンバーを追加できます。
- 画面左下の アカウント → 管理ダッシュボード を開きます。
- 組織 タブから 新規ユーザーを作成 します。
- 現在のプロジェクト タブから、作成したユーザーを対象の作品にアサインします。
1 つの組織の中に複数の作品スペースを持てる設計のため、「ユーザー作成」と「作品へのアサイン」が別の操作に分かれています。
ログイン・招待でつまずいたら
- 作品のページに入れない — まず、正式なワークスペースのメールアドレスでログインしているかを確認してください。別アカウントでログインしていると目的の作品が表示されないことがあります。正しいアドレスでログインし直すと解決する場合が多いです。
- 招待されたのにログイン先を選ぶ画面が出て混乱する — 別ワークスペースのアカウントから招待されると起こりえます。いったんそのプロジェクトから退出し、正式なワークスペースの管理者から招待し直してもらうとすっきりします。
権限が足りないと感じたら
編集・登録などのボタンが表示されない、または押せない場合は、権限が不足している可能性があります。作品の管理者に権限の付与を依頼してください。関連: 共通操作 / よくある質問。