การอ้างอิงเซิร์ฟเวอร์ MCP เครื่องมือรายการ SharePoint

สำคัญ

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

ภาพรวม

ID ของเซิร์ฟเวอร์	ชื่อที่ใช้แสดง	รายละเอียด
mcp_SharePointListsTools	Microsoft SharePoint รายการเซิร์ฟเวอร์ MCP	เซิร์ฟเวอร์ MCP จัดหาเครื่องมือ Microsoft Graph SharePoint สําหรับรายการ เซิร์ฟเวอร์ MCP จัดหาเครื่องมือ Microsoft Graph SharePoint สําหรับรายการ

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

sharepoint_createList

สร้างรายการ SharePoint ใหม่บนไซต์

พารามิเตอร์ที่จำเป็น

• siteId: ID เฉพาะของไซต์
• displayName: ชื่อที่แสดงของรายการ
• รายการ: ข้อมูลรายการ เช่น เทมเพลต (ตัวอย่างเช่น genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

สร้างคอลัมน์ใหม่ (คอลัมน์กําหนด) ในรายการ SharePoint ที่ระบุ คุณต้องระบุ siteId และ listId เป้าหมาย รวมถึงข้อกําหนดคอลัมน์ที่ถูกต้องที่ระบุชื่อของคอลัมน์ ชื่อที่แสดง และชนิดคอลัมน์หนึ่งชนิด (เช่น ข้อความ ตัวเลข ตัวเลือก วันที่เวลา personOrGroup การค้นหา บูลีน หรือ hyperlinkOrPicture)

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

• siteId: ID เฉพาะของไซต์
• listId: ID เฉพาะของรายการ
• ชื่อ: ชื่อ API/static ของคอลัมน์ (ไม่มีช่องว่าง 1-64 อักขระ)

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

• displayName: ชื่อที่แสดงที่ผู้ใช้เชื่อมต่อกัน
• คําอธิบาย: คําอธิบายคอลัมน์
• enforceUniqueValues: ถ้าเป็นจริง ค่าต้องไม่ซ้ํากัน
• ซ่อนอยู่: ถ้าเป็นจริง คอลัมน์จะถูกซ่อนไว้
• indexed: ถ้าเป็นจริง ค่าจะถูกจัดทําดัชนี
• required: ถ้าเป็นจริง ค่าจําเป็น
• readOnly: ถ้าเป็นจริง ค่าจะไม่สามารถเปลี่ยนแปลงได้
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: การตั้งค่าชนิดคอลัมน์ (หนึ่งรายการที่จําเป็น)

sharepoint_createListItem

สร้างรายการใหม่ในรายการ SharePoint

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

• siteId: ID เฉพาะของไซต์
• listId: ID เฉพาะของรายการ
• เขตข้อมูล: ค่าเขตข้อมูลสําหรับหน่วยข้อมูลรายการ (แผนที่คีย์/ค่า)

sharepoint_deleteListColumn

ลบคอลัมน์ที่มีอยู่กําหนดจากรายการ SharePoint ที่ระบุ ระบุ siteId, listId และ columnId การดําเนินการนี้จะเป็นการลบคอลัมน์ออกจาก schema รายการอย่างถาวร

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

• siteId: ID ที่ไม่ซ้ํากันของไซต์
• listId: ID เฉพาะของรายการ
• columnId: ID ที่ไม่ซ้ํากันของคอลัมน์ที่จะลบ

sharepoint_deleteListItem

ลบรายการข้อมูล

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

• siteId: ID เฉพาะของไซต์
• listId: ID เฉพาะของรายการ
• itemId: ID เฉพาะของข้อมูลในรายการ

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

• ifMatch: ETag ทางเลือกสําหรับการควบคุมภาวะพร้อมกัน (เช่น "*")

sharepoint_editListColumn

อัปเดตคอลัมน์ที่มีอยู่กําหนดสําหรับรายการ SharePoint ที่เจาะจง ระบุ siteId, listId และ columnId เนื้อความเป็นบางส่วน - รวมเฉพาะคุณสมบัติที่คุณต้องการเปลี่ยนแปลง (เช่น displayName คําอธิบาย ซ่อน จําเป็น หรือการตั้งค่าแฟเช็ต)

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

• siteId: ID ที่ไม่ซ้ํากันของไซต์
• listId: ID เฉพาะของรายการ
• columnId: ID ที่ไม่ซ้ํากันของคอลัมน์ที่จะอัปเดต

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

• displayName: ชื่อที่แสดงที่ผู้ใช้เชื่อมต่อกัน
• คําอธิบาย: คําอธิบายคอลัมน์
• ซ่อนอยู่: ถ้าเป็นจริง คอลัมน์จะถูกซ่อนไว้
• required: ถ้าเป็นจริง ค่าจําเป็น
• enforceUniqueValues: ถ้าเป็นจริง ค่าต้องไม่ซ้ํากัน
• indexed: ถ้าเป็นจริง ค่าจะถูกจัดทําดัชนี
• readOnly: ถ้าเป็นจริง ค่าจะไม่สามารถเปลี่ยนแปลงได้
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: อัปเดตการตั้งค่าชนิดคอลัมน์

sharepoint_getSiteByPath

แก้ไขไซต์ SharePoint โดยใช้ชื่อโฮสต์และเส้นทางสัมพัทธ์ของเซิร์ฟเวอร์

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

• hostname: ชื่อโฮสต์ของผู้เช่า SharePoint (ตัวอย่างเช่น contoso.sharepoint.com)
• serverRelativePath: เส้นทางสัมพัทธ์ของเซิร์ฟเวอร์ไปยังไซต์ (ตัวอย่างเช่น ไซต์/การตลาด)

sharepoint_listListColumns

แสดงข้อกําหนดคอลัมน์ (ทรัพยากรของคอลัมน์กําหนด) สําหรับรายการ SharePoint เฉพาะ จําเป็นต้องมี siteId และ listId รองรับพารามิเตอร์ OData เช่น $select $top และ$skiptoken

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

• siteId: ID เฉพาะของไซต์
• listId: ID เฉพาะของรายการ

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

• select: รายการคุณสมบัติที่คั่นด้วยจุลภาคเพื่อส่งกลับ
• filter: นิพจน์ตัวกรอง OData เพื่อจํากัดผลลัพธ์
• orderBy: รายการคุณสมบัติที่คั่นด้วยจุลภาคเพื่อเรียงลําดับตาม
• ด้านบน: ขนาดหน้า (1-999)
• skiptoken: โทเค็นแบบทึบสําหรับเพจไปยังชุดถัดไป

sharepoint_listListItems

แสดงรายการจากรายการ SharePoint

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

• siteId: ID เฉพาะของไซต์
• listId: ID เฉพาะของรายการ

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

• ขยาย: ขยาย OData ทางเลือก (ตัวอย่างเช่น เขตข้อมูล)
• ด้านบน: ขนาดหน้าทางเลือก
• filter: นิพจน์ตัวกรอง OData ทางเลือก
• select: Optional OData select clause

sharepoint_listLists

แสดงรายการ SharePoint ทั้งหมดบนไซต์

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

• siteId: ID เฉพาะของไซต์

sharepoint_listSubsites

ทํารายการไซต์ลูก (ไซต์ย่อย) สําหรับไซต์ที่ระบุ

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

• siteId: ID เฉพาะของไซต์

sharepoint_search

ค้นหา SharePoint โดยใช้ API การค้นหา Microsoft Graph ด้วย entityTypes=["site"]

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

• requests: อาร์เรย์ของออบเจ็กต์ searchRequest

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

• entityTypes: ต้องเป็น ["ไซต์"] สําหรับการค้นหาไซต์ SharePoint
• query: ออบเจ็กต์คิวรีที่มีสตริงการค้นหาสไตล์ KQL
• จาก: ออฟเซตที่ยึดตามศูนย์ของผลลัพธ์แรก
• ขนาด: จํานวนผลลัพธ์ที่จะแสดง (1-50)
• เขตข้อมูล: รายการเขตข้อมูลที่เลือกได้เพื่อเลือกในการตอบกลับ

13. sharepoint_searchSitesByName

ค้นหาไซต์ SharePoint ตามชื่อที่แสดงหรือ URL บางส่วน (ภาษาธรรมชาติ)

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

• ค้นหา: ชื่อที่ใช้แสดงหรือชื่อ/URL บางส่วนของไซต์ SharePoint เพื่อค้นหา

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

• consistencyLevel: จําเป็นโดย Microsoft Graph (ค่าเริ่มต้น: ในที่สุด)

14.sharepoint_updateListItem

อัปเดตเขตข้อมูลของข้อมูลในรายการที่มีอยู่

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

• siteId: ID เฉพาะของไซต์
• listId: ID เฉพาะของรายการ
• itemId: ID เฉพาะของข้อมูลในรายการ
• เขตข้อมูล: ค่าเขตข้อมูลที่จะอัปเดต (บางส่วน)

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

• ifMatch: ETag ทางเลือกสําหรับการควบคุมภาวะพร้อมกัน (ตัวอย่างเช่น "*" ที่จะบังคับ)

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

การจัดการรายการ

• สร้างรายการ SharePoint ใหม่ด้วยเทมเพลต
• แสดงรายการทั้งหมดบนไซต์
• การสนับสนุนสําหรับเทมเพลตรายการต่าง ๆ (genericList, documentLibrary, IssueTracking)

คอลัมน์ C – การดำเนินงาน

• สร้างคอลัมน์ที่มีชนิดข้อมูลหลายชนิด (ข้อความ ตัวเลข ตัวเลือก วันที่เวลา บุคคล OrGroup ค้นหา บูลีน ไฮเปอร์ลิงก์ OrPicture)
• แก้ไขคอลัมน์ที่มีอยู่
• ลบคอลัมน์
• แสดงรายการคอลัมน์ทั้งหมดในรายการ
• การตรวจสอบความถูกต้องของคอลัมน์และข้อจํากัดที่ไม่ซ้ํากัน

การดําเนินการหน่วยข้อมูล

• สร้างข้อมูลในรายการด้วยค่าเขตข้อมูล
• อัปเดตรายการที่มีอยู่ (การอัปเดตบางส่วน)
• ลบรายการข้อมูล
• ข้อมูลในรายการที่มีการกรองและการแบ่งหน้า
• การควบคุมภาวะพร้อมกันผ่าน ETag

การค้นหาไซต์

• ค้นหาไซต์ตามชื่อหรือ URL
• แก้ไขไซต์ตามชื่อโฮสต์และเส้นทาง
• ไซต์ย่อยของรายการ
• ค้นหารูปแบบ KQL ด้วย API การค้นหาของ Microsoft Graph

การสนับสนุนคิวรี OData

• ใช้$select เพื่อเลือกคุณสมบัติ
• ใช้$filter เพื่อกรองผลลัพธ์
• ใช้$expand เพื่อรวมเอนทิตีที่เกี่ยวข้อง
• ใช้ $orderby เพื่อเรียงลําดับผลลัพธ์
• ใช้$top สําหรับการแบ่งหน้า
• ใช้$skiptoken กับหน้าผ่านชุดผลลัพธ์ขนาดใหญ่

สนับสนุนชนิดคอลัมน์

• คอลัมน์ข้อความ (บรรทัดเดียวหรือหลายบรรทัด ธรรมดา หรือ Rich Text)
• คอลัมน์ตัวเลข (ที่มีตําแหน่งทศนิยม ค่าต่ําสุด และค่าสูงสุด)
• คอลัมน์ตัวเลือก (กล่องกาเครื่องหมาย ดรอปดาวน์ หรือปุ่มตัวเลือก)
• คอลัมน์บูลีน
• วันที่ เวลา, วันที่และเวลา, เฉพาะวันที่
• คอลัมน์บุคคลหรือกลุ่ม (ตัวเลือกเดียวหรือหลายรายการ)
• คอลัมน์การค้นหา (อ้างอิงรายการอื่นๆ)
• ไฮเปอร์ลิงก์หรือคอลัมน์รูปภาพ

หมายเหตุ

1. การดําเนินการทั้งหมดใช้ Microsoft Graph API v1.0
2. ชื่อคอลัมน์ต้องมีอักขระ 1-64 ตัว โดยไม่มีช่องว่าง
3. แต่ละคอลัมน์ต้องระบุชนิดคอลัมน์เดียวเท่านั้น
4. การควบคุมภาวะพร้อมกันจะพร้อมใช้งานผ่าน If-Match ส่วนหัว
5. การค้นหาไซต์จําเป็นต้องมีconsistencyLevelการตั้งค่าเป็นeventual
6. ผลลัพธ์การค้นหาจะถูกจํากัดไว้ที่ 50 รายการต่อหน้า
7. การอัปเดตบางส่วนสนับสนุนสําหรับคอลัมน์และรายการ