asset-access-control について
DAM MCP ツールでファイル、フォルダー、メディアコレクションのアクセス権を管理するスキルです。アセットの特定、ACL の確認、権限変更を案内し、ID の推測やツールの使い分けの誤りを防ぎます。
主な機能
- 01名前やパスによるアセット検索
- 02ファイルとフォルダーの ACL 確認
- 03メディアコレクションの ACL 確認
- 04権限の追加・変更・削除
- 05コレクション所属とアクセス権の区別
活用シーン
- 01ユーザーへのファイルアクセス権の付与
- 02グループのフォルダー権限の更新
- 03メディアコレクションのアクセス権変更
- 04アセットが属するコレクションの確認
MCP 対応
DAM MCP ツールを使ってアセットを検索し、ファイル、フォルダー、メディアコレクションのアクセスリストを読み書きします。アセット ACL、コレクション ACL、コレクション所属にはそれぞれ別のツールを指定します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ imagekit-developer/ skills --skill asset-access-controlインストール後、Claude Code で/asset-access-controlを入力して読み込まれたか確認します。
詳細
アセットのアクセス制御
DAM MCP ツールを使用してください。対象は 2 種類あります。各対象のツールを混在させないでください。
| 対象 | ACL の読み取り | ACL の書き込み |
|---|---|---|
| ファイルまたはフォルダー | get_asset_access_list | update_asset_acl |
| メディアコレクション | get_collection_access_list | update_media_collection(acl) |
list_associated_media_collections で確認できるのは、「このファイル/フォルダーを含むコレクションはどれか?」だけです。メンバーシップは変更されません。add_assets_to_media_collection/remove_assets_from_media_collection を使用してください。
制限付きユーザーがアクセスを変更できるのは、自分が管理できるアセットに限られます。
ワークフロー
- 名前またはパスしかわからない場合は、
search_media_libraryでアセットを特定します。 - 現在の ACL を読み取ります。その応答に含まれる
userId/groupIdを使用し、ID を推測してはいけません。 - 変更を書き込みます。確認が必要な場合は、その後もう一度読み取ります。
get_asset_access_list は、アカウントの users と userGroups も返します。ユーザーが指定した人物を userName/userEmail/label と照合してください。
update_asset_acl
- 常に
acl.addOrModifyとacl.removeの両方を送信してください。使用しない側には[]を指定します。 entity.typeに指定できるのはUSERまたはUSER_GROUPのみです。読み取り時にはMEDIA_COLLECTIONが現れることがあります(継承されたメンバーシップ)。書き込み時には送信しないでください。- アセット所有者のエントリーは変更しないでください。
- 同じエンティティに対して、親フォルダーがすでに許可している範囲より少ないアクセス権を付与しないでください。
{
"assetId": "<file-or-folder-id>",
"acl": {
"addOrModify": [{ "entity": { "id": "<userId>", "type": "USER" }, "permission": "READ" }],
"remove": []
}
}
list_associated_media_collections
permission は配列ではなく文字列です。'["MANAGE"]' または '["READ","CONTRIBUTE"]' を送信してください。制限付きユーザー向けに絞り込む場合を除き、省略してください。