名称: SharePoint自动化 描述: “SharePoint自动化: 管理站点、列表、文档、文件夹、页面和搜索内容,跨SharePoint和OneDrive” 要求: mcp: [rube]
SharePoint自动化
自动化SharePoint操作,包括管理站点、列表、文档、文件夹和页面。通过OneDrive集成SharePoint REST API和Microsoft Graph。
工具包文档: composio.dev/toolkits/share_point
设置
此技能需要连接到https://rube.app/mcp的Rube MCP服务器。
在执行任何工具之前,确保share_point和one_drive工具包有活跃连接。如果没有活跃连接,通过RUBE_MANAGE_CONNECTIONS初始化一个。
注意: 许多OneDrive/SharePoint工具仅适用于组织Microsoft 365账户(Azure AD/Entra ID)。个人Microsoft账户不支持。
核心工作流程
1. 列出和浏览站点
检索站点详情并枚举子站点,以发现SharePoint拓扑。
工具:
ONE_DRIVE_GET_SITE_DETAILS– 通过ID获取特定站点的元数据ONE_DRIVE_LIST_SITE_SUBSITES– 列出父站点的所有子站点
关键参数:
site_id(必需) – 复合格式:主机名,站点集合-guid,web-guid(例如:"contoso.sharepoint.com,da60e844-...,712a596e-...")
示例:
工具: ONE_DRIVE_GET_SITE_DETAILS
参数:
site_id: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
2. 管理列表
创建列表、枚举现有列表并检索列表项。
工具:
SHARE_POINT_LIST_ALL_LISTS– 检索站点上的所有列表(支持OData筛选、选择、排序、顶部限制)SHARE_POINT_SHAREPOINT_CREATE_LIST– 使用指定模板创建新列表ONE_DRIVE_LIST_SITE_LISTS– 通过Microsoft Graph列出站点下的所有列表ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS– 从特定列表检索项
SHARE_POINT_SHAREPOINT_CREATE_LIST的关键参数:
name(必需) – 列表名称template(必需) – 模板类型:"genericList"、"documentLibrary"、"tasks"等description– 可选描述
SHARE_POINT_LIST_ALL_LISTS的关键参数:
filter– OData筛选,例如:"Hidden eq false"select– 要返回的属性,例如:"Title,Id"orderby– 排序表达式,例如:"Title desc"top– 限制结果数量
示例:
工具: SHARE_POINT_SHAREPOINT_CREATE_LIST
参数:
name: "项目任务"
template: "tasks"
description: "第一季度交付成果的任务跟踪"
3. 管理文件夹和文件
创建文件夹、列出文件夹中的文件并导航文档库。
工具:
SHARE_POINT_SHAREPOINT_CREATE_FOLDER– 在文档库中创建新文件夹SHARE_POINT_LIST_FILES_IN_FOLDER– 通过服务器相对URL列出文件夹中的文件SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL– 通过路径获取文件夹元数据
SHARE_POINT_SHAREPOINT_CREATE_FOLDER的关键参数:
folder_name(必需) – 要创建的文件夹名称document_library– 目标库(默认:"Shared Documents")relative_path– 库内的额外路径
SHARE_POINT_LIST_FILES_IN_FOLDER的关键参数:
folder_name(必需) – 服务器相对URL,例如:"/Shared Documents"select– 逗号分隔的属性,例如:"Name,ServerRelativeUrl,Length"top– 限制结果数量orderby– 排序表达式,例如:"Name desc"
示例:
工具: SHARE_POINT_LIST_FILES_IN_FOLDER
参数:
folder_name: "/Shared Documents/报告"
select: "Name,ServerRelativeUrl,Length"
top: 50
4. 搜索SharePoint内容
使用关键词查询语言(KQL)搜索站点上的文档、列表项和其他内容。
工具: SHARE_POINT_SEARCH_QUERY
关键参数:
querytext(必需) – KQL查询,例如:"项目报告"、"FileType:docx"、"Author:\"John Doe\""rowlimit– 每个请求的最大结果(默认约50,最大500)startrow– 基于零的偏移用于分页selectproperties– 要返回的属性,例如:"Title,Author,Path"refinementfilters– 缩小结果,例如:"FileType:equals(\"docx\")"
示例:
工具: SHARE_POINT_SEARCH_QUERY
参数:
querytext: "IsDocument:1 FileType:pdf"
rowlimit: 25
selectproperties: "Title,Author,Path,LastModifiedTime"
5. 跟踪列表变更(增量查询)
使用增量查询获取增量变更(创建、更新、删除的项),而无需读取整个列表。
工具: ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA
关键参数:
site_id(必需) – 复合站点IDlist_id(必需) – 列表GUIDtoken– 初始同步时省略;传递"latest"以获取空响应和令牌;传递先前令牌以获取自那时起的变更expand– 例如:"fields($select=ColumnA,ColumnB)"top– 每个响应的最大项数
6. 检索站点页面内容
读取现代SharePoint站点页面内容,包括画布Web部件。
工具: SHARE_POINT_GET_SITE_PAGE_CONTENT
关键参数:
page_file_name– 带.aspx扩展名的文件名,例如:"Home.aspx"item_id– 替代:页面的列表项IDrender_as–"raw"(默认)、"text"或"html"site– 可选站点名称范围
已知陷阱
| 陷阱 | 详情 |
|---|---|
| 站点ID格式 | 必须是复合格式:主机名,站点集合-guid,web-guid。错误格式会导致400错误。 |
| 个人账户不支持 | ONE_DRIVE_LIST_SITE_LISTS和基于Graph的工具仅适用于组织M365账户,不适用于个人MSA/Outlook.com账户。 |
| OData筛选语法 | SharePoint OData筛选使用特定语法。逐步测试筛选;不支持表达式可能静默返回空结果。 |
| 分页 | 使用skiptoken进行列表操作的服务器端分页。不完整的分页设置可能遗漏结果。 |
| 文件夹路径 | 必须使用服务器相对URL(例如:/Shared Documents),而非绝对URL。 |
快速参考
| 工具Slug | 描述 |
|---|---|
ONE_DRIVE_GET_SITE_DETAILS |
获取SharePoint站点的元数据 |
ONE_DRIVE_LIST_SITE_SUBSITES |
列出父站点的子站点 |
ONE_DRIVE_LIST_SITE_LISTS |
列出站点下的所有列表(Graph API) |
ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA |
跟踪增量列表变更 |
ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS |
从列表检索项 |
ONE_DRIVE_LIST_DRIVES |
列出用户/站点/组的可用驱动器 |
ONE_DRIVE_LIST_SITE_COLUMNS |
列出站点的列定义 |
SHARE_POINT_LIST_ALL_LISTS |
检索站点上的所有列表(REST API) |
SHARE_POINT_SHAREPOINT_CREATE_LIST |
创建新SharePoint列表 |
SHARE_POINT_SHAREPOINT_CREATE_FOLDER |
在文档库中创建文件夹 |
SHARE_POINT_LIST_FILES_IN_FOLDER |
列出文件夹中的文件 |
SHARE_POINT_SEARCH_QUERY |
使用KQL搜索内容 |
SHARE_POINT_GET_SITE_PAGE_CONTENT |
检索站点页面内容 |
SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL |
通过路径获取文件夹元数据 |
由Composio提供支持