SharePoint सूचियाँ उपकरण MCP सर्वर संदर्भ

महत्त्वपूर्ण

Microsoft Agent 365 तक शीघ्र पहुँच प्राप्त करने के लिए आपको Frontier पूर्वावलोकन प्रोग्राम का भाग बनने की आवश्यकता है. फ्रंटियर आपको सीधे Microsoft के नवीनतम AI नवाचारों से जोड़ता है। फ्रंटियर पूर्वावलोकन आपके ग्राहक समझौतों की मौजूदा पूर्वावलोकन शर्तों के अधीन हैं। चूंकि ये सुविधाएँ अभी भी विकास में हैं, इसलिए उनकी उपलब्धता और क्षमताएं समय के साथ बदल सकती हैं।

ओवरव्यू

सर्वर आईडी	डिस्प्ले का नाम	विवरण
mcp_SharePointListsTools	Microsoft SharePoint सूचियाँ MCP सर्वर	सूचियों के लिए Microsoft ग्राफ़ SharePoint उपकरण प्रदान करने वाला MCP सर्वर. सूचियों के लिए Microsoft ग्राफ़ SharePoint उपकरण प्रदान करने वाला MCP सर्वर.

उपलब्ध उपकरण

sharepoint_createList

किसी साइट पर एक नई SharePoint सूची बनाएँ.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• displayName: सूची का प्रदर्शन नाम
• सूची: सूची जानकारी जैसे टेम्पलेट (उदाहरण के लिए, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

किसी विशिष्ट SharePoint सूची में एक नया स्तंभ (columnDefinition) बनाएँ. आपको लक्ष्य siteId और listId प्रदान करना होगा, साथ ही एक मान्य स्तंभ परिभाषा प्रदान करनी होगी जो स्तंभ का नाम, प्रदर्शन नाम और ठीक एक स्तंभ प्रकार (जैसे पाठ, संख्या, विकल्प, दिनांक समय, personOrGroup, लुकअप, बूलियन या hyperlinkOrPicture) निर्दिष्ट करती है.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की अनन्य ID
• नाम: कॉलम का एपीआई/स्थिर नाम (कोई रिक्त स्थान नहीं, 1-64 वर्ण)

वैकल्पिक पैरामीटर

• displayName: उपयोगकर्ता का सामना करने वाला प्रदर्शन नाम
• विवरण: स्तंभ विवरण
• enforceUniqueValues: यदि सत्य है, तो मान अद्वितीय होना चाहिए
• छिपा हुआ: यदि सत्य है, तो स्तंभ छिपा हुआ है
• अनुक्रमित: यदि सत्य है, तो मान अनुक्रमित होते हैं
• आवश्यक: यदि सत्य है, तो एक मान आवश्यक है
• केवल: यदि सत्य है, तो मानों को बदला नहीं जा सकता
• पाठ, संख्या, पसंद, बूलियन, दिनांक समय, व्यक्तिया समूह, लुकअप, हाइपरलिंकया चित्र: स्तंभ प्रकार सेटिंग्स (एक आवश्यक)

sharepoint_createListItem

किसी SharePoint सूची में कोई नया आइटम बनाएँ.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की अनन्य ID
• फ़ील्ड्स: सूची आइटम के लिए फ़ील्ड मान (कुंजी/मान मानचित्र)

sharepoint_deleteListColumn

किसी विशिष्ट SharePoint सूची से किसी मौजूदा columnDefinition को हटाएँ. siteId, listId और columnId प्रदान करें। यह क्रिया स्तंभ को सूची स्कीमा से स्थायी रूप से निकाल देती है.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की विशिष्ट ID
• columnId: हटाने के लिए स्तंभ की अनन्य ID

sharepoint_deleteListItem

सूची आइटम हटाएं.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की अनन्य ID
• itemId: सूची आइटम की अनन्य ID

वैकल्पिक पैरामीटर

• ifMatch: समवर्ती नियंत्रण के लिए वैकल्पिक ETag (उदाहरण के लिए, "*")

sharepoint_editListColumn

किसी विशिष्ट SharePoint सूची पर किसी मौजूदा columnDefinition का अद्यतन करें. siteId, listId और columnId प्रदान करें। मुख्य भाग आंशिक है - केवल उन गुणों को शामिल करें जिन्हें आप बदलना चाहते हैं (जैसे कि displayName, विवरण, छिपा हुआ, आवश्यक, या पहलू सेटिंग्स)।

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की विशिष्ट ID
• columnId: अद्यतन करने के लिए स्तंभ की अनन्य ID

वैकल्पिक पैरामीटर

• displayName: उपयोगकर्ता का सामना करने वाला प्रदर्शन नाम
• विवरण: स्तंभ विवरण
• छिपा हुआ: यदि सत्य है, तो स्तंभ छिपा हुआ है
• आवश्यक: यदि सत्य है, तो एक मान आवश्यक है
• enforceUniqueValues: यदि सत्य है, तो मान अद्वितीय होना चाहिए
• अनुक्रमित: यदि सत्य है, तो मान अनुक्रमित होते हैं
• केवल: यदि सत्य है, तो मानों को बदला नहीं जा सकता
• पाठ, संख्या, पसंद, दिनांक समय, personOrGroup, लुकअप, हाइपरलिंकOrPicture: स्तंभ प्रकार सेटिंग्स अद्यतन करें

sharepoint_getSiteByPath

किसी SharePoint साइट को उसके होस्टनाम और सर्वर-संबंधित पथ का उपयोग करके हल करें.

आवश्यक पैरामीटर

• होस्टनाम: SharePoint टैनेंट का होस्ट नाम (उदाहरण के लिए, contoso.sharepoint.com)
• serverRelativePath: साइट के लिए सर्वर-सापेक्ष पथ (उदाहरण के लिए, साइट्स/मार्केटिंग)

sharepoint_listListColumns

किसी विशिष्ट SharePoint सूची के लिए स्तंभ परिभाषाएँ (columnDefinition संसाधन) सूचीबद्ध करें. siteId और listId की आवश्यकता है। $select, $top और $skiptoken जैसे OData पैरा का समर्थन करता है।

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की अनन्य ID

वैकल्पिक पैरामीटर

• चुनें: लौटाने के लिए गुणों की अल्पविराम से अलग सूची
• फ़िल्टर: परिणामों को प्रतिबंधित करने के लिए OData फ़िल्टर अभिव्यक्ति
• orderBy: द्वारा ऑर्डर करने के लिए गुणों की अल्पविराम से अलग सूची
• शीर्ष: पृष्ठ आकार (1-999)
• skiptoken: अगले सेट में पेजिंग के लिए अपारदर्शी टोकन

sharepoint_listListItems

किसी SharePoint सूची से आइटम्स सूचीबद्ध करें.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की अनन्य ID

वैकल्पिक पैरामीटर

• विस्तार करें: वैकल्पिक OData विस्तार (उदाहरण के लिए, फ़ील्ड्स)
• शीर्ष: वैकल्पिक पृष्ठ आकार
• फ़िल्टर: वैकल्पिक OData फ़िल्टर अभिव्यक्ति
• चुनें: वैकल्पिक OData चयन खंड

sharepoint_listLists

किसी साइट पर सभी SharePoint सूचियों को सूचीबद्ध करें.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी

sharepoint_listSubsites

किसी दी गई साइट के लिए चाइल्ड साइट्स (सबसाइट्स) की सूची बनाएं.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी

sharepoint_search

SharePoint को entityTypes=["site"] के साथ Microsoft ग्राफ़ खोज API का उपयोग करके खोजें.

आवश्यक पैरामीटर

• अनुरोध: searchRequest ऑब्जेक्ट्स की सरणी

वैकल्पिक पैरामीटर

• entityTypes: SharePoint साइट खोजों के लिए ["साइट"] होना आवश्यक है
• क्वेरी: क्वेरी ऑब्जेक्ट KQL-शैली खोज स्ट्रिंग के साथ
• से: पहले परिणाम का शून्य-आधारित ऑफसेट
• आकार: लौटने के लिए परिणामों की संख्या (1-50)
• फ़ील्ड्स: प्रतिसाद में चयन करने के लिए फ़ील्ड्स की वैकल्पिक सूची

13. sharepoint_searchSitesByName

SharePoint साइट्स को प्रदर्शन नाम या आंशिक URL (प्राकृतिक भाषा) द्वारा खोजें.

आवश्यक पैरामीटर

• खोज: खोज करने के लिए SharePoint साइट का नाम या आंशिक नाम/URL प्रदर्शित करें

वैकल्पिक पैरामीटर

• consistencyLevel: Microsoft ग्राफ़ द्वारा आवश्यक (डिफ़ॉल्ट: अंतिम)

14. sharepoint_updateListItem

किसी मौजूदा सूची आइटम के फ़ील्ड्स का अद्यतन करें.

आवश्यक पैरामीटर

• siteId: साइट की यूनीक आईडी
• listId: सूची की अनन्य ID
• itemId: सूची आइटम की अनन्य ID
• फ़ील्ड्स: अद्यतन करने के लिए फ़ील्ड मान (आंशिक)

वैकल्पिक पैरामीटर

• ifMatch: समवर्ती नियंत्रण के लिए वैकल्पिक ETag (उदाहरण के लिए, "*" बल के लिए)

मुख्य सुविधाएँ

सूची प्रबंधन

• टेम्पलेट्स के साथ नई SharePoint सूचियाँ बनाएँ
• किसी साइट पर सभी सूचियों को सूचीबद्ध करें
• विभिन्न सूची टेम्पलेट्स के लिए समर्थन (genericList, documentLibrary, issueTracking)

स्तंभ संचालन

• एकाधिक डेटा प्रकारों (पाठ, संख्या, विकल्प, दिनांक समय, personOrGroup, लुकअप, बूलियन, हाइपरलिंकOrPicture) के साथ स्तंभ बनाएँ
• मौजूदा स्तंभों को संपादित करें
• कॉलम हटाएं
• किसी सूची में सभी स्तंभों को सूचीबद्ध करना
• स्तंभ सत्यापन और विशिष्टता बाधाएँ

आइटम संचालन

• फ़ील्ड मानों के साथ सूची आइटम्स बनाएँ
• मौजूदा सूची आइटम्स (आंशिक अद्यतन) अद्यतन करें
• सूची आइटम हटाएं.
• फ़िल्टरिंग और पेजिनेशन के साथ आइटम सूचीबद्ध करें
• ETag के माध्यम से समवर्ती नियंत्रण

साइट खोज

• नाम या URL के आधार पर साइटें खोजें
• होस्टनाम और पथ द्वारा साइट्स को हल करें
• सबसाइट्स की सूची बनाएं
• Microsoft Graph Search API के साथ KQL-शैली खोज

OData क्वेरी समर्थन

• गुण चुनने के लिए $select का उपयोग करें।
• परिणामों को फ़िल्टर करने के लिए $filter का उपयोग करें।
• संबंधित निकायों को शामिल करने के लिए $expand का उपयोग करें.
• परिणामों को सॉर्ट करने के लिए $orderby का उपयोग करें।
• पेजिनेशन के लिए $top का प्रयोग करें।
• बड़े परिणाम सेट के माध्यम से $skiptoken से पृष्ठ का उपयोग करें।

स्तंभ प्रकार समर्थन

• पाठ स्तंभ (एकल-पंक्ति या बहु-पंक्ति, सादा या रिच पाठ)।
• संख्या स्तंभ (दशमलव स्थानों, न्यूनतम और अधिकतम मानों के साथ).
• पसंद स्तंभ (चेकबॉक्स, ड्रॉपडाउन या रेडियो बटन)।
• बूलियन कॉलम।
• दिनांक समय, दिनांक और समय, केवल दिनांक
• व्यक्ति या समूह स्तंभ (एकल या एकाधिक चयन).
• लुकअप कॉलम (अन्य सूचियों का संदर्भ दें).
• हाइपरलिंक या चित्र स्तंभ.

नोट

1. सभी कार्रवाई Microsoft ग्राफ़ API v1.0 का उपयोग करें।
2. स्तंभ नाम 1-64 वर्णों के होने चाहिए जिनमें कोई रिक्त स्थान नहीं होना चाहिए.
3. प्रत्येक स्तंभ को ठीक एक स्तंभ प्रकार निर्दिष्ट करना आवश्यक है.
4. समवर्ती नियंत्रण हेडर के माध्यम से If-Match उपलब्ध है।
5. साइट खोजों के लिए सेट करने की आवश्यकता होती consistencyLevel है eventual।
6. खोज परिणाम प्रति पृष्ठ 50 आइटम तक सीमित हैं।
7. आंशिक अद्यतन स्तंभों और सूची आइटम्स के लिए समर्थित हैं।