Note
本文介绍了由 标准线束驱动的代理或代理流中使用的功能。
Important
这是一项预览功能。
- Microsoft正式发布之前发布预览版功能,以便客户能够提前访问并提供反馈。
- 预览功能具有受限的功能,不适用于生产用途。
- Microsoft可能会更改预览 MCP 工具名称和参数。 避免硬编码依赖项。 Microsoft 提供场景支持。
- 预览功能受Microsoft补充使用条款的约束。
Note
针对特定应用的 Microsoft 365 MCP 工具(Copilot、日历、邮件、SharePoint、OneDrive、Teams、User 和 Word)仅用于向后兼容,不应用于生产环境或新项目。 对于需要访问 Microsoft 365 资源的新项目,请使用 Work IQ MCP 和 Microsoft Copilot harness。 更多信息请参见 Copilot Studio 中的 Work IQ MCP。
Overview
| 服务器 ID | 租户级 URL | 显示名称 | 说明 |
|---|---|---|---|
mcp_OneDriveRemoteServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_OneDriveRemoteServer |
OneDrive | OneDrive操作工具。 使用此服务器管理用户个人OneDrive中的文件和文件夹。 所有文件操作限制为 ≤5MB。 |
可用工具
获取OneDrive
获取有关用户OneDrive的信息,包括驱动器元数据、配额和所有者信息。
不需要参数。
getFolderChildrenInMyOnedrive
枚举用户OneDrive中指定父文件夹中包含的前 20 个文件和文件夹(DriveItems)。
可选参数:
- parentFolderId: 你想列出的文件和文件夹的父文件夹的ID(默认:“root”)
在我的OneDrive中查找文件或文件夹
通过搜索查询在用户的 OneDrive 中查找文件或文件夹(DriveItem)。 如果知道该项位于用户的OneDrive中,此方法比搜索所有可访问文件更有效。
所需参数:
- 搜索查询: 搜索查询;可以是整个或部分文件名
获取我在OneDrive上的文件或文件夹元数据
从用户的OneDrive获取文件或文件夹(DriveItem)的元数据。
所需参数:
- fileOrFolderId:用户OneDrive中文件或文件夹的ID
getFileOrFolderMetadataByUrl(获取文件或文件夹元数据通过网址)
从共享 URL 获取文件或文件夹(DriveItem)的元数据。 只有具有访问文件的现有显式权限的用户才能获取元数据。
所需参数:
- fileOrFolderUrl: 文件或文件夹的URL。 不能通过兑换该 URL 来与用户共享;用户必须已具有显式访问权限。
readSmallTextFileFromMyOnedrive
从用户的OneDrive读取文本文件(下载)。
所需参数:
- fileID: 用于读取或下载的文件(DriveItem)的ID。
在我的OneDrive中创建小文本文件
创建或上传小于 5 MB 的文本文件,并将其上传到用户的OneDrive。
所需参数:
- 文件名: 要创建的文件名称
- 内容正文: 文件内容。
可选参数:
- parentFolderId: 父文件夹的 ID(默认:“root”)。
创建文件夹在我的OneDrive
在用户的OneDrive中创建一个新文件夹(DriveItem),作为指定父文件夹的子文件夹。 如果已存在同名的文件夹,该方法将添加数字后缀(例如 NewFolder (1) 。
所需参数:
- 文件夹名称: 要创建的文件夹名称
可选参数:
- parentFolderId: 父文件夹的 ID(默认:“root”)。
重命名文件或文件夹在我的OneDrive中
重命名用户OneDrive中的文件或文件夹(DriveItem)。 新名称必须符合命名约定。
所需参数:
- fileOrFolderId: 要重命名的文件或文件夹的ID
- newFileOrFolderName: 文件或文件夹的新名称
可选参数:
- etag: 并发控制的ETag值。 仅当 DriveItem 的当前 ETag 匹配时,操作才会成功
删除我在 OneDrive 中的文件或文件夹
从用户的OneDrive中删除文件或文件夹(DriveItem)。
所需参数:
- fileOrFolderId: 要删除的文件或文件夹的ID
可选参数:
- etag: 并发控制的ETag值
分享我的 OneDrive 中的文件或文件夹
发送共享邀请,以授予用户OneDrive中对文件或文件夹(DriveItem)的读取或写入权限。
所需参数:
- fileOrFolderId: 要分享的文件或文件夹的ID
- 收件人电子邮件: 可邀请收件人的电子邮件地址阵列
- 角色: 要分配的角色数组。 接受的值:“读取”、“写入”(选择“写入”将授予“读取”和“写入”权限)
可选参数:
- 消息: 请在邀请邮件中包含的定制邮件。 默认值:“这是我们正在协作处理的文件。”
- 发送邀请: 是否发送分享邀请。 默认值:true。
在我的OneDrive中文件上设置敏感度标签
设置用户OneDrive中文件的敏感度标签。
所需参数:
- fileId: 文件 ID(DriveItem)
- 敏感标签ID: 要分配敏感标签的ID,或用于移除的空字符串
可选参数:
- assignmentMethod: 分配方法:'standard'、'privileged'、'auto' 或 'unknownFutureValue'(默认:'privileged')
- justificationText: 用于审计目的的理由文本;在降级或移除标签时为必填(默认:'由MCPServer更改')
创建我的OneDrive中的小型二进制文件
通过对其内容进行 Base64 编码,在用户的 OneDrive 中创建一个小于 5 MB 的二进制文件。
所需参数:
- 文件名: 要创建的文件名称,包括文件扩展名
- base64Content: 编码为base64字符串的二进制文件内容
可选参数:
- parentFolderId: 父文件夹的 ID(默认:“root”)。
readSmallBinaryFileFromMyOnedrive(从我的 OneDrive 读取小型二进制文件)
从用户的OneDrive读取小于 5 MB 的二进制文件。 以 base64 编码字符串的形式返回文件内容。
所需参数:
- fileID: 用于读取或下载的文件(DriveItem)的ID。
复制我的OneDrive中的文件或文件夹
将文件或文件夹(DriveItem)复制到用户OneDrive中的目标文件夹。 此操作为异步操作。 使用 checkOperationStatusInMyOnedrive 来监控进度。
所需参数:
- sourcefileid: 用于复制的源文件或文件夹(DriveItem)的ID
- destfolderID:目标文件夹的 ID(必须存在于用户的 OneDrive 中)
可选参数:
- newfilename: 复制项目的新名称(默认为原始名称)
moveFileOrFolderInMyOnedrive
将文件或文件夹(DriveItem)移动到用户OneDrive中的目标文件夹。 此操作为异步操作。 使用 checkOperationStatusInMyOnedrive 来监控进度。
所需参数:
- sourcefileid: 要移动的源文件或文件夹(DriveItem)的ID
- destfolderID:目标文件夹的 ID(必须存在于用户的 OneDrive 中)
可选参数:
- newfilename: 移动的项目的新名称(默认为原始名称)
检查操作状态在我的OneDrive
使用从原始操作返回的操作令牌检查异步操作的状态,例如复制或移动。 如果仍在进行中,则返回进度信息;如果失败,则返回错误详细信息;如果成功完成,则返回最终文件或文件夹元数据。
所需参数:
-
操作令牌: 操作令牌来自异步操作,如
copyFileOrFolderInMyOnedrive或moveFileOrFolderInMyOnedrive
主要功能
OneDrive管理
- 获取OneDrive信息,例如配额和所有者
- 访问用户的个人 OneDrive
- 所有操作都以经过身份验证的用户的 OneDrive 为目标
文件搜索和发现
- 在用户的 OneDrive 中按名称搜索文件和文件夹
- 按 ID 或共享 URL 获取文件或文件夹元数据
- 浏览文件夹内容(最多20个项目)。
文件操作
- 创建文本和二进制文件(≤5 MB)
- 读取文本和二进制文件(≤5 MB)
- 使用并发控制删除文件
- 使用 eTag 保护重命名文件
- 异步复制和移动文件和文件夹
文件夹管理
- 创建具有可选父路径的文件夹
- 重复的文件夹名称自动添加数字后缀。
- 列出文件夹内容(最多 20 个项目)
- 获取文件夹元数据
- 使用并发控制删除文件夹
- 使用 eTag 保护重命名文件夹
共享和权限
- 与用户共享文件和文件夹
- 基于角色的访问控制(读取、写入)
- 发送电子邮件通知以便分享。
- 请柬中的自定义消息。
安全性与合规性
- 应用和删除敏感度标签。
- 使用多个分配方法,包括标准、特权和自动分配方法。
- 支持审核理由。
- 将并发控制与 eTags 配合使用。
备注
- 所有操作都针对已验证用户的个人 OneDrive。
- 文件操作仅限于上传和下载的 5 MB 或更少的文件。
- 删除和重命名操作支持使用 ETag 进行并发控制。
- 共享需要有效的电子邮件地址和适当的权限。
- 敏感度标签需要适当的许可和配置。
- 默认情况下,文件夹列表最多返回 20 个项目。