box-automation

Box Automation - Box 云存储自动化集成

技能概述

通过 Rube MCP 无需 API 密钥即可实现 Box 云存储的自动化操作，包括文件上传下载、内容搜索、文件夹管理、协作共享和电子签名等功能。

适用场景

1. 企业文档自动化管理

自动将业务生成的文档上传到 Box 指定文件夹，按部门或项目自动创建目录结构，并设置相应的协作权限。例如：每日销售报告自动归档、合同文件按客户分类存储、发票文档批量上传等。

2. 文件批量操作与迁移

需要批量下载 Box 中的文件进行本地处理，或者将大量文件从本地或其他存储服务迁移到 Box。支持创建 ZIP 打包下载、文件夹递归复制、批量元数据更新等操作，大幅提升文件管理效率。

3. Box Sign 电子签名流程自动化

自动创建和发送文档签名请求，跟踪签名状态，并在签名完成后自动归档已签署的文件。适用于合同签署、审批流程等需要电子签名的业务场景，减少人工介入。

核心功能

文件上传与下载

支持单文件或批量文件的上传下载操作，可指定目标文件夹 ID，支持按文件版本下载。通过 BOX_UPLOAD_FILE 和 BOX_DOWNLOAD_FILE 实现文件的双向传输，配合 BOX_CREATE_ZIP_DOWNLOAD 可打包下载多个文件。

智能内容搜索

提供全文搜索能力，支持按文件名、内容、注释、标签等多维度检索。可使用布尔运算符（AND、OR、NOT）进行复杂查询，支持按文件类型、日期范围、特定文件夹等条件过滤，最大支持 10000 条结果分页。

完整的文件夹管理

支持创建、重命名、移动、复制和删除文件夹。通过 BOX_UPDATE_FOLDER 可更新文件夹属性和共享链接设置。删除操作支持递归删除非空文件夹，并提供了永久删除回收站文件的功能。

协作与权限管理

可查看文件的协作列表，更新协作者角色权限（如编辑者、查看者、所有者等），接受或拒绝协作邀请。支持创建共享链接、设置下载权限、锁定文件等高级权限控制功能。

元数据查询

通过 BOX_QUERY_FILES_FOLDERS_BY_METADATA 可按照自定义元数据模板进行精确查询，适用于需要按业务属性分类检索文件的场景，如按合同编号、项目代码等业务字段查找。

常见问题

如何获取 Box 文件和文件夹的 ID？

Box 中的所有实体都使用数字字符串 ID。最简单的方法是从 Box 网页版 URL 中提取：文件链接 https://*.app.box.com/files/123 中的 123 就是文件 ID，文件夹链接同理。也可以使用 BOX_SEARCH_FOR_CONTENT 搜索文件后从返回结果中获取 ID。根文件夹的 ID 固定为 "0"。

Rube MCP 连接 Box 需要 API 密钥吗？

不需要。只需在 MCP 客户端配置中添加 https://rube.app/mcp 作为服务器地址，然后通过 RUBE_MANAGE_CONNECTIONS 工具选择 box toolkit，完成 OAuth 授权后即可使用。整个过程无需申请 Box API 密钥，Rube 会处理所有认证细节。

Box 文件上传大小限制是多少？

标准上传工具支持不超过 50MB 的文件。超过此大小需要使用分块上传 API，但当前 MCP 工具集暂不包含分块上传功能。建议大文件先在本地分割后再上传，或使用 Box 官方的大文件上传方案。