添加 OneDrive / SharePoint 账户
将 Microsoft OneDrive for Business 或 SharePoint 位置连接到 PlaidCloud 文档。需要注册一个 Entra(Azure AD)应用程序,选择它可以访问租户的范围,PlaidCloud 随后使用该应用程序读写文件。
选择访问模型
Section titled “选择访问模型”确定应用程序可以访问 Microsoft 365 租户的范围。这是整个设置过程中最重要的选择。
| 模型 | Graph 应用程序权限 | 应用可以访问的内容 | 适用情形 |
|---|---|---|---|
| 选定站点(推荐) | Sites.Selected |
仅限明确授权的特定站点 | 任何站点包含敏感数据,例如薪资、人力资源、财务、PHI |
| 所有站点 | Sites.Read.All(读取)或 Sites.ReadWrite.All(读取 + 写入) |
租户中的每个站点 | 没有敏感站点,且希望设置尽可能简单 |
大多数组织应选择“选定站点”。 只要有一个站点包含敏感信息,租户范围的访问就会使其暴露。使用 Sites.Selected 时,在管理员为每个指定站点授权之前,应用程序无法访问任何内容,因此从未授权的站点始终完全不可访问。
在 Azure 中注册应用程序
Section titled “在 Azure 中注册应用程序”- 登录 Azure 门户,然后转到 Microsoft Entra ID → App registrations → + New registration。
- 输入名称(例如
PlaidCloud)。 - 在 Supported account types 下,选择 Accounts in this organizational directory only(单租户,最常见)。
- 将 Redirect URI 留空,然后点击 Register。
- 在概述页面上,复制 Application (client) ID(即客户端 ID)和 Directory (tenant) ID(即租户 ID)。
- 转到 Certificates & secrets → + New client secret,设置说明和有效期,点击 Add,然后立即复制密钥的 Value,因为它不会再次显示。
授予 API 权限
Section titled “授予 API 权限”根据所选的访问模型,只添加一个 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,说明缺少此同意;同意后请注销并重新登录以刷新令牌。
步骤 1:查找站点 ID
Section titled “步骤 1:查找站点 ID”列出租户中的站点(方法 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>。
步骤 2:授权应用
Section titled “步骤 2:授权应用”将方法设置为 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在 PlaidCloud 中添加账户
Section titled “在 PlaidCloud 中添加账户”- 登录 PlaidCloud,并选择账户所在的工作区。
- 转到
Document→Manage→ 新建账户。 - 选择 OneDrive 作为服务。
- 输入名称和说明,并选择安全模型(如果不确定,请保留
Private)。 - 在身份验证凭据下,粘贴应用注册中的客户端 ID、客户端密钥和 OneDrive 租户 ID。
- 在 SharePoint 站点 URL 中,粘贴已授权给该应用的站点 URL(例如
https://contoso.sharepoint.com/sites/TeamName)。随后驱动器/站点列表会显示该站点的文档库,选择要用作账户根目录的文档库。此操作会填写起始路径。 - 选择保存。
使用 AI 助手创建账户
Section titled “使用 AI 助手创建账户”完成上述 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 会话中可用,工作流步骤或应用内代理无法使用。