mcp-preflight

MCP の事前確認

ImageKit には、ホスト型の MCP サーバーが 3 つあります。作業に合ったものを呼び出してください。

作業	サーバー	次の手順
検索、アップロード、整理、タグ付け、共有、メタデータ、コレクション、パスのポリシー、公開リンク、キャッシュのパージ	DAM（https://imagekit.io/mcp/dam）	検索、アップロード、共有、または AI 関連の作業では、以下のスキルを参照してください
オリジン／外部ストレージ（S3、GCS、Azure、ウェブサーバーなど）	Admin（https://imagekit.io/mcp/admin）	list_origins、create_origin、get_origin、update_origin、delete_origin
URL エンドポイント	Admin	list_url_endpoints、create_url_endpoint、get_url_endpoint、update_url_endpoint、delete_url_endpoint
アカウントの使用量合計または使用状況の分析	Admin	get_account_usage、get_account_usage_analytics
「〜するには？」，API／SDK の詳細、機能の有無	DevTools の search_docs	まず search-docs スキルを読んでください
変換 URL の作成	DevTools の transformation_builder	まず transformation-builder スキルを読んでください
アプリ、CMS、またはフレームワークへの ImageKit の統合	—	imagekit-integrations を読んで SDK／プラグインを選び、その後、詳細を search_docs で確認してください

DAM と Admin にはそれぞれ別の接続と ImageKit へのサインインが必要です。DevTools には必要ありません。必要なツールが見つからない場合、そのサーバーに接続していないか、必要な権限を付与していません。

スキルが役立つ場合

ほとんどの DAM および Admin のツールは、その用途が明らかです。ツールのスキーマだけでは分かりにくい呼び出し規約があるため、以下の場合に限り、対応するスキルを読んでください。

作業	スキル
アセットの検索／フィルター／一覧表示	search-assets — Lucene の searchQuery を使用します。また、推測で指定する前に、カスタムメタデータフィールドとタグを確認する必要があります
ファイルのアップロード	upload-files — ピッカーと署名付きアップロードの使い分け。ファイルのバイト列をチャットに貼り付けないでください
ファイル、フォルダー、またはコレクションにアクセスできるユーザーの確認、アクセス権の付与または取り消し	asset-access-control — ファイル／フォルダーの ACL ツールとコレクションの ACL ツールは異なります
AI によるタグ付け／メタデータ／QC ワークフローの作成または適用	ai-tasks — ペイロードの形式、語彙、および保存済みの拡張機能への関連付け方法
使用する SDK、プラグイン、またはウィジェットの選定	imagekit-integrations — その後、実装の詳細を search_docs で確認してください

ルール

1. メディアライブラリには DAM を使用します。オリジン、URL エンドポイント、使用量、使用状況の分析には Admin を使用します。 DAM でオリジンや使用量を検索したり、Admin でファイル用ツールを探したりしないでください。
2. ファイルのバイト列をインラインで渡さないでください（base64 や、ファイルの内容としてのパスも不可）。upload-files を参照してください。
3. search_media_library を使って、サーバー側で検索をフィルターしてください。 search-assets を参照してください。
4. 変換 URL を手作業で作成する代わりに、transformation_builder を使用してください。
5. ImageKit の統合コードを書く前に、search_docs を使用してください。 メソッド名やパラメーターを学習データに頼らないでください。まず SDK またはプラグインを選ぶ必要がある場合は、imagekit-integrations を読んでください。