重要
- 这是一项预览功能。
- 预览功能不适用于生产用途，并且可能具有受限功能。 这些功能受补充使用条款的约束，并在正式发布之前可用，以便客户提前访问并提供反馈。
概述
| 服务器 ID | 显示名称 | 说明 |
|---|---|---|
mcp_SharePointRemoteServer |
工作 IQ SharePoint | MCP 服务器用于 SharePoint 操作。 使用此服务器管理网站、列表、列表项、列、文档库、文件、文件夹和文件共享。 文件操作限制为 ≤5MB。 |
注释
- 使用以前版本的 Microsoft MCP 服务器（如 Microsoft Teams MCP 服务器）的现有连接仍受支持。
- 对于所有新连接，请使用最新的 Work IQ MCP 服务器，例如 Work IQ Teams。
可用工具
findSite
查找用户可访问的 SharePoint 网站。 返回与搜索查询匹配的特定网站，如果未提供任何查询，则返回前 20 个相关网站。
可选参数：
- searchQuery： 搜索查询（整个或部分网站名称）。 省略以返回前 20 个可访问站点
getSiteByPath
使用其确切的主机名和服务器相对路径解析 SharePoint 网站。 仅当具有完整的网站 URL 结构时使用。 仅当已知站点名称时使用 findSite 。
所需参数：
- 主机 名： 确切主机名（例如，“contoso.sharepoint.com”）
- serverRelativePath： 相对于服务器的路径（例如“sites/Marketing”）。 列表开头的斜杠是可选的。
listSubsites
列出 SharePoint 网站的所有子网站（子网站）。
所需参数：
- siteId： 父 SharePoint 网站的 ID（格式：“hostname，siteCollectionId，webId”）
列出网站中的文档库
列出指定 SharePoint 网站中的文档库（驱动器）。
可选参数：
- siteId： SharePoint 网站的 ID（默认值：“root”）
获取站点中的默认文档库
获取 SharePoint 网站中的默认文档库（驱动器）。
可选参数：
- siteId： SharePoint 网站的 ID（默认值：“root”）
getFolderChildren
枚举文档库（驱动器）中指定父文件夹中包含的前 20 个文件和文件夹（DriveItems）。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentFolderId： 父文件夹的 ID（默认值：“root”）
findFileOrFolder
通过搜索查询查找用户可访问的文件或文件夹（DriveItem）。 搜索用户有权访问的所有网站和文档库。
所需参数：
- searchQuery： 搜索查询（整个或部分文件名）
获取文件或文件夹元数据
从 SharePoint 中的指定文档库（驱动器）获取文件或文件夹（DriveItem）的元数据。
所需参数：
- fileOrFolderId： 文件或文件夹的 ID （DriveItem）
- documentLibraryId： 文档库的 ID（驱动器）
getFileOrFolderMetadataByUrl（获取文件或文件夹元数据通过网址）
从共享 URL 获取文件或文件夹的元数据。 仅允许具有现有显式权限访问文件的用户。
所需参数：
- fileOrFolderUrl： 文件或文件夹的 URL。 不会通过兑换 URL 来与用户共享；用户必须已经具有明确的访问权限。
readSmallTextFile
从特定文档库（驱动器）读取（下载）小于 5MB 的文本文件。
所需参数：
- fileId： 要读取/下载的文件的 ID（DriveItem）
- documentLibraryId： 文档库的 ID（驱动器）
readSmallBinaryFile
从特定文档库（驱动器）读取大小小于 5MB 的二进制文件。 文件内容作为 base64 编码的字符串返回。
所需参数：
- fileId： 要读取/下载的文件的 ID（DriveItem）
- documentLibraryId： 文档库的 ID（驱动器）
创建小型文本文件
创建或上传小于 5MB 的文本文件到特定文档库（驱动器）。
所需参数：
- 文件名： 包含扩展名的文件的名称
- contentText： 文件的文本内容
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentfolderId： 父文件夹的 ID（默认值：“root”）
创建小型二进制文件
将小于 5MB 的二进制文件内容进行 base64 编码，并将生成的文件存储到特定的文档库（磁盘驱动器）中。
所需参数：
- 文件名： 包含扩展名的文件的名称
- base64Content： 编码为 base64 字符串的二进制文件内容
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentfolderId： 父文件夹的 ID（默认值：“root”）
创建文件夹
在指定的文档库（驱动器）中创建新文件夹（DriveItem）。 如果存在同名的文件夹，则添加数字后缀（例如 NewFolder （1） 。
所需参数：
- folderName： 文件夹的名称
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentFolderId： 父文件夹的 ID（默认值：“root”）
文件或文件夹重命名
在指定的文档库（驱动器）中重命名文件或文件夹（DriveItem）。 新名称必须符合命名约定。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileOrFolderId： 要重命名的文件或文件夹的 ID
- newFileOrFolderName： 新名称
可选参数：
- Etag： 用于并发控制的 ETag
deleteFileOrFolder (删除文件或文件夹)
从指定的文档库（驱动器）中删除文件或文件夹（DriveItem）。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileOrFolderId： 要删除的文件或文件夹的 ID
可选参数：
- Etag： 用于并发控制的 ETag
moveSmallFile
将文件（DriveItem）移动到同一文档库中的另一个文件夹。 仅支持小于 5MB 的文件。 无法在驱动器之间移动。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileId： 要移动的文件的 ID
- newParentFolderId： 目标文件夹的 ID（必须位于同一文档库中）
可选参数：
- Etag： 用于并发控制的 ETag
复制文件或文件夹 (copyFileOrFolder)
将文件或文件夹（DriveItem）复制到目标文件夹。 支持跨 SharePoint 中的不同文档库进行复制。 此操作是异步的;用于 checkOperationStatus 监视进度。
所需参数：
- sourcedoclibid： 源文档库的 ID（驱动器）
- sourcefileid： 要复制的源文件或文件夹的 ID
- destdoclibid： 目标文档库的 ID（驱动器）
- destfolderid： 目标文件夹的 ID（必须存在）
可选参数：
- newfilename： 复制项的新名称
checkOperationStatus
使用原始操作返回的操作令牌检查异步操作（如副本）的状态。
所需参数：
-
operationToken： 从异步操作返回的操作令牌，例如
copyFileOrFolder
从URL上传文件
将文件从 SharePoint 或 OneDrive URL 上传到文档库（驱动器）中的目标文件夹。 该文件是从源 URL 复制的;不会对原始更改。
所需参数：
- sourceUrl： 源 URL（必须是有效的 SharePoint 或 OneDrive URL）
- destinationDocumentLibraryId： 目标文档库的 ID。 请在用户的 OneDrive 中使用“me”
可选参数：
- destinationFolderId： 目标文件夹的 ID（默认值：“root”）
- 文件名： 新文件名;默认为原始文件名
共享文件或文件夹 (shareFileOrFolder)
发送共享邀请以授予对指定文档库（drive）中的文件或文件夹（DriveItem）的读/写权限。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileOrFolderId： 要共享的文件或文件夹的 ID
- recipientEmails： 收件人的电子邮件地址数组
- 角色： 角色的数组：“read”、“write”（“write”包含“read”和“write”的权限）
可选参数：
- 消息： 邀请电子邮件的自定义消息（默认值：“下面是我们正在协作的文件”。）
- sendInvitation： 是否发送共享邀请（默认值：true）
在文件上设置敏感性标签
从指定的文档库（驱动器）设置文件的敏感度标签。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileId： 文件的 Drive 项 Id
- sensitivityLabelId： 要删除的敏感度标签或空字符串的 ID
可选参数：
- assignmentMethod： 赋值方法：“standard”、“privileged”、“auto”或“unknownFutureValue”（默认值：“privileged”）
- justificationText： 审核的理由文本;降级或删除时必需（默认值：“由 MCPServer 更改”）
列出列表
获取特定网站上可用的所有 SharePoint 列表。 用于发现网站中存在哪些列表。
所需参数：
- siteId： SharePoint 网站的 ID（格式：“hostname，siteCollectionId，webId”）
createList
在网站中创建新的 SharePoint 列表。
所需参数：
- siteId： SharePoint 网站的 ID
- displayName： 新列表的显示名称
可选参数：
-
列： 列作为键值对的集合：
[{ Key: 'JobTitle', Value: 'text' }]。 有效类型：text、multilineText、number、boolean、dateTime、choice、lookup、personOrGroup、hyperlink、currency、calculated - 模板： 列表模板类型（默认值：“genericList”）。 选项：GenericList、DocumentLibrary、事件、任务、公告、联系人、链接、调查、IssueTracking、讨论板
deleteList
从网站中删除 SharePoint 列表。 删除整个列表容器及其中的所有项。 无法撤消。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： 要删除的列表的 ID
可选参数：
- Etag： 用于并发控制的 ETag
发送列表邀请
发送共享邀请以授予对 SharePoint 列表的权限。
所需参数：
- listId： 要共享的 SharePoint 列表的 ID
- recipientEmails： 收件人的电子邮件地址数组
- 角色： 角色：“read”（仅查看）、“contribute”（查看、添加、更新、删除项目）、“edit”（包括列表结构的完整编辑）
可选参数：
- siteUrl： 包含列表的 SharePoint 网站的网站 URL
- sendEmail： 是否发送电子邮件通知（默认值：true）
listListItems
从特定 SharePoint 列表中获取项目（行/记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
获取列表项
按其 ID 从 SharePoint 列表中获取单个项（行/记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- itemId： 特定列表项的 ID
createListItem
在 SharePoint 列表中创建新项（行/记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
-
字段： 字段值的键值对：
[{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]。 “Title”字段通常需要
更新列表项
更新 SharePoint 列表中的现有项（行/记录）。 仅更新指定的字段;省略的字段保留其值。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- itemId： 要更新的项的 ID
- 字段： 要更新的字段键值对
可选参数：
- Etag： 用于并发控制的 ETag
删除列表项
从 SharePoint 列表中删除项目（行/记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- itemId： 要删除的项的 ID
可选参数：
- Etag： 用于并发控制的 ETag
listColumns
从 SharePoint 列表中获取所有列。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
创建列
在 SharePoint 列表中创建新列。 支持许多列类型，包括文本、数字、选项、dateTime、布尔值、用户、查找、计算等。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- 名字： 内部列名称（编程标识符）
- columnType： 列类型：文本、注释、数字、整数、布尔值、日期时间、选择、多选、货币、查找、用户、网址、计算、条款、多条款、位置、地理位置、缩略图、计数器、计算值、内容类型ID、文件、附件、全局唯一标识符、结果选择、审批状态
可选参数：
-
columnProperties： 基于类型的设置（例如，
{ "maxLength": 255 }用于文本，{ "choices": ["A","B","C"] }用于选择） - 描述： 列的描述
- displayName： UI 中显示的显示名称（默认值为“name”）
- 必填： 将列设置为必填项（默认值：false）
- 隐藏： 隐藏视图中的列（默认值：false）
更新列
更新 SharePoint 列表中的现有列。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- columnId： 要更新的列的 ID
可选参数：
- columnType： 列类型（提供“columnProperties”时需要）
- columnProperties： 要更新的特定类型的属性
- 描述： 新说明
- displayName： 新的显示名称
- 隐藏： 隐藏或显示列
- 必需：使列必需或可选
删除列
从 SharePoint 列表中删除列。 警告： 删除所有项在该列中存储的所有数据。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- columnId： 要删除的列的 ID
主要功能
站点管理
- 按名称查找网站或浏览可访问网站
- 通过确切的 URL 路径访问网站
- 列出子网站和子子网站
- 全面的网站层次结构导航
文档库管理
- 列出网站中的所有文档库
- 获取默认文档库
- 浏览文件夹内容（最多 20 个项目）
- 创建和管理文件夹结构
文件操作
- 创建文本和二进制文件（≤5MB）
- 读取文本和二进制文件（≤5MB）
- 删除、重命名和移动文件
- 跨文档库复制文件和文件夹
- 从 SharePoint 或 OneDrive URL 上传文件
- 在所有可访问网站中搜索文件和文件夹
- 获取文件和文件夹元数据
异步操作
- 跨文档库异步复制文件和文件夹
- 使用操作令牌检查异步操作的状态
列表操作
- 创建、读取和删除列表
- 支持多个列表模板（泛型、文档库、事件、任务）
- 使用基于角色的权限共享列表
- 管理列表项（创建、读取、更新、删除）
列管理
- 创建包含各种类型的列（文本、注释、数字、布尔值、dateTime、选项、查找、用户、URL、计算等）
- 更新列属性和元数据
- 配置列要求和可见性
- 特定于类型的列属性
共享和权限
- 与用户共享文件、文件夹和列表
- 基于角色的访问控制（读取、写入、参与、编辑）
- 用于共享的电子邮件通知
- 邀请中的自定义消息
安全性与合规性
- 应用和删除敏感度标签
- 多个分配方法（标准、特权、自动）
- 审核理由支持
- 使用 eTag 的并发控制
备注
- 文件上传和下载操作限制为≤5MB
- 移动操作只能在同一个文档库内进行
- 复制操作是异步的，请使用
checkOperationStatus来监视进度。 - 复制操作支持 SharePoint 中的跨库复制
-
uploadFileFromUrl需要有效的 SharePoint 或 OneDrive 源 URL - eTag 为更新和删除提供并发控制
- 重复文件夹名称自动添加数字后缀
- 无法撤消列表删除
- 删除列会删除该列中存储的所有数据
- 默认情况下，搜索操作返回前 20 个结果
- 所有操作都使用Microsoft图形 API
注释
MCP 工具名称和参数可能会更改，应避免硬编码依赖项。 场景支持将被维持。