云端硬盘 MCP 文件资格要求

Google 云端硬盘 Model Context Protocol (MCP) 服务器会强制执行访问权限控制和资格规则,以确定 AI 智能体可以与哪些文件和文件夹进行交互。

调用工具时,MCP 服务器会评估请求用户和特定项,以防止未经授权的访问并遵循安全政策。

资格要求

对于使用 Google 云端硬盘 MCP 服务器的 AI 智能体和应用,文件必须通过一系列安全、政策和功能检查。MCP 服务器会评估 Google Workspace 数据泄露防护 (DLP) 规则,但只有强制执行信息权限管理 (IRM) 控制的政策才会限制资格。

如需通过 MCP 服务器进行交互,文件或文件夹必须满足以下条件:

  • 服务可用性:必须在 Google Workspace 管理控制台中为用户所在的组织启用 Google 云端硬盘服务。
  • ACL 检查:发出请求的用户必须至少对文件或文件夹拥有读取权限(reader 访问权限)。
  • 商品级限制条件:
    • IRM(信息权限管理):如果内容具有IRM 控制措施,可防止下载、复制粘贴或打印(包括由管理员配置的 DLP 政策强制执行的控制措施),则 AI 智能体无法访问该内容。
    • CAA(情境感知访问权限):使用文件的 capabilities.canDownload 功能进行评估。如果 CAA 政策在客户端情境中阻止访问(或者在离线或后台操作期间缺少情境数据),则该项不符合条件。如果客户端上下文满足 CAA 要求,则该项仍符合条件。
    • 客户端加密功能 (CSE):AI 智能体无法解析使用 CSE 加密的内容,因此这些内容不符合条件。
  • 特殊商品种类:
    • 文件夹和快捷方式:文件夹和快捷方式元数据符合条件。 不过,文件夹中的嵌套文件或快捷方式引用的目标文件必须单独通过所有资格检查。
  • 不良商品状态:
    • 垃圾内容和恶意软件:被标记为垃圾内容或恶意软件的内容不符合条件。

MCP 服务器针对不符合条件的商品的行为

如果 AI 智能体尝试访问不符合条件的项,服务器行为取决于操作类型,如以下部分所述。

单文件操作

对于针对单个特定文件或文件夹的操作(例如读取内容、下载、更新元数据或检索权限),服务器会返回类似于以下内容的出错提示:

无法检索内容 <item id> 的元数据,因为它不符合在生成式 AI 上下文中使用的条件。

多文件和列表操作

对于检索列表或搜索多个文件的操作(例如搜索文件或列出近期文件),服务器会从搜索结果或文件列表中滤除不符合条件的内容。这可能会导致不一致,即用户可以在 Google 云端硬盘网页界面中查看或编辑文件,但 AI 智能体无法找到或查看该文件。