跳转到内容

添加 OneDrive / SharePoint 账户

将 Microsoft OneDrive for Business 或 SharePoint 位置连接到 PlaidCloud 文档。需要注册一个 Entra(Azure AD)应用程序,选择它可以访问租户的范围,PlaidCloud 随后使用该应用程序读写文件。

确定应用程序可以访问 Microsoft 365 租户的范围。这是整个设置过程中最重要的选择。

模型 Graph 应用程序权限 应用可以访问的内容 适用情形
选定站点(推荐) Sites.Selected 仅限明确授权的特定站点 任何站点包含敏感数据,例如薪资、人力资源、财务、PHI
所有站点 Sites.Read.All(读取)或 Sites.ReadWrite.All(读取 + 写入) 租户中的每个站点 没有敏感站点,且希望设置尽可能简单

大多数组织应选择“选定站点”。 只要有一个站点包含敏感信息,租户范围的访问就会使其暴露。使用 Sites.Selected 时,在管理员为每个指定站点授权之前,应用程序无法访问任何内容,因此从未授权的站点始终完全不可访问。

  1. 登录 Azure 门户,然后转到 Microsoft Entra ID → App registrations → + New registration。
  2. 输入名称(例如 PlaidCloud)。
  3. 在 Supported account types 下,选择 Accounts in this organizational directory only(单租户,最常见)。
  4. 将 Redirect URI 留空,然后点击 Register。
  5. 在概述页面上,复制 Application (client) ID(即客户端 ID)和 Directory (tenant) ID(即租户 ID)。
  6. 转到 Certificates & secrets → + New client secret,设置说明和有效期,点击 Add,然后立即复制密钥的 Value,因为它不会再次显示。

根据所选的访问模型,只添加一个 Microsoft Graph 应用程序权限:

  • 选定站点: Sites.Selected
  • 所有站点: Sites.Read.All(只读)或 Sites.ReadWrite.All(读取 + 写入)

步骤:API permissions → + Add a permission → Microsoft Graph → Application permissions → 添加上述一个权限 → Grant admin consent。

如果选择了所有站点,设置即已完成,请跳到在 PlaidCloud 中添加账户。如果选择了选定站点,接下来需要将应用授权给每个站点。

授予应用对每个站点的访问权限(选定站点模型)

Section titled “授予应用对每个站点的访问权限(选定站点模型)”

Sites.Selected 本身不会授予应用程序任何访问权限,必须由 SharePoint 管理员或全局管理员将其授权给希望它访问的每个站点。管理中心没有用于此操作的屏幕,因此需要在 Graph Explorer 中执行两次 Microsoft Graph 调用。由于站点是逐个授权的,敏感站点自然永远不会被授权。

一次性设置。 以 SharePoint 管理员或全局管理员身份登录 Graph Explorer,打开 Modify permissions 选项卡,然后点击 Sites.FullControl.All 上的 Consent(此范围用于设置站点授权)。如果之后的查询返回 accessDenied,说明缺少此同意;同意后请注销并重新登录以刷新令牌。

列出租户中的站点(方法 GET):

GET https://graph.microsoft.com/v1.0/sites?search=*&$select=displayName,webUrl,id

或者直接通过 URL 解析单个站点:

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/TeamName

从响应中复制站点的 id,其格式为 contoso.sharepoint.com,<guid>,<guid>。

将方法设置为 POST,请求该站点的 permissions 集合(粘贴步骤 1 中的 id):

POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions

在 Request body 选项卡上粘贴以下内容:将 roles 设置为 ["read"] 或 ["write"],并使用应用的 Application (client) ID:

{
"roles": ["read"],
"grantedToIdentities": [
{ "application": { "id": "your-client-id", "displayName": "PlaidCloud" } }
]
}

运行查询。成功时会返回一个包含 id 和 roles 的权限对象。对每个站点重复步骤 2,直到覆盖希望 PlaidCloud 访问的所有站点。要查看某个站点已授予的权限:

GET https://graph.microsoft.com/v1.0/sites/{site-id}/permissions
  1. 登录 PlaidCloud,并选择账户所在的工作区。
  2. 转到 Document → Manage → 新建账户。
  3. 选择 OneDrive 作为服务。
  4. 输入名称和说明,并选择安全模型(如果不确定,请保留 Private)。
  5. 在身份验证凭据下,粘贴应用注册中的客户端 ID、客户端密钥和 OneDrive 租户 ID。
  6. 在 SharePoint 站点 URL 中,粘贴已授权给该应用的站点 URL(例如 https://contoso.sharepoint.com/sites/TeamName)。随后驱动器/站点列表会显示该站点的文档库,选择要用作账户根目录的文档库。此操作会填写起始路径。
  7. 选择保存。

完成上述 Azure 步骤后,通过 PlaidCloud MCP 连接器连接的 AI 助手可以使用 document_account_upsert 工具为您创建或更新账户。向它提供应用注册中的值:

账户字段 值
service_type onedrive
public_key 应用程序(客户端)ID
private_key 客户端密钥
tenant_id 目录(租户)ID
start_path 驱动器 ID,可在其后接 /folder

凭据为只写:document_account_describe 会隐藏它们。该工具仅在您本人登录的 MCP 会话中可用,工作流步骤或应用内代理无法使用。