הפניה לשרת MCP של כלי רשימות של SharePoint

חשוב

עליך להיות חלק מתוכנית התצוגה המקדימה של Frontier כדי לקבל גישה מוקדמת ל - Microsoft Agent 365. Frontier מחברת אתכם ישירות עם החידושים האחרונים של Microsoft בתחום הבינה המלאכותית. קבל תכונות פורצות דרך מעשיות, שתף את התובנות שלך עם צוותי מוצרים ועזור לעצב את עתיד הבינה המלאכותית. תצוגות מקדימות של Frontier כפופות לתנאי התצוגה המקדימה הקיימים של הסכמי הלקוחות שלך. כאשר תכונות אלה עדיין בפיתוח, הזמינות והיכולות שלהן עשויות להשתנות עם הזמן.'

מבט כולל

מזהה שרת	שם תצוגה	תיאור
mcp_SharePointListsTools	Microsoft SharePoint Lists MCP Server	שרת MCP המספק כלי Microsoft Graph SharePoint עבור רשימות. שרת MCP המספק כלי Microsoft Graph SharePoint עבור רשימות.

כלים זמינים

sharepoint_createList

צור רשימת SharePoint חדשה באתר.

פרמטרים נדרשים

• מזהה אתר: המזהה הייחודי של האתר
• שם תצוגה: שם תצוגה של הרשימה
• רשימה: פרטי רשימה כגון תבנית (לדוגמה, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

צור עמודה חדשה (columnDefinition) ברשימת SharePoint ספציפית. עליך לספק את siteId ואת ה- listId המשמשים כיעד וכן הגדרת עמודה חוקית המציינת את שם העמודה, שם התצוגה וסוג עמודה אחד בדיוק (כגון טקסט, מספר, בחירה, תאריך ושעה, personOrGroup, בדיקת מידע, ערך בוליאני או היפר-קישורOrPicture).

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר
• מזהה רשימה: המזהה הייחודי של הרשימה
• שם: שם API/סטטי של העמודה (ללא רווחים, 1-64 תווים)

פרמטרים אופציונליים:

• שם תצוגה: שם תצוגה הפונה למשתמש
• תיאור: תיאור עמודה
• אכוף ערכים ייחודיים: אם true, הערכים חייבים להיות ייחודיים
• מוסתרים: אם true, העמודה מוסתרת
• אינדקס: אם הערך נכון, הערכים יתווספה לאינדקס
• חובה: אם true, נדרש ערך
• לקריאה בלבד: אם הערך נכון, לא ניתן לשנות ערכים
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: הגדרות סוג עמודה (נדרשת אחת)

sharepoint_createListItem

צור פריט חדש ברשימת SharePoint.

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר
• מזהה רשימה: המזהה הייחודי של הרשימה
• שדות: ערכי שדה עבור פריט הרשימה (מפת מפתח/ערך)

sharepoint_deleteListColumn

מחק הגדרת עמודה קיימת מרשימת SharePoint ספציפית. הזן את ה-siteId, listId ו-columnId. פעולה זו מסירה לצמיתות את העמודה מסכימת הרשימה.

פרמטרים נדרשים:

• מזהה אתר: מזהה ייחודי של האתר
• מזהה רשימה: מזהה ייחודי של הרשימה
• מזהה עמודה: מזהה ייחודי של העמודה למחיקה

sharepoint_deleteListItem

מחיקת פריט רשימה.

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר
• מזהה רשימה: המזהה הייחודי של הרשימה
• מזהה פריט: המזהה הייחודי של פריט הרשימה

פרמטרים אופציונליים:

• ifMatch: ETag אופציונלי עבור בקרת תזמון (לדוגמה, "*")

sharepoint_editListColumn (עריכת עמודת רשימה בשיירפוינט)

עדכן את הגדרת העמודה (columnDefinition) הקיימת ברשימה ספציפית ב-SharePoint. הזן את ה-siteId, listId ו-columnId. הגוף חלקי - כלול רק את המאפיינים שברצונך לשנות (כגון displayName, תיאור, הגדרות מוסתרות, נדרשות או פיאה).

פרמטרים נדרשים:

• מזהה אתר: מזהה ייחודי של האתר
• מזהה רשימה: מזהה ייחודי של הרשימה
• מזהה עמודה: מזהה ייחודי של העמודה לעדכון

פרמטרים אופציונליים:

• שם תצוגה: שם תצוגה הפונה למשתמש
• תיאור: תיאור עמודה
• מוסתרים: אם true, העמודה מוסתרת
• חובה: אם true, נדרש ערך
• אכוף ערכים ייחודיים: אם true, הערכים חייבים להיות ייחודיים
• אינדקס: אם הערך נכון, הערכים יתווספה לאינדקס
• לקריאה בלבד: אם הערך נכון, לא ניתן לשנות ערכים
• טקסט, מספר, בחירה, תאריך ושעה, personOrGroup, בדיקת מידע, היפר-קישורOrPicture: עדכון הגדרות של סוג עמודה

sharepoint_getSiteByPath

פתור אתר SharePoint באמצעות שם המחשב המארח שלו והנתיב היחסי לשרת.

פרמטרים נדרשים:

• שם מחשב מארח: שם מארח של דייר SharePoint (לדוגמה, contoso.sharepoint.com)
• serverRelativePath: נתיב יחסי לשרת לאתר (לדוגמה, אתרים/שיווק)

sharepoint_listListColumns

הגדרות עמודות רשימה (columnDefinition resources) עבור רשימת SharePoint ספציפית. נדרש siteId ו- listId. תומך בפרמיות OData כגון $select, $top ו- $skiptoken.

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר
• מזהה רשימה: המזהה הייחודי של הרשימה

פרמטרים אופציונליים:

• בחר: רשימת מאפיינים המופרדים באמצעות פסיק להחזרה
• מסנן: ביטוי מסנן OData להגבלת תוצאות
• סדר לפי: רשימת מאפיינים המופרדים באמצעות פסיק לפי סדר
• סביבון: גודל עמוד (1-999)
• skiptoken: אסימון אטום לדילוג לערכה הבאה

sharepoint_listListItems

פרט פריטים מרשימת SharePoint.

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר
• מזהה רשימה: המזהה הייחודי של הרשימה

פרמטרים אופציונליים:

• להרחיב: הרחבת OData אופציונלית (לדוגמה, שדות)
• סביבון: גודל עמוד אופציונלי
• מסנן: ביטוי מסנן OData אופציונלי
• בחר: משפט בחירת OData אופציונלי

sharepoint_listLists

פרט את כל רשימות SharePoint באתר.

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר

sharepoint_listSubsites

פרט אתרי צאצא (אתרי משנה) עבור אתר נתון.

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר

sharepoint_search

חפש ב- SharePoint באמצעות Microsoft Graph Search API עם entityTypes=["site"].

פרמטרים נדרשים:

• בקשות: מערך של אובייקטי searchRequest

פרמטרים אופציונליים:

• סוגי ישות: חייב להיות ["אתר"] עבור חיפושים באתר SharePoint
• שאילתה: אובייקט שאילתה עם מחרוזת חיפוש בסגנון KQL
• מ: היסט מבוסס-אפס של התוצאה הראשונה
• גודל: מספר התוצאות להחזרה (1-50)
• שדות: רשימת שדות אופציונליים לבחירה בתגובה

13.sharepoint_searchSitesByName

חפש באתרי SharePoint לפי שם תצוגה או כתובת URL חלקית (שפה טבעית).

פרמטרים נדרשים:

• חיפוש: שם תצוגה או שם/כתובת URL חלקיים של אתר SharePoint לחיפוש

פרמטרים אופציונליים:

• עקביותרמה: נדרש על-ידי Microsoft Graph (ברירת מחדל: אחרונה)

14. sharepoint_updateListItem

עדכון שדות של פריט רשימה קיים.

פרמטרים נדרשים:

• מזהה אתר: המזהה הייחודי של האתר
• מזהה רשימה: המזהה הייחודי של הרשימה
• מזהה פריט: המזהה הייחודי של פריט הרשימה
• שדות: ערכי שדה לעדכון (חלקי)

פרמטרים אופציונליים:

• ifMatch: אופציונלי ETag לבקרת קדימות (לדוגמה, "*" כדי לכפות)

תכונות עיקריות

ניהול רשימה

• יצירת רשימות SharePoint חדשות עם תבניות
• פרט את כל הרשימות באתר
• תמיכה בתבניות רשימה שונות (genericList, documentLibrary, issueTracking)

פעולות עמודה

• יצירת עמודות עם סוגי נתונים מרובים (טקסט, מספר, בחירה, תאריך ושעה, personOrGroup, בדיקת מידע, בוליאני, hyperlinkOrPicture)
• עריכת עמודות קיימות
• מחיקת עמודות
• פרט את כל העמודות ברשימה
• אילוצי אימות עמודות וייחודיות

פעולות פריט

• יצירת פריטי רשימה עם ערכי שדות
• עדכון פריטי רשימה קיימים (עדכונים חלקיים)
• מחיקת פריטי רשימה
• פריטי רשימה עם סינון וחלוקה לעמודים
• בקרת תאימות בו זמנית באמצעות ETag

גילוי אתר

• חפש אתרים לפי שם או כתובת URL
• פתרון אתרים לפי שם מארח נתיב
• רשימה של אתרי משנה
• חיפוש בסגנון KQL עם Microsoft Graph Search API

תמיכה בשאילתות OData

• השתמש $select כדי לבחור מאפיינים.
• השתמש $filter כדי לסנן תוצאות.
• השתמש $expand כדי לכלול ישויות קשורות.
• השתמש $orderby כדי למיין תוצאות.
• השתמש $top עבור חלוקה לעמודים.
• השתמש $skiptoken כדי לעבור בין ערכות תוצאות גדולות.

תמיכה בסוג עמודה

• עמודות טקסט (טקסט בעל שורה בודדת או טקסט מרובה שורות, טקסט רגיל או עשיר).
• מספר עמודות (עם ערכים עשרוניים, ערכי מינימום ומקסימום).
• עמודות בחירה (תיבות סימון, רשימה נפתחת או לחצני אפשרויות).
• עמודות בוליאניות.
• עמודות DateTime (תאריך בלבד או תאריך ושעה).
• עמודות אדם או קבוצה (בחירה יחידה או בחירה מרובה).
• עמודות בדיקת מידע (הפניה לרשימות אחרות).
• עמודות היפר-קישור או תמונה.

הערות

1. כל הפעולות משתמשות ב- Microsoft Graph API v1.0.
2. שמות עמודות חייבים להכיל 1-64 תווים ללא רווחים.
3. כל עמודה חייבת לציין סוג עמודה אחד בדיוק.
4. בקרת תיאום זמינה דרך הכותרת If-Match.
5. חיפושים באתר דורשים הגדרה consistencyLevel ל- eventual.
6. תוצאות החיפוש מוגבלות ל- 50 פריטים לעמוד.
7. עדכונים חלקיים נתמכים עבור עמודות ופרטי רשימה.