面向 AI 智能体的 Drive MCP 工具概览
概述面向 AI 智能体的 42 个 TrekMail Drive MCP 工具，包括上传、共享链接、批量操作、安全删除以及 Drive 附加组件的只读访问。
文章详情
类型、难度、套餐及最近更新信息。
▼
文章详情
类型、难度、套餐及最近更新信息。
- 类型
- 参考资料
- 难度
- 中级
- 套餐
- Starter · Pro · Agency · + Drive Add-on
- 最近更新
- 2026年9月10日
TrekMail MCP 服务器将 TrekMail 以结构化工具的形式提供给 AI 智能体，用于文件存储、公共链接、安全清理和同步设备密码管理。连接只能看到其凭据、所选工具集、传输方式和安全控制允许的工具。请检查实际向智能体公开的工具列表，不要依赖固定的目录数量。
对智能体来说，MCP 通常比直接使用 REST 更简单。你无需让智能体构建 HTTP 请求，而是可以为其提供 drive_file_upload、drive_share_create 或 drive_bulk_move 等工具。API 仍会在后台强制执行令牌权限范围、幂等性、审计日志和安全控制。
工具覆盖范围
| 工具组 | 工具 | 智能体可以执行的操作 |
|---|---|---|
| 空间和使用情况 | drive_spaces_list, drive_storage_summary, drive_space_usage |
查找账户 Drive、允许的邮箱空间和配额状态 |
| 浏览和选择 | drive_browse_folder, drive_folder_tree, drive_select_all_ids |
浏览文件夹并安全地准备批量操作 |
| 文件 | drive_file_get, drive_file_download_url, drive_file_rename, drive_file_move, drive_file_trash, drive_file_restore, drive_file_purge |
读取元数据，以及下载、重命名、移动、移入回收站、恢复或永久清除文件 |
| 文件夹 | drive_folder_create, drive_folder_update, drive_folder_move, drive_folder_trash, drive_folder_restore, drive_folder_purge |
创建和管理文件夹树 |
| 团队共享 | drive_folder_share_with_account, drive_folder_stop_sharing |
让所有邮箱都能看到顶层文件夹，或停止账户范围内的可见性 |
| 回收站 | drive_trash_list, drive_trash_empty |
查看回收站，或在启用破坏性操作控制时永久清空回收站 |
| 批量操作 | drive_bulk_trash, drive_bulk_restore, drive_bulk_move, drive_bulk_purge |
移动、移入回收站、恢复或永久清除最多 5,000 个选定项目 |
| 公共链接 | drive_share_create, drive_share_list, drive_share_revoke |
创建具有到期时间或下载次数上限的链接，并在以后撤销链接 |
| 上传 | drive_file_upload, drive_upload_initiate, drive_upload_complete, drive_upload_refresh_parts, drive_upload_abort |
使用简单封装上传本地文件，或手动控制分片上传流程 |
| 附加组件状态 | drive_addon_get, drive_addon_pricing, drive_addon_cancellation_preview |
在不更改计费的情况下读取存储附加组件状态和价格 |
| 同步设备 | drive_device_list, drive_device_create, drive_device_revoke, drive_device_rotate |
为 WebDAV 同步应用创建、查看、撤销或轮换单独的密码 |
令牌要求
Drive MCP 工具使用操作令牌环境变量：
TREKMAIL_API_TOKEN=tm_live_your_token
令牌必须包含匹配的 Drive 权限范围。例如，drive_share_create 需要文件所在 Drive 空间的共享权限范围。drive_file_purge 需要永久清除权限范围，并且必须启用破坏性工具控制。同步设备工具需要 drive:devices:read 或 drive:devices:write；创建的设备密码只显示一次。其响应会包含正确的 server_url，仅当证书和受限主机准备就绪后，才会包含品牌 DAV 地址。
你也可以提供 TREKMAIL_MESSAGE_TOKEN，同时运行 Drive 工具和消息工具。这两类令牌仍相互独立。
安全控制
在自行托管的 stdio MCP 服务器上，本地管理员可以要求设置 TREKMAIL_ALLOW_DESTRUCTIVE=true，之后才允许运行永久清除和清空回收站工具。这是本地安全控制，并非 TrekMail 产品功能开关。普通回收站操作也会修改数据，因此需要写入权限范围，但这些操作可以恢复，不需要永久清除权限范围。
发送电子邮件和迁移写入操作具有独立的控制。启用 Drive 破坏性工具不会自动启用邮件发送或迁移写入。
通过 MCP 上传
对于大多数工作流，请使用 drive_file_upload。它从 MCP 主机读取本地文件，请求上传说明，将文件发送到返回的上传 URL，完成上传，并在出现故障时中止预留。
当集成需要更多控制时，仍可使用底层工具，例如文件字节来自其他服务或自定义传输流程时。
通过 MCP 创建共享链接
使用 drive_share_create 创建公共下载 URL。当链接离开你的组织时，请始终设置 expires_at 和 max_downloads。需要停止链接时，请使用 drive_share_revoke。原始令牌仅在创建时显示，因此智能体应立即返回完整的公共 URL。
计费边界
附加组件工具均为只读：drive_addon_get、drive_addon_pricing 和 drive_addon_cancellation_preview。智能体无法通过 MCP 购买、调整容量或取消 Drive 附加组件。这些操作仍只能在控制面板中执行，并由用户控制。
相关文章
跳转到延续此工作流的邻近指南。