Microsoft SharePoint 與 OneDrive MCP Server 參考

概觀

可用工具

CreateFolder

在指定的文件庫中建立一個新資料夾，作為指定的父資料夾的子資料夾。 如果你沒有指定文件庫，伺服器會使用使用者的 OneDrive。 如果你沒有指定父資料夾，伺服器會在根目錄建立該資料夾。 如果已有同名資料夾，伺服器會建立帶有數字後綴的新資料夾，例如 NewFolder (1)。

必要參數

• folderName（string） – 要建立的資料夾名稱。 如果已有同名資料夾存在，伺服器會在新資料夾名稱後加上數字後綴，例如 NewFolder (1)。
• documentLibraryId（字串） — 文件庫（也稱為磁碟機）的 ID，用於建立資料夾。 如果你想在使用者的磁碟或 OneDrive 中建立資料夾，例如「我的磁碟」或「我的 OneDrive」，請以 "me"documentLibraryId.

選用參數。

• parentFolderId（字串，預設 = “root”） ——新資料夾將建立的父資料夾的 ID。 若未指定，則預設為文件庫的根節點。

findSite

找到使用者可存取的 SharePoint 網站。 這個工具可以根據你提供的搜尋查詢找到特定網站，或者如果你沒有提供搜尋查詢，就能找到使用者可存取的前 20 個相關網站。

必要參數

否

選用參數。

• searchQuery（字串，預設 = null） – 搜尋查詢，可以是整個或部分網站名稱。 提供搜尋查詢有助於有效搜尋網站，但前提是使用者在尋找特定網站。 例如，如果使用者要求一個名為 xyz的網站，你會被誤認為 xyzsearchQuery。 如果使用者只要求「我的網站」，這個參數就留空。

listDocumentLibrariesInSite

在指定的 SharePoint 網站上列出文件庫（也稱為磁碟）。 如果你沒指定站點，伺服器就會使用根站。

必要參數

否

選用參數。

• siteId： 網站 ID（預設：根目錄）

findFile或Folder

透過傳遞搜尋查詢，使用者可找到一個檔案或資料夾（也稱為 DriveItem）。

必要參數

• searchQuery： 搜尋查詢可以是整個或部分檔案名稱

renameFileOrFolder

在指定的文件庫中重新命名檔案或資料夾（也稱為 DriveItems）。 注意：新名稱必須遵守命名慣例。

必要參數

• documentLibraryId： 文件庫 ID （字串）
• fileOrFolderId： 檔案或資料夾 ID （字串）
• newFileOrFolderName： 檔案或資料夾 （字串）的新名稱

deleteFileOrFolder

從指定的文件庫中刪除一個檔案或資料夾。

必要參數

• documentLibraryId： 文件庫 ID （字串）
• fileOrFolderId： 檔案或資料夾 ID （字串）

readSmallTextFile

閱讀（下載）特定文件庫中的文字檔。 如果你沒有指定文件庫，使用者的 OneDrive 就會被使用。 你需要提供一個檔案 ID（檔案的 driveItemId）來識別並下載該檔案。

必要參數

• fileId（字串）
• documentLibraryId（string） – 你想讀取檔案的文件庫（也稱為磁碟機）的 ID。 如果使用者要求你讀取或下載他們硬碟或 OneDrive 裡的檔案——讀取「我的硬碟」中的檔案，讀取「我的 OneDrive」檔案，你應該以 documentLibraryID 的方式傳送「我」。

移動小檔案

將指定文件庫中的檔案移到另一個資料夾。 此工具僅支援小於 5 MB 的檔案及同一網站內的移動。 你無法用這個請求在磁碟機間移動檔案。

必要參數

• documentLibraryId（string） – 你想移動檔案的文件庫（也稱為磁碟機）的 ID。 如果使用者請你移動他們硬碟或 OneDrive 裡的檔案——例如移動「我的硬碟」裡的檔案，移動「我的 OneDrive 檔案」，你應該把「我」當作 documentLibraryId。
• fileId（string） – 要移動的檔案 ID
• newParentFolderId（string） – 將檔案移入的目標資料夾的 ID。 應該和原始檔案位置在同一個文件庫裡。

getFileOrFolderMetadata

從指定的文件庫取得檔案或資料夾的元資料，位於 SharePoint 網站中。

必要參數

• FileOrFolderId（string） – 檔案或資料夾的 ID。 它們也被稱為DriveItems。 他們的 ID 有時也會被稱為 driveItemId。
• documentLibraryId（字串） — 您需要檔案或資料夾中元資料的文件庫（也稱為磁碟機）的 ID。 如果使用者要求你在他們的硬碟或 OneDrive 中取得檔案或資料夾——例如「取得我硬碟中檔案的中繼資料」或「取得我 onedrive 資料夾的中繼資料」，你應該以 documentLibraryID 的方式輸入「我」。

createSmallTextFile

建立或上傳小於 5 MB 的文字檔至特定文件庫。 如果你沒有指定文件庫，使用者的 OneDrive 就會被使用。 您可以上傳特定檔案： 如果你沒指定資料夾，檔案就會上傳到根目錄。

必要參數

• 檔名 （字串）– 要建立的檔案名稱
• contentText （字串）– 用於建立檔案的文字內容
• documentLibraryId （字串）— 文件庫（亦稱為磁碟機）的檔案ID。 如果使用者請你在他們的磁碟或 OneDrive 建立檔案，例如「在我的磁碟建立檔案」或「在我的 OneDrive 建立檔案」，請以 documentLibraryID 發送「me」。

選用參數。

• parentfolderId（string，default = “root”）– 磁碟內的資料夾 ID，用於新增新檔案。

getFileOrFolderMetadataByUrl

從共享網址取得檔案或資料夾的元資料。 只有擁有明確權限存取檔案的使用者才能取得這些元資料。

必要參數

• fileOrFolderUrl：（string） – 檔案或資料夾的網址（亦稱為 DriveItems）。 網址不會兌換來分享給使用者;他們必須已經有明確存取權限。

shareFile或Folder

發送分享邀請，授予指定文件庫中檔案或資料夾的權限。 支援分配角色及通知收件人。

必要參數

• documentLibraryId： 文件庫 ID （字串，必填）
• fileOrFolderId： 檔案或資料夾 ID （字串，必需）
• 收件人電子郵件：（string[]， 必填） – 邀請收件人的電子郵件地址。 至少需要一位收件者。

選用參數。

• roles（string[]） – 指派給收件人的角色。 接受值：讀取、寫入（寫入同時授予讀寫存取權限）。 如果未指定， 會預設為 10000。
• sendInvitation（bool，default = true） – 表示是否要發送分享邀請。 如果未指定， 會預設為 10000。
• message（string，預設 = 「這是我們正在合作的檔案。」） – 邀請郵件中可包含的自訂訊息。 若未指定，則預設為標準訊息。

getFolderChildren

列舉文件庫中指定父資料夾內前 20 個檔案與資料夾。 如果你沒有指定文件庫，使用者的 OneDrive 就會被使用。

必要參數

• documentLibraryId（字串） — 父資料夾文件庫（亦稱為磁碟機）的 ID。 如果使用者要求你將檔案放進他們硬碟或 OneDrive 的資料夾，例如「在我的硬碟資料夾裡取得檔案」或「在我的 OneDrive 資料夾裡取得檔案」，請以 documentLibraryID 發送「我」。

選用參數。

• parentFolderId：（string，default = “root”） – 列出檔案與資料夾的父資料夾（DriveItem）的 ID。 若未指定，則預設為文件庫的根目錄。

Echo

用戶端傳送訊息給伺服器

必要參數

• 訊息： 回覆訊息

setSensitivityLabelOnFile

從指定的文件庫中設定檔案的敏感性標籤。

必要參數

• documentLibraryId（字串） — 文件庫的 ID，也稱為 driveId，屬於文件庫
• fileId（string） – 檔案的 ID，也稱為 driveItemId，是檔案的
• sensitivityLabelId（string） – 必須。 指定敏感度標籤的 ID，或空字串以移除敏感度標籤。

選用參數。

• assignmentMethod（字串，預設 = 「privileged」） -文件標籤的指派方法。 指示標籤的指派是自動、標準還是特權操作（相當於管理員操作）。 可能的值有標準值、特權值、自動值和未知未來值。
• justificationText（string， default = “Changed by MCPServer”）– 可選。 為稽核目的提供說明文字，且在降級或移除標籤時必須填寫。

getDefaultDocumentLibraryInSite

在 SharePoint 網站取得預設的文件庫（也稱為 Drive）。 如果你沒有指定網站，就會使用根網站。

必要參數

否

選用參數。

• siteId： 網站 ID（預設：根目錄）

主要功能

資料夾管理

• 建立具有自動命名衝突解決的資料夾
• 列舉資料夾子（前20名）
• 在同一網站內資料夾間移動檔案

檔案作業

• 建立並上傳小型文字檔案（< 5MB）
• 閱讀與下載文字檔案
• 瀏覽檔案和資料夾
• 刪除檔案和資料夾
• 依 ID 或網址取得檔案與資料夾的元資料

遺址與圖書館發現

• 透過搜尋查詢尋找 SharePoint 網站
• 在網站上列出文件函式庫
• 取得預設的文件庫

共用和權限

• 以角色分配分享檔案與資料夾
• 發送包含自訂訊息的分享邀請函
• 透過明確權限進行存取控制

安全性與合規性

• 在檔案上設定敏感度標籤
• 支援特權、標準及自動指派方法
• 合規稽核的說明文本

整合

• OneDrive 與 SharePoint Online 支援
• 租戶專用伺服器連線
• 檔案與資料夾的 DriveItem 抽象化

注意事項

1. 預設文件庫是「我」（使用者的 OneDrive）
2. 預設的父資料夾是「root」資料夾
3. 資料夾名稱衝突以數字後綴解決
4. 檔案移動限制在 5 MB 以下，且僅限於同一網站內
5. 分享網址需要明確的存取權限
6. DriveItems 同時代表檔案與資料夾
7. 資料夾子節點列舉的前20名限制