แชร์ผ่าน


การอ้างอิง Microsoft SharePoint และ OneDrive MCP Server

สำคัญ

คุณจําเป็นต้องเป็นส่วนหนึ่งของโปรแกรมการแสดงตัวอย่าง Frontier เพื่อเข้าถึง Microsoft Agent 365 ก่อน Frontier เชื่อมต่อคุณโดยตรงกับนวัตกรรม AI ล่าสุดของ Microsoft การแสดงตัวอย่างในส่วนหน้าจะต้องอยู่ภายใต้ข้อกําหนดการแสดงตัวอย่างที่มีอยู่ของข้อตกลงของลูกค้าของคุณ เนื่องจากคุณลักษณะเหล่านี้ยังคงอยู่ในการพัฒนา ความพร้อมใช้งานและความสามารถของพวกเขาอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป

ภาพรวม

ID ของเซิร์ฟเวอร์ ชื่อที่ใช้แสดง รายละเอียด
mcp_ODSPRemoteServer SharePoint และ OneDrive ใน Microsoft 365 เซิร์ฟเวอร์ MCP มีเครื่องมือสําหรับการทํางานกับเนื้อหา SharePoint และ OneDrive ของคุณ เซิร์ฟเวอร์นี้เชื่อมต่อกับเซิร์ฟเวอร์ SharePoint Online MCP เฉพาะผู้เช่าของคุณ ซึ่งค้นพบโดยอัตโนมัติและทําให้มีเครื่องมือทั้งหมดที่สนับสนุนการรวมไฟล์ OneDrive และ SharePoint ที่เปิดเผยโดยจุดสิ้นสุด ODSP MCP

เครื่องมือที่พร้อมใช้งาน

createFolder

สร้างโฟลเดอร์ใหม่ภายในไลบรารีเอกสารที่ระบุให้เป็นโฟลเดอร์ย่อยของโฟลเดอร์แม่ที่ระบุ ถ้าคุณไม่ได้ระบุไลบรารีเอกสาร เซิร์ฟเวอร์จะใช้ OneDrive ของผู้ใช้ ถ้าคุณไม่ได้ระบุโฟลเดอร์แม่ เซิร์ฟเวอร์จะสร้างโฟลเดอร์ที่ราก ถ้ามีโฟลเดอร์ที่มีชื่อเดียวกันอยู่แล้ว เซิร์ฟเวอร์จะสร้างโฟลเดอร์ใหม่ด้วยคําต่อท้ายตัวเลข เช่นNewFolder (1)

พารามิเตอร์ที่ต้องการ

  • folderName(string) – ชื่อของโฟลเดอร์ที่จะสร้าง ถ้ามีโฟลเดอร์ที่มีชื่อเดียวกันอยู่แล้ว เซิร์ฟเวอร์จะเพิ่มคําต่อท้ายตัวเลขลงในชื่อโฟลเดอร์ใหม่ เช่นNewFolder (1)
  • documentLibraryId(string) – ID ของไลบรารีเอกสาร (หรือที่เรียกว่าไดรฟ์) ที่คุณต้องการสร้างโฟลเดอร์ ถ้าคุณต้องการสร้างโฟลเดอร์ในไดรฟ์ของผู้ใช้หรือ OneDrive ของผู้ใช้ เช่น "ไดรฟ์ของฉัน" หรือ "onedrive ของฉัน" ให้documentLibraryIdส่ง"me"เป็น

พารามิเตอร์เพิ่มเติม

  • parentFolderId(string, default = "root") – ID ของโฟลเดอร์หลักที่ใช้สร้างโฟลเดอร์ใหม่ ค่าเริ่มต้นไปยังรากของไลบรารีเอกสารถ้าไม่ได้ระบุไว้

findSite

ค้นหาไซต์ SharePoint ที่ผู้ใช้สามารถเข้าถึงได้ เครื่องมือนี้สามารถค้นหาไซต์ที่ระบุโดยยึดตามแบบสอบถามการค้นหาที่คุณให้หรือค้นหาไซต์ที่เกี่ยวข้อง 20 อันดับแรกที่สามารถเข้าถึงได้โดยผู้ใช้ถ้าคุณไม่มีคิวรีการค้นหา

พารามิเตอร์ที่ต้องการ

ไม่มี

พารามิเตอร์เพิ่มเติม

  • searchQuery(string, default = null) – คิวรีการค้นหาที่สามารถเป็นชื่อไซต์ทั้งหมดหรือบางส่วน การกําหนดแบบสอบถามการค้นหาจะช่วยในการค้นหาไซต์ได้อย่างมีประสิทธิภาพ แต่ถ้าผู้ใช้กําลังค้นหาไซต์ใดไซต์หนึ่ง ตัวอย่างเช่น ถ้าผู้ใช้ร้องขอไซต์ที่เรียกว่า xyzคุณจะส่งผ่านxyzเป็นsearchQuery ถ้าผู้ใช้ขอเพียง "ไซต์ของฉัน" คุณปล่อยให้พารามิเตอร์นี้ว่างเปล่า

listDocumentLibrariesInSite

แสดงรายการไลบรารีเอกสาร (หรือที่เรียกว่า ไดรฟ์) ในไซต์ SharePoint ที่ระบุ ถ้าคุณไม่ได้ระบุไซต์ เซิร์ฟเวอร์จะใช้ไซต์ราก

พารามิเตอร์ที่ต้องการ

ไม่มี

พารามิเตอร์เพิ่มเติม

  • siteId: ID ไซต์ (ค่าเริ่มต้น: ราก)

findFileOrFolder

ค้นหาไฟล์หรือโฟลเดอร์ (หรือที่เรียกว่า DriveItem) ที่ผู้ใช้สามารถเข้าถึงได้โดยการส่งผ่านคิวรีค้นหา

พารามิเตอร์ที่ต้องการ

  • searchQuery: คิวรีค้นหาที่สามารถเป็นชื่อไฟล์ทั้งหมดหรือบางส่วน

เปลี่ยนชื่อ FileOrFolder

เปลี่ยนชื่อไฟล์หรือโฟลเดอร์ (หรือที่เรียกว่า DriveItems) ภายในไลบรารีเอกสารที่ระบุ หมายเหตุ: ชื่อใหม่ต้องเป็นไปตามข้อกําหนดการตั้งชื่อ

พารามิเตอร์ที่ต้องการ

  • documentLibraryId: ID ไลบรารีเอกสาร (สตริง)
  • fileOrFolderId: ID ไฟล์หรือโฟลเดอร์ (สตริง)
  • newFileOrFolderName: ชื่อใหม่สําหรับไฟล์หรือโฟลเดอร์ (สตริง)

deleteFileOrFolder

ลบแฟ้มหรือโฟลเดอร์จากไลบรารีเอกสารที่ระบุ

พารามิเตอร์ที่ต้องการ

  • documentLibraryId: ID ไลบรารีเอกสาร (สตริง)
  • fileOrFolderId: ID ไฟล์หรือโฟลเดอร์ (สตริง)

readSmallTextFile

อ่าน (ดาวน์โหลด) แฟ้มข้อความจากไลบรารีเอกสารที่ระบุ ถ้าคุณไม่ได้ระบุไลบรารีเอกสาร จะมีการใช้ OneDrive ของผู้ใช้ คุณจําเป็นต้องระบุ fileId (driveItemId ของไฟล์) เพื่อระบุและดาวน์โหลดไฟล์

พารามิเตอร์ที่ต้องการ

  • fileId(string)
  • documentLibraryId(string) – Id ของไลบรารีเอกสาร (หรือที่เรียกว่าไดรฟ์) ของไฟล์ที่คุณต้องการอ่าน ถ้าผู้ใช้ขอให้คุณอ่านหรือดาวน์โหลดไฟล์ในไดรฟ์ของพวกเขาหรือ Onedrive ของพวกเขา ตัวอย่างเช่น อ่านไฟล์ใน "ไดรฟ์ของฉัน" อ่านไฟล์ใน "onedrive ของฉัน" คุณควรส่งใน "ฉัน" เป็น documentLibraryId

moveSmallFile

ย้ายแฟ้มที่อยู่ในไลบรารีเอกสารที่ระบุไปยังโฟลเดอร์อื่น เครื่องมือนี้สนับสนุนเฉพาะการย้ายสําหรับไฟล์ที่น้อยกว่า 5 เมกะไบต์ และย้ายที่อยู่ภายในไซต์เดียวกัน คุณไม่สามารถย้ายไฟล์ระหว่างไดรฟ์โดยใช้คําขอนี้ได้

พารามิเตอร์ที่ต้องการ

  • documentLibraryId(string) – Id ของไลบรารีเอกสาร (หรือที่เรียกว่าไดรฟ์) ของไฟล์ที่คุณต้องการย้าย ถ้าผู้ใช้ขอให้คุณย้ายไฟล์ในไดรฟ์ของพวกเขาหรือ Onedrive ของพวกเขา - ย้ายไฟล์ใน "ไดรฟ์ของฉัน", ย้ายไฟล์ใน "onedrive ของฉัน" คุณควรส่งใน "me" เป็น documentLibraryId
  • fileId(string) – รหัสของไฟล์ที่จะย้าย
  • newParentFolderId(string) – ID ของโฟลเดอร์เป้าหมายเมื่อต้องย้ายไฟล์เข้าไป ควรอยู่ในไลบรารีเอกสารเดียวกันกับตําแหน่งที่ตั้งเดิมของแฟ้ม

getFileOrFolderMetadata

รับเมตาดาต้าของไฟล์หรือโฟลเดอร์จากไลบรารีเอกสารที่ระบุในไซต์ Sharepoint

พารามิเตอร์ที่ต้องการ

  • FileOrFolderId(string) – Id ของไฟล์หรือโฟลเดอร์ นอกจากนี้ยังเรียกว่า DriveItems อีกด้วย และในบางครั้ง Id ของพวกเขายังสามารถเรียกว่า driveItemId
  • documentLibraryId(string) – Id ของไลบรารีเอกสาร (หรือที่เรียกว่าไดรฟ์) ของไฟล์หรือโฟลเดอร์ที่คุณต้องการเมตาดาต้า ถ้าผู้ใช้ขอให้คุณรับไฟล์หรือโฟลเดอร์ในไดรฟ์หรือ Onedrive ของผู้ใช้ เช่น "รับเมตาดาต้าของไฟล์ในไดรฟ์ของฉัน" หรือ "รับเมตาดาต้าของโฟลเดอร์ใน onedrive ของฉัน" คุณควรส่ง ใน "ฉัน" เป็น documentLibraryId

createSmallTextFile

สร้างหรืออัปโหลดไฟล์ข้อความที่มีขนาดเล็กกว่า 5 เมกะไบต์ไปยังไลบรารีเอกสารที่ระบุ ถ้าคุณไม่ได้ระบุไลบรารีเอกสาร จะมีการใช้ OneDrive ของผู้ใช้ คุณสามารถอัปโหลดไฟล์ไปยังโฟลเดอร์ที่ระบุได้ ถ้าคุณไม่ได้ระบุโฟลเดอร์ ไฟล์จะถูกอัปโหลดไปยังโฟลเดอร์ราก

พารามิเตอร์ที่ต้องการ

  • filename (string) – ชื่อของไฟล์ที่จะสร้าง
  • contentText (สตริง) – เนื้อหาข้อความของไฟล์ที่จะสร้าง
  • documentLibraryId (สตริง) – ID ของไลบรารีเอกสาร (หรือที่เรียกว่าไดรฟ์) สําหรับไฟล์ ถ้าผู้ใช้ขอให้คุณสร้างไฟล์ในไดรฟ์ของพวกเขาหรือ OneDrive ของพวกเขา เช่น "สร้างไฟล์ในไดรฟ์ของฉัน" หรือ "สร้างไฟล์ใน onedrive ของฉัน" ส่ง "me" เป็น documentLibraryId

พารามิเตอร์เพิ่มเติม

  • parentfolderId(string, default = "root") – ID โฟลเดอร์ภายในไดรฟ์เพื่อเพิ่มไฟล์ใหม่

getFileOrFolderMetadataByUrl

รับเมตาดาต้าสําหรับไฟล์หรือโฟลเดอร์จาก URL การแชร์ เฉพาะผู้ใช้ที่มีสิทธิ์อย่างชัดเจนในการเข้าถึงไฟล์เท่านั้นที่สามารถรับเมตาดาต้าได้

พารามิเตอร์ที่ต้องการ

  • fileOrFolderUrl:(string) – URL ของไฟล์หรือโฟลเดอร์ (หรือที่เรียกว่า DriveItems) URL ไม่ได้ถูกแลกใช้เพื่อแชร์กับผู้ใช้ แต่จะไม่สามารถแชร์กับผู้ใช้ได้ พวกเขาต้องมีสิทธิ์เข้าถึงไฟล์อย่างชัดเจน

shareFileOrFolder

ส่งคําเชิญให้ใช้ร่วมกันเพื่อให้สิทธิ์บนแฟ้มหรือโฟลเดอร์ภายในไลบรารีเอกสารที่ระบุ สนับสนุนการกําหนดบทบาทและแจ้งผู้รับ

พารามิเตอร์ที่ต้องการ

  • documentLibraryId: ID ไลบรารีเอกสาร (สตริง จําเป็น)
  • fileOrFolderId: ID ไฟล์หรือโฟลเดอร์ (สตริง จําเป็น)
  • recipientEmails:(string[], Required) – ที่อยู่อีเมลของผู้รับที่จะเชิญ ต้องมีอีเมลผู้รับอย่างน้อยหนึ่งอีเมล

พารามิเตอร์เพิ่มเติม

  • roles(string[]) – บทบาทเพื่อกําหนดให้กับผู้รับ ค่าที่ยอมรับ: อ่าน เขียน (เขียนอนุญาตให้ทั้งอ่านและเขียนเข้าถึง) ค่าเริ่มต้นในการอ่านบทบาทถ้าไม่ได้ระบุ
  • sendInvitation(bool, default = true) – ระบุว่าจะส่งคําเชิญการแชร์หรือไม่ ค่าเริ่มต้นเป็น true ถ้าไม่ได้ระบุ
  • message(string, default = "นี่คือไฟล์ที่เราทํางานร่วมกัน") – ข้อความแบบกําหนดเองที่จะรวมอยู่ในอีเมลการเชิญ ค่าเริ่มต้นเป็นข้อความมาตรฐานถ้าไม่ได้ระบุ

getFolderChildren

ระบุแฟ้มและโฟลเดอร์ 20 อันดับแรกภายในโฟลเดอร์หลักที่ระบุในไลบรารีเอกสาร ถ้าคุณไม่ได้ระบุไลบรารีเอกสาร จะมีการใช้ OneDrive ของผู้ใช้

พารามิเตอร์ที่ต้องการ

  • documentLibraryId(string) – ID ของไลบรารีเอกสาร (หรือที่เรียกว่าไดรฟ์) สําหรับโฟลเดอร์หลัก ถ้าผู้ใช้ขอให้คุณรับไฟล์ในโฟลเดอร์ในไดรฟ์ของพวกเขาหรือ OneDrive ของพวกเขา เช่น "รับไฟล์ในโฟลเดอร์ในไดรฟ์ของฉัน" หรือ "รับไฟล์ในโฟลเดอร์ใน Onedrive ของฉัน" ส่ง "ฉัน" เป็น documentLibraryId

พารามิเตอร์เพิ่มเติม

  • parentFolderId:(string, default = "root") – ID ของโฟลเดอร์หลัก (DriveItem) ที่มีรายการแฟ้มและโฟลเดอร์ ค่าเริ่มต้นไปยังโฟลเดอร์รากของไลบรารีเอกสารถ้าไม่ได้ระบุไว้

ก้อง

ส่งข้อความกลับไปยังไคลเอ็นต์

พารามิเตอร์ที่ต้องการ

  • ข้อความ: ข้อความที่จะส่งกลับ

setSensitivityLabelOnFile

ตั้งค่าป้ายชื่อระดับความลับของไฟล์จากไลบรารีเอกสารที่ระบุ

พารามิเตอร์ที่ต้องการ

  • documentLibraryId(string) – ID ไลบรารีเอกสาร หรือที่เรียกว่า driveId ของไลบรารีเอกสาร
  • fileId(string) – ID ไฟล์หรือที่เรียกว่า driveItemId ของไฟล์
  • sensitivityLabelId(string) – จําเป็น ID ของป้ายชื่อระดับความลับที่จะกําหนดหรือสตริงว่างเพื่อลบป้ายชื่อระดับความลับออก

พารามิเตอร์เพิ่มเติม

  • assignmentMethod(string, default = "privileged") - วิธีการกําหนดป้ายชื่อบนเอกสาร ระบุว่าการกําหนดป้ายชื่อถูกดําเนินการโดยอัตโนมัติ มาตรฐาน หรือเป็นการดําเนินการที่มีสิทธิ์ใช้งาน (เทียบเท่ากับการดําเนินการของผู้ดูแลระบบ) หรือไม่ ค่าที่เป็นไปได้คือ มาตรฐาน สิทธิพิเศษ อัตโนมัติ และ unknownFutureValue
  • justificationText(string, default = "Changed by MCPServer") – ทางเลือก การจัดข้อความให้เหมาะสมเพื่อวัตถุประสงค์การตรวจสอบ และจําเป็นเมื่อดาวน์เกรดหรือลบป้ายชื่อออก

getDefaultDocumentLibraryInSite

รับไลบรารีเอกสารเริ่มต้น (หรือที่เรียกว่า ไดรฟ์) ในไซต์ SharePoint ถ้าคุณไม่ได้ระบุไซต์ จะใช้ไซต์ราก

พารามิเตอร์ที่ต้องการ

ไม่มี

พารามิเตอร์เพิ่มเติม

  • siteId: ID ไซต์ (ค่าเริ่มต้น: ราก)

คุณลักษณะสำคัญ

การจัดการโฟลเดอร์

  • การสร้างโฟลเดอร์ที่มีการแก้ไขข้อขัดแย้งของการตั้งชื่ออัตโนมัติ
  • ระบุโฟลเดอร์ย่อย (20 อันดับแรก)
  • ย้ายแฟ้มระหว่างโฟลเดอร์ (ภายในไซต์เดียวกัน)

การดำเนินการขาย

  • สร้างและอัปโหลดไฟล์ข้อความขนาดเล็ก (< 5MB)
  • อ่านและดาวน์โหลดไฟล์ข้อความ
  • เปลี่ยนชื่อไฟล์และโฟลเดอร์
  • ลบแฟ้มและโฟลเดอร์
  • รับเมตาดาต้าของไฟล์และโฟลเดอร์ตาม ID หรือ URL

การค้นพบไซต์และไลบรารี

  • ค้นหาไซต์ SharePoint ตามคิวรีการค้นหา
  • ทํารายการไลบรารีเอกสารในไซต์
  • รับไลบรารีเอกสารเริ่มต้น

การแชร์และสิทธิ์

  • แชร์ไฟล์และโฟลเดอร์ด้วยการกําหนดบทบาท
  • ส่งคําเชิญการแชร์ด้วยข้อความแบบกําหนดเอง
  • ควบคุมการเข้าถึงผ่านการอนุญาตอย่างชัดเจน

การรักษาความปลอดภัยและการปฏิบัติตามข้อกำหนด

  • ตั้งค่าป้ายชื่อระดับความลับบนไฟล์
  • การสนับสนุนสําหรับวิธีการที่มีสิทธิ์พิเศษ มาตรฐาน และอัตโนมัติ
  • การจัดข้อความสําหรับการตรวจสอบการปฏิบัติตามกฎระเบียบ

การรวม

  • การสนับสนุน OneDrive และ SharePoint Online
  • การเชื่อมต่อเซิร์ฟเวอร์เฉพาะผู้เช่า
  • นามธรรม DriveItem สําหรับไฟล์และโฟลเดอร์

หมายเหตุ

  1. ไลบรารีเอกสารเริ่มต้นคือ 'me' (OneDrive ของผู้ใช้)
  2. โฟลเดอร์หลักเริ่มต้นคือ 'root'
  3. ความขัดแย้งของชื่อโฟลเดอร์แก้ไขด้วยคําต่อท้ายตัวเลข
  4. ไฟล์ย้ายจํากัดไว้ที่น้อยกว่า 5 เมกะไบต์และภายในไซต์เดียวกัน
  5. การแชร์ URL จําเป็นต้องมีสิทธิ์การเข้าถึงอย่างชัดเจน
  6. DriveItems แสดงทั้งไฟล์และโฟลเดอร์
  7. ขีดจํากัดสูงสุด 20 รายการบนโฟลเดอร์การแจงนับย่อย