---

name: dropbox-automation description: "通过 Rube MCP（Composio）自动化 Dropbox 文件管理、共享、搜索、上传、下载和文件夹操作。始终先搜索工具以获取当前模式。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Dropbox 自动化

通过 Composio 的 Dropbox 工具包自动化 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：每页结果数（默认 100，最大 1000）

注意事项：

• 搜索返回 has_more: true 和 cursor 时表示还有更多结果；必须继续获取以避免遗漏
• 所有分页总计最多 10,000 个匹配结果
• DROPBOX_GET_METADATA 返回的 path_display 大小写可能与用户输入不同；始终使用返回的规范路径
• DROPBOX_READ_FILE 的文件内容可能以 base64 编码的 file_content_bytes 返回；解析前需解码

2. 上传和下载文件

使用场景：用户想上传文件到 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）

注意事项：

• 对已有共享链接的路径再次创建会返回错误；先用 DROPBOX_LIST_SHARED_LINKS 检查
• 过期设置仅对团队版账户有效
• 共享文件夹权限与共享链接权限是独立的系统