dropbox-automation

Rube MCP による Dropbox の自動化

Composio の Dropbox ツールキットを通じて、ファイルのアップロード／ダウンロード、検索、フォルダー管理、共有リンクの作成、一括操作、メタデータの取得など、Dropbox の操作を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/dropbox

前提条件

• Rube MCP に接続している必要があります（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を通じて Dropbox に接続済みである必要があります（ツールキット dropbox）
• 必ず最初に RUBE_SEARCH_TOOLS を呼び出し、最新のツールスキーマを取得してください

セットアップ

Rube MCP を入手する：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加してください。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを検証します
2. ツールキット dropbox を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Dropbox の OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. ファイルとフォルダーを検索する

使用する場面：名前、内容、種類でファイルやフォルダーを見つけたい場合

ツールの順序：

1. DROPBOX_SEARCH_FILE_OR_FOLDER - クエリ文字列と、任意のパス範囲およびフィルターを指定して検索します［必須］
2. DROPBOX_SEARCH_CONTINUE - カーソルを使用して追加の結果をページネーションします［has_more がある場合は必須］
3. DROPBOX_GET_METADATA - 検索結果の正規パスを検証して取得します［任意］
4. DROPBOX_READ_FILE - ファイルの内容を読み取り、目的のドキュメントであることを確認します［任意］

主なパラメーター：

• query：検索文字列（大文字と小文字を区別せず、空白以外の文字が1文字以上必要）
• options.path：検索範囲をフォルダーに限定します（例："/Documents"）。ルートの場合は空文字列を指定します
• options.file_categories：種類で絞り込みます（"image"、"document"、"pdf"、"folder" など）
• options.file_extensions：拡張子で絞り込みます（例：["jpg", "png"]）
• options.filename_only：ファイル名のみを照合するには true を設定します（内容は対象外）
• options.max_results：1ページあたりの結果数（デフォルトは100、最大1000）

注意点：

• さらに結果がある場合、検索では has_more: true と cursor が返されます。該当結果の見落としを防ぐため、必ず続きを取得してください
• 検索と search_continue の全ページを通じた一致件数の上限は10,000件です
• DROPBOX_GET_METADATA が返す path_display は、ユーザー入力と大文字・小文字が異なる場合があります。必ず返された正規パスを使用してください
• DROPBOX_READ_FILE のファイル内容は、base64 エンコードされた file_content_bytes として返される場合があります。解析する前にデコードしてください

2. ファイルをアップロード／ダウンロードする

使用する場面：Dropbox にファイルをアップロードしたい場合、または Dropbox からファイルをダウンロードしたい場合

ツールの順序：

1. DROPBOX_UPLOAD_FILE - 指定したパスにファイルをアップロードします［アップロードには必須］
2. DROPBOX_READ_FILE - Dropbox からファイルをダウンロード／読み取ります［ダウンロードには必須］
3. DROPBOX_DOWNLOAD_ZIP - フォルダー全体を zip ファイルとしてダウンロードします［任意］
4. DROPBOX_SAVE_URL - 公開 URL からファイルを Dropbox に直接保存します［任意］
5. DROPBOX_GET_SHARED_LINK_FILE - 共有リンクの URL からファイルをダウンロードします［任意］
6. DROPBOX_EXPORT_FILE - Dropbox Paper など、ダウンロードできないファイルを Markdown／HTML にエクスポートします［任意］

主なパラメーター：

• path：Dropbox のパス（"/Documents/report.pdf" のように / で始まる必要があります）
• mode："add"（デフォルト。競合時は失敗）または、アップロード時に競合ファイルを上書きする "overwrite"
• autorename：競合時に失敗せず、自動で名前を変更するには true を指定します
• content：アップロード用の s3key、mimetype、name を含む FileUploadable オブジェクト
• url：DROPBOX_SAVE_URL 用の公開 URL
• export_format：Paper ドキュメント用の "markdown"、"html"、または "plain_text"

注意点：

• DROPBOX_SAVE_URL は非同期で、大きなファイルの場合、最大15分かかることがあります
• DROPBOX_DOWNLOAD_ZIP でダウンロードするフォルダーは20 GB未満で、4 GBを超えるファイルを含まず、エントリー数が10,000件未満である必要があります
• DROPBOX_READ_FILE の内容は base64 エンコードされている場合があります。レスポンス形式を確認してください
• DROPBOX_GET_SHARED_LINK_FILE を使った共有リンクからのダウンロードでは、保護されたリンクに link_password が必要な場合があります

3. ファイルの共有とリンクの管理

使用する状況：ユーザーが共有リンクを作成したい場合、または既存の共有リンクを管理したい場合

ツールの順序：

1. DROPBOX_GET_METADATA - ファイル／フォルダーが存在することを確認し、正規のパスを取得します［前提条件］
2. DROPBOX_LIST_SHARED_LINKS - 既存の共有リンクを確認して重複を避けます［前提条件］
3. DROPBOX_CREATE_SHARED_LINK - 新しい共有リンクを作成します［必須］
4. DROPBOX_GET_SHARED_LINK_METADATA - 共有リンクの URL からメタデータを取得します［任意］
5. DROPBOX_LIST_SHARED_FOLDERS - ユーザーがアクセスできる共有フォルダーをすべて一覧表示します［任意］

主なパラメーター：

• path：リンクを作成するファイルまたはフォルダーのパス
• settings.audience："public"、"team"、または "no_one"
• settings.access："viewer" または "editor"
• settings.expires：ISO 8601 形式の有効期限（例："2026-12-31T23:59:59Z"）
• settings.require_password / settings.link_password：パスワード保護
• settings.allow_download：ダウンロードを許可するかどうかを示すブール値
• direct_only：LIST_SHARED_LINKS で true に設定すると、直接のリンクのみを返します（親フォルダーのリンクは返しません）

注意点：

• パスに対する共有リンクがすでに存在する場合、DROPBOX_CREATE_SHARED_LINK は 409 Conflict エラーで失敗します。先に DROPBOX_LIST_SHARED_LINKS で確認してください
• path/not_found エラーを避けるため、リンクを作成する前に必ず DROPBOX_GET_METADATA でパスを検証してください
• 重複を作成するのではなく、DROPBOX_LIST_SHARED_LINKS の既存リンクを再利用してください
• requested_visibility は非推奨です。新しい実装では audience を使用してください

4. フォルダーの管理（作成、移動、削除）

使用する状況：ユーザーがファイルやフォルダーを作成、移動、名前変更、または削除したい場合

ツールの順序：

1. DROPBOX_CREATE_FOLDER - フォルダーを 1 つ作成します［作成時に必須］
2. DROPBOX_CREATE_FOLDER_BATCH - 複数のフォルダーを一度に作成します［任意］
3. DROPBOX_MOVE_FILE_OR_FOLDER - ファイルまたはフォルダーを 1 つ移動または名前変更します［移動時に必須］
4. DROPBOX_MOVE_BATCH - 複数の項目を一度に移動します［任意］
5. DROPBOX_DELETE_FILE_OR_FOLDER - ファイルまたはフォルダーを 1 つ削除します［削除時に必須］
6. DROPBOX_DELETE_BATCH - 複数の項目を一度に削除します［任意］
7. DROPBOX_COPY_FILE_OR_FOLDER - ファイルまたはフォルダーを新しい場所にコピーします［任意］
8. DROPBOX_CHECK_MOVE_BATCH / DROPBOX_CHECK_FOLDER_BATCH - 非同期の一括処理のステータスを確認します［一括操作時に必須］

主なパラメーター：

• path：対象のパス（/ で始まる必要があり、大文字と小文字が区別されます）
• from_path / to_path：移動またはコピー操作のコピー元とコピー先
• autorename：競合時に自動で名前を変更するには true を指定します
• entries：一括移動では {from_path, to_path} の配列、一括作成ではパスの配列
• allow_shared_folder：共有フォルダーの移動を許可するには true を指定します
• allow_ownership_transfer：移動によって所有権が変更される場合は true を指定します

注意点：

• すべてのパスで大文字と小文字が区別され、/ で始まる必要があります
• パスの末尾に / や空白を付けてはいけません
• 一括操作は非同期で実行される場合があります。DROPBOX_CHECK_MOVE_BATCH または DROPBOX_CHECK_FOLDER_BATCH で確認してください
• DROPBOX_FILES_MOVE_BATCH（v1）は「全か無か」の動作をするため、エントリーが 1 つでも失敗すると一括処理全体が失敗します
• DROPBOX_FILES_MOVE_BATCH（v1）より DROPBOX_MOVE_BATCH（v2）が推奨されます
• 一括削除／移動では最大 1000 エントリー、一括フォルダー作成では最大 10,000 パスを指定できます
• 大文字と小文字だけを変更する名前変更は、一括移動操作ではサポートされていません

5. フォルダーの内容を一覧表示する

使用する場面：ユーザーが Dropbox フォルダー内のファイルを確認または列挙したい場合

ツールの順序：

1. DROPBOX_LIST_FILES_IN_FOLDER - フォルダーの内容を一覧表示します［必須］
2. DROPBOX_LIST_FOLDERS - 削除済みの項目にも対応した代替のフォルダー一覧表示です［任意］
3. DROPBOX_GET_METADATA - 特定の項目の詳細を取得します［任意］

主なパラメーター：

• path：フォルダーのパス（ルートの場合は空文字列 ""）
• recursive：すべての階層の内容を一覧表示するには true を指定します
• limit：リクエストごとの最大結果数（デフォルト／最大値は 2000）
• include_deleted：復元可能な削除済み項目も含めるには true を指定します
• include_media_info：写真や動画のメタデータを取得するには true を指定します

注意点：

• ルートフォルダーには "/" ではなく空文字列 "" を使用します
• 再帰的な一覧表示では結果が非常に多くなる場合があります。limit を使ってページサイズを調整してください
• limit が小さくても、結果がカーソルを使ってページ分割されることがあります
• パスが正しくない場合、DROPBOX_LIST_FILES_IN_FOLDER は 409 Conflict と path/not_found を返します

よくあるパターン

ID の解決

• パスベース：ほとんどの Dropbox ツールではパス文字列を使用します（例："/Documents/file.pdf"）
• ID ベース：一部のツールでは id:... 形式を受け付けます（例："id:4g0reWVRsAAAAAAAAAAAQ"）
• 正規パス：後続の呼び出しには、DROPBOX_GET_METADATA のレスポンスに含まれる path_display または path_lower を必ず使用してください
• 共有リンク URL：DROPBOX_GET_SHARED_LINK_METADATA を使用して、URL をパス／ID に解決します

ページネーション

Dropbox では、ほとんどのエンドポイントでカーソルベースのページネーションを使用します：

• 検索：has_more と cursor を引き継ぎ、DROPBOX_SEARCH_CONTINUE を使います（一致件数の合計は最大 10,000 件）
• フォルダー一覧：次のページがなくなるまで、レスポンスのカーソルを引き継ぎます
• 共有リンク：DROPBOX_LIST_SHARED_LINKS の has_more と cursor を引き継ぎます
• バッチジョブのステータス：DROPBOX_CHECK_MOVE_BATCH／DROPBOX_CHECK_FOLDER_BATCH でポーリングします

非同期処理

Dropbox の操作のうち、いくつかは非同期で実行されます：

• DROPBOX_SAVE_URL - ジョブ ID を返します。ポーリングするか、wait: true を設定してください（デフォルトで最大 120 秒）
• DROPBOX_MOVE_BATCH／DROPBOX_FILES_MOVE_BATCH - ジョブ ID を返す場合があります
• DROPBOX_CREATE_FOLDER_BATCH - ジョブ ID を返す場合があります
• DROPBOX_DELETE_BATCH - ジョブ ID を返します

既知の注意点

パスの形式

• 一部のエンドポイントでルートに空文字列を指定する場合を除き、すべてのパスは / で始まる必要があります
• パスの末尾に / を付けたり、末尾に空白を含めたりしてはいけません
• 書き込み操作では、パスの大文字と小文字が区別されます
• API から返される path_display の大文字と小文字はユーザー入力と異なる場合があります。必ず API が返したパスを優先してください

レート制限

• Dropbox API にはエンドポイントごとのレート制限があります。バッチ操作を使うと呼び出し回数を減らせます
• 検索では、ページネーション全体で一致件数が合計 10,000 件に制限されます
• 大きなファイルの場合、DROPBOX_SAVE_URL のタイムアウトは 15 分です

ファイルの内容

• DROPBOX_READ_FILE は、コンテンツを base64 エンコードされた file_content_bytes として返す場合があります
• ダウンロードできないファイル（Dropbox Paper、Google Docs）には、代わりに DROPBOX_EXPORT_FILE が必要です
• 共有リンクからのダウンロード URL には、適切な認証ヘッダーが必要です

共有

• 共有リンクがすでに存在する場合に作成しようとすると、409 Conflict エラーが返されます
• 新しいリンクを作成する前に、必ず DROPBOX_LIST_SHARED_LINKS で確認してください
• 共有フォルダーへのアクセスは、通常のパス一覧に表示されない場合があります。DROPBOX_LIST_SHARED_FOLDERS を使用してください

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
ファイルを検索	DROPBOX_SEARCH_FILE_OR_FOLDER	query, options.path
検索を続行	DROPBOX_SEARCH_CONTINUE	cursor
フォルダーを一覧表示	DROPBOX_LIST_FILES_IN_FOLDER	path, recursive, limit
フォルダーを一覧表示	DROPBOX_LIST_FOLDERS	path, recursive
メタデータを取得	DROPBOX_GET_METADATA	path
ファイルを読み取り／ダウンロード	DROPBOX_READ_FILE	path
ファイルをアップロード	DROPBOX_UPLOAD_FILE	path, content, mode
URL を Dropbox に保存	DROPBOX_SAVE_URL	path, url
フォルダーを ZIP 形式でダウンロード	DROPBOX_DOWNLOAD_ZIP	path
Paper ドキュメントをエクスポート	DROPBOX_EXPORT_FILE	path, export_format
共有リンクからダウンロード	DROPBOX_GET_SHARED_LINK_FILE	url
共有リンクを作成	DROPBOX_CREATE_SHARED_LINK	path, settings
共有リンクを一覧表示	DROPBOX_LIST_SHARED_LINKS	path, direct_only
共有リンクのメタデータを取得	DROPBOX_GET_SHARED_LINK_METADATA	url
共有フォルダーを一覧表示	DROPBOX_LIST_SHARED_FOLDERS	limit
フォルダーを作成	DROPBOX_CREATE_FOLDER	path
フォルダーを一括作成	DROPBOX_CREATE_FOLDER_BATCH	paths
ファイル／フォルダーを移動	DROPBOX_MOVE_FILE_OR_FOLDER	from_path, to_path
一括移動	DROPBOX_MOVE_BATCH	entries
ファイル／フォルダーを削除	DROPBOX_DELETE_FILE_OR_FOLDER	path
一括削除	DROPBOX_DELETE_BATCH	entries
ファイル／フォルダーをコピー	DROPBOX_COPY_FILE_OR_FOLDER	from_path, to_path
一括処理のステータスを確認	DROPBOX_CHECK_MOVE_BATCH	async_job_id

---

Composio 提供