roboflow-cloud-storage

エージェント向け： このスキルは roboflow/computer-vision-skills で作成されています。クライアントにすでにスキルとして読み込まれている場合（Roboflow プラグインなど）、そのコピーを使用してください。roboflow://skills/<name>/... MCP リソースは、スキルが読み込まれていないクライアントに同じスキルを提供します。

クラウドストレージ（データソースと認証情報）

クラウドバケットのコンテンツを Roboflow ワークスペースにミラーリングすると、新しいオブジェクトが自動的に取り込まれます。次の2つが連携します。

• 認証情報 — Roboflow がバケットにアクセスするために使用するシークレットです（サーバー側で保存・マスキングされ、複数のデータソースで再利用できます）。
• データソース — バケットミラーの設定です。認証情報を使って指定するバケット、対象オブジェクト（glob ルール）、同期方法を定義します。「データソース」はユーザー向けの名称で、プラットフォーム上ではバケットミラー設定として保存されます。

インポート先はワークスペースレベルです。現在、データソース API では特定のプロジェクト／データセットを指定できません。

Roboflow に何もインポートせず、ファイルに対してモデル／Workflow を実行して出力を収集するだけの場合は、バッチ処理を使用します。roboflow-batch-processing スキルを参照してください。ミラーリングと組み合わせることもできます。インポートしたファイルはアセットライブラリの画像になり、それらに対する一括予測はアセットライブラリのバッチ処理ジョブとして実行されます（同じスキルを使用）。

最短手順 — 1回の呼び出し

connect_cloud_storage は、認証情報の作成（任意）、データソースの作成、アクセスの検証、最初のミラー実行の開始までを一度に行います。新しい環境の設定には、こちらを推奨します。

• 認証情報を再利用する場合は、credential_id（credentials_list から取得）を渡します。
• 新しい認証情報を作成する場合は、credential_name と credential_type を渡します（シークレットは別経路で安全に収集されます。セキュリティを参照してください）。
• データソースを先に作成できるよう、bucket_type（s3／gcs）、bucket_name、region、および任意の mirror_configs glob ルール（データソースを参照）を指定します。検証や実行を開始する前に、データソースが存在している必要があります。データソースがなければミラーリングするものがありません。
• trigger（デフォルトは true）を指定すると、検証に成功した場合にのみミラー実行を開始します。実行にはクレジットを消費します。
• {credentialId, credentialCreated, datasourceId, validation, triggered, batchIds?} を返します。新しい認証情報を作成した後、後続の手順で失敗した場合は、ID とともに status: "partial" が返されます。credentials_delete／datasource_delete で削除できます。

認証情報

セキュリティ — シークレットがチャットに入ることはありません

シークレット（キー、サービスアカウントの JSON、パスワード）は、MCP elicitation を介して別経路で収集され、ツール引数、トランスクリプト、モデルコンテキストには含まれません。credentials_list が返すのは、マスキングされた非シークレット項目のみです。 クライアントが安全な入力収集に対応していない場合、ツールは manual_entry_required と、アプリ内で認証情報を作成するための URL（app.roboflow.com/<workspace>/settings/datasources）を返します。その後、credentials_list を呼び出して ID を取得してください。

認証情報の種類

credential_type	プロバイダー	収集されるシークレット項目
IAM	AWS S3	accessKeyId、secretAccessKey、sessionToken?
AssumeRole	AWS S3	roleArn、externalId、sessionName?
AssumeRoleWithWebIdentity	AWS S3	roleArn、webIdentityAudience、webIdentityRoleArn、externalId、sessionName?
gcs	Google Cloud Storage	projectId、credentialFile（サービスアカウントの完全な JSON）
usernamePassword	S3 互換	username、password
apiKey	S3 互換	apiKey

**AWS PrivateLink（require_vpce）**には AssumeRoleWithWebIdentity 認証情報が必要です。これ以外の場合、サーバーはデータソースを拒否します。

データソース

バケット

• bucket_type：s3 または gcs
• bucket_name（スキーム／パスなし）、region（例：us-east-1）
• endpoint：S3 互換プロバイダー用のカスタム URL（S3 のみ）

ミラールール（mirror_configs）

省略可能なリストです。省略すると、デフォルト設定でバケット全体をミラーリングします。各ルールで対象のサブセットを選択し、同期動作を制御します。

• glob_patterns（リスト） — 主要なフィールドです。["images/**/*.jpg", "batch-*/**"] のように、オブジェクトを選択します。不要なファイルのインポートを避けたり、バケットを複数のルールに分割したりする場合に設定します。本当にすべてを対象にする場合に限り、省略してください。
• glob_file_path — 代替手段です。インポートするオブジェクトのパスを列挙した行を含む、バケット内のマニフェストファイルへのパスです。
• id — ルール ID（自動生成されます。既存の ID を渡すと、インプレースで編集できます）。
• settings（省略したキーにはサーバーのデフォルト値が適用されます）：
  • removeOrphanedSourcesWhenDisappeared（デフォルトは true） — ソースオブジェクトが削除されたとき、ミラーリング済みの画像を削除します。
  • namingStrategy（fullPath|fileName|eTag|metadata、デフォルトはfullPath）。metadata を指定する場合は、namingStrategyMetadataKey が必要です。
  • updateImageWhenNewer（true） / updateImageStrategy（overwrite）。
  • updateMetadataWhenNewer（true） / updateMetadataStrategy（デフォルトはmergeBucketWins。ほかにoverwrite|merge|mergeUserWins|untilFirstChange|append）。
  • runScheduledEvery（時間単位、デフォルトは 0 = オフ） — >0 にすると、定期的なミラーリングが有効になります（現時点では 24 時間間隔で固定されており、オン／オフのみが反映されます）。

ライフサイクルと検証

1. 作成（datasource_create または connect_cloud_storage）。まだミラーリングは行われません。
2. 検証（datasource_validate） — listFiles、headFile、getFile、およびルールごとの headGlobFile を確認し、{checks, errors} を返します。トリガーを実行する前に、認証情報やバケットに問題がないか自己診断するために実行してください。
3. トリガー（datasource_trigger） — ミラージョブを開始します。コンピューティング／ストレージクレジットを消費します。{batchIds} を返します。
4. ポーリング（batchId を指定して datasource_job_get） — status（running/completed/failed）、ステージごとのcounters、errors、タイムスタンプを返します。

更新（datasource_update）：渡したフィールドのみが変更されます。バケットを変更するには、bucket_type + bucket_name + region をまとめて渡してください。 削除（datasource_delete）：設定を削除します。ミラーリング済みの画像は削除されません。データソースから参照されている認証情報を削除すると、そのデータソースの実行は失敗します。

利用可能な MCP ツール

ツール	目的
connect_cloud_storage	エンドツーエンドの処理：認証情報 + データソース + 検証 + 初回実行
credentials_list	マスキングされたクラウドストレージ認証情報の一覧表示
get_aws_storage_credential_setup_link	AWS ストレージ認証情報を設定するための Roboflow アプリのリンクを取得します。シークレットはアプリで入力します
credentials_delete	認証情報を削除します
datasources_list / datasource_get	データソース設定の一覧表示／確認
datasource_create / datasource_update / datasource_delete	データソースを管理します
datasource_validate	実行前にバケットへのアクセスを確認します
datasource_trigger	ミラーリングを開始します（クレジットを消費します）
datasource_job_get	ミラーリングの実行状況とカウンターをポーリングします

関連ページ

• roboflow://skills/roboflow-data-management/SKILL — ミラーリング後の画像の扱い方（タグ、分割、バージョン、検索）
• roboflow://skills/roboflow-product-navigation/SKILL — アプリのsettings/datasourcesページ