---

name: one-drive-automation description: "通过 Rube MCP (Composio) 自动化 OneDrive 文件管理、搜索、上传、下载、共享、权限和文件夹操作。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 OneDrive 自动化

通过 Composio 的 OneDrive 工具包自动化 OneDrive 操作，包括文件上传/下载、搜索、文件夹管理、共享链接、权限管理和驱动器浏览。

前置条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 OneDrive 连接，toolkit 为 one_drive
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用
2. 使用 toolkit one_drive 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，按照返回的认证链接完成 Microsoft OAuth
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 搜索和浏览文件

适用场景：用户想在 OneDrive 中查找文件或浏览文件夹内容

工具调用顺序：

1. ONE_DRIVE_GET_DRIVE - 验证驱动器访问权限并获取驱动器详情 [前置条件]
2. ONE_DRIVE_SEARCH_ITEMS - 跨文件名、元数据和内容进行关键词搜索 [必需]
3. ONE_DRIVE_ONEDRIVE_LIST_ITEMS - 列出驱动器根目录中的所有项目 [可选]
4. ONE_DRIVE_GET_ITEM - 获取特定项目的详细元数据，展开子项 [可选]
5. ONE_DRIVE_ONEDRIVE_FIND_FILE - 在文件夹中按精确名称查找特定文件 [可选]
6. ONE_DRIVE_ONEDRIVE_FIND_FOLDER - 按名称查找特定文件夹 [可选]
7. ONE_DRIVE_LIST_DRIVES - 列出所有可访问的驱动器 [可选]

关键参数：

• q：搜索查询（仅纯关键词，不支持 KQL 语法）
• search_scope："root"（文件夹层级）或 "drive"（包含共享项目）
• top：每页最大项目数（默认 200）
• skip_token：来自 @odata.nextLink 的分页令牌
• select：逗号分隔的返回字段（如 "id,name,webUrl,size"）
• orderby：排序方式（如 "name asc"、"name desc"）
• item_id：用于 GET_ITEM 的项目 ID
• expand_relations：数组如 ["children"] 或 ["thumbnails"]，用于 GET_ITEM
• user_id："me"（默认）或特定用户 ID/邮箱

注意事项：

• ONE_DRIVE_SEARCH_ITEMS 不支持 KQL 运算符（folder:、file:、filetype:、path:）；这些会被当作纯文本处理
• 不支持通配符（*、?），会被自动移除；请使用文件扩展名关键词（如用 "pdf" 而非 "*.pdf"）
• ONE_DRIVE_ONEDRIVE_LIST_ITEMS 仅返回根级内容；对更深层级使用递归 ONE_DRIVE_GET_ITEM 配合 expand_relations: ["children"]
• 大文件夹会分页；始终跟踪 skip_token / @odata.nextLink 直到耗尽
• 某些驱动器 ID 格式可能因 Microsoft Graph API 限制返回 "ObjectHandle is Invalid" 错误

2. 上传和下载文件

适用场景：用户想将文件上传到 OneDrive 或从中下载文件

工具调用顺序：

1. ONE_DRIVE_ONEDRIVE_FIND_FOLDER - 定位目标文件夹 [前置条件]
2. ONE_DRIVE_ONEDRIVE_UPLOAD_FILE - 将文件上传到指定文件夹 [上传必需]
3. ONE_DRIVE_DOWNLOAD_FILE - 通过项目 ID 下载文件 [下载必需]
4. ONE_DRIVE_GET_ITEM - 下载前获取文件详情 [可选]

关键参数：

• file：FileUploadable 对象，包含 s3key、mimetype 和 name，用于上传
• folder：目标路径（如 "/Documents/Reports"）或文件夹 ID，用于上传
• item_id：文件的唯一标识符，用于下载
• file_name：带扩展名的目标文件名，用于下载
• drive_id：特定驱动器 ID（用于 SharePoint 或 OneDrive for Business）
• user_id："me"（默认）或特定用户标识符

注意事项：

• 上传时遇到冲突会自动重命名（默认无覆盖选项）
• 大文件通过分块自动处理
• 同时提供 drive_id 和 user_id 时，drive_id 优先
• 项目 ID 因平台而异：OneDrive for Business 使用 01... 前缀，OneDrive Personal 使用 HASH!NUMBER 格式
• 项目 ID 区分大小写；请严格使用 API 返回的格式

3. 共享文件和管理权限

适用场景：用户想共享文件/文件夹或管理访问权限

工具调用顺序：

1. ONE_DRIVE_ONEDRIVE_FIND_FILE 或 ONE_DRIVE_ONEDRIVE_FIND_FOLDER - 定位项目 [前置条件]
2. ONE_DRIVE_GET_ITEM_PERMISSIONS - 检查当前权限 [前置条件]
3. ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM - 授予特定用户访问权限 [必需]
4. ONE_DRIVE_CREATE_LINK - 创建可共享链接 [可选]
5. ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA - 更新项目元数据 [可选]

关键参数：

• item_id：要共享的项目 ID
• recipients：接收者邮箱数组
• roles：权限角色（"read"、"write"、"owner"）
• type：链接类型（"view"、"edit"、"embed"）
• scope：链接范围（"anonymous"、"organization"）
• message：共享邀请中包含的可选消息