Teams संदर्भ (पूर्वावलोकन)

नोट

यह आलेख मानक हार्नेस द्वारा संचालित एजेंटों या एजेंट प्रवाह में उपयोग की जाने वाली सुविधाओं का वर्णन करता है।

महत्वपूर्ण

यह एक पूर्वावलोकन सुविधा है.

• Microsoft आधिकारिक रिलीज़ से पहले पूर्वावलोकन सुविधाएँ रिलीज़ करता है ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.
• पूर्वावलोकन सुविधाओं ने कार्यक्षमता को प्रतिबंधित कर दिया है और उत्पादन उपयोग के लिए नहीं हैं।
• Microsoft पूर्वावलोकन MCP उपकरण नाम और पैरामीटर परिवर्तित कर सकता है. हार्ड-कोडेड निर्भरताओं से बचें। Microsoft परिदृश्य समर्थन बनाए रखता है।
• पूर्वावलोकन सुविधाएँ Microsoft उपयोग की पूरक शर्तें के अधीन हैं।

नोट

एप्लिकेशन-विशिष्ट Microsoft 365 MCP उपकरण (Copilot, कैलेंडर, मेल, SharePoint, OneDrive, Teams, User, और Word) केवल पश्चगामी संगतता उद्देश्यों के लिए हैं और इनका उपयोग उत्पादन परिवेश या नए प्रोजेक्ट में नहीं किया जाना चाहिए। जिन नए प्रोजेक्ट्स के लिए Microsoft 365 संसाधनों तक पहुंच की आवश्यकता होती है, उनके लिए GitHub Copilot हार्नेस के साथ Work IQ MCP का उपयोग करें। अधिक जानकारी के लिए, Copilot Studio में Work IQ MCP देखें।

अवलोकन

सर्वर आईडी	टेनेंट स्तर का यूआरएल	प्रदर्शित होने वाला नाम	Scope	विवरण
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	चैट, चैनलों और उनमें मौजूद उपयोगकर्ताओं या संदेशों के प्रबंधन के लिए Microsoft Teams उपकरण टीम संचालन के लिए इस MCP सर्वर का उपयोग करें जैसे चैट और चैट संदेश बनाना, अपडेट करना और पुनर्प्राप्त करना, टीमों और चैनलों को प्रबंधित करना और इन कार्यों से संबंधित प्रशासनिक कार्य करना।

चैट टूल

mcp_graph_chat_addChatMember

समापन बिंदु:POST /v1.0/chats/{chat-id}/members

user@odata.bind, @odata.type और वैकल्पिक भूमिकाओं (सदस्य, स्वामी) का उपयोग करके चैट में एक सदस्य जोड़ता है। यदि सदस्य पहले से मौजूद है, तो 409 त्रुटि कोड, अमान्य उपयोगकर्ता संदर्भों के लिए 400 त्रुटि कोड, या नीतियाँ जोड़ने को प्रतिबंधित करने के लिए 403 त्रुटि कोड देता है।

आवश्यक पैरामीटर: चैट-आईडी, @odata.type, user@odata.bindभूमिकाएं

mcp_graph_chat_createChat

समापन बिंदु:POST /v1.0/chats

(oneOnOne में ठीक दो प्रतिभागी आवश्यक हैं, समूह में दो से अधिक प्रतिभागी आवश्यक हैं) chatType और सदस्यों के साथ एक नई Teams चैट बनाता है। यदि oneOnOne में सदस्यों की संख्या गलत है, तो 400 लौटाता है; यदि उन्हीं प्रतिभागियों के बीच पहले से ही चैट मौजूद है, तो 409; या यदि कॉलर के पास आवश्यक अधिकार नहीं हैं, तो 403 लौटाता है।

आवश्यक पैरामीटर:chatType, सदस्य

mcp_graph_chat_deleteChat

समापन बिंदु:DELETE /v1.0/chats/{chat-id}

किसी चैट को सॉफ़्ट-डिलीट करता है। यदि अनुमति अनुपलब्ध है तो 403 लौटाता है या यदि पहले से ही हटा दिया गया है तो 404 लौटाता है। टेनेंट प्रतिधारण नीतियाँ इस कार्रवाई को नियंत्रित करती हैं।

आवश्यक पैरामीटर: चैट-आईडी

mcp_graph_chat_deleteChatMessage

समापन बिंदु:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

चैट संदेश को सॉफ्ट-डिलीट करता है। Chat.ReadWrite के बिना 403 लौटाता है, अमान्य आईडी के लिए 404 लौटाता है, और अनुपालन के लिए संदेश को फिर भी बनाए रख सकता है।

आवश्यक पैरामीटर: यूजर-आईडी, चैट-आईडी, चैटमैसेज-आईडी

mcp_graph_chat_getChat

समापन बिंदु:GET /v1.0/chats/{chat-id}

आईडी द्वारा चैट पुनर्प्राप्त करता है। प्रकार और विषय जैसे मेटाडेटा लौटाता है। अगर चैट मौजूद नहीं है या दिखाई नहीं दे रही है, तो 404 लौटाता है और अगर अनुमतियां नहीं दी जाती हैं, तो 403 लौटाता है.

आवश्यक पैरामीटर: चैट-आईडी

mcp_graph_chat_getChatMessage

समापन बिंदु:GET /v1.0/chats/{chat-id}/messages/{message-id}

आईडी द्वारा चैट संदेश पुनर्प्राप्त करता है। यदि संदेश मौजूद नहीं है या छुपा हुआ है, तो 404 लौटाता है, या उचित अधिकारों के बिना 403 देता है।

आवश्यक पैरामीटर: चैट-आईडी, संदेश-आईडी

mcp_graph_chat_listChatMembers

समापन बिंदु:GET /v1.0/chats/{chat-id}/members

चैट प्रतिभागियों की सूची बनाता है. भूमिकाएँ (सदस्य, मालिक या अतिथि) लौटाता है. पढ़ने की अनुमतियों के बिना 403 लौटाता है या चैट नहीं मिलने पर 404 लौटाता है।

आवश्यक पैरामीटर: चैट-आईडी

mcp_graph_chat_listChatMessages

समापन बिंदु:GET /v1.0/chats/{chat-id}/messages

चैट में संदेशों को वैकल्पिक $top, $filter, और $orderby के साथ सूचीबद्ध करता है। पृष्ठांकित परिणाम लौटाता है. अनुपालन सामग्री को छिपा सकता है। त्रुटियों में खराब प्रश्नों के लिए 400 और थ्रॉटलिंग के लिए 429 शामिल हैं।

आवश्यक पैरामीटर: चैट-आईडी

वैकल्पिक पैरामीटर:$top, $filter, $orderby

mcp_graph_chat_listChats

समापन बिंदु:GET /v1.0/chats

कॉल करने वाले के लिए वैकल्पिक $top, $filter, $expand, और $orderby के साथ चैट्स सूचीबद्ध करता है। केवल दृश्यमान चैट लौटाता है; छिपी हुई या सिस्टम चैट को बाहर रखा जा सकता है। अमान्य सॉर्ट एक्सप्रेशन के लिए 400 लौटाता है।

वैकल्पिक पैरामीटर:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

समापन बिंदु:POST /v1.0/chats/{chat-id}/messages

चैट में एक नया सादा-पाठ संदेश पोस्ट करता है. चैट-आईडी और nonempty body.content की जरूरत है; केवल पाठ समर्थित है। थ्रॉटलिंग के लिए 429, यदि अनुमतियाँ अनुपलब्ध हैं तो 403 या चैट अमान्य होने पर 404 लौटा सकता है। नहीं idempotent—avoid अंधाधुंध पुनर्प्रयास।

आवश्यक पैरामीटर: चैट-आईडी, बॉडी

mcp_graph_chat_updateChat

समापन बिंदु:PATCH /v1.0/chats/{chat-id}

चैट प्रॉपर्टी को अपडेट करता है, जैसे कि केवल ग्रुप चैट के लिए विषय. एक-पर-एक चैट पर उपयोग किए जाने पर 400, अधिकारों के बिना 403 या चैट नहीं मिलने पर 404 के साथ विफल हो जाता है।

आवश्यक पैरामीटर: चैट-आईडी, विषय

mcp_graph_chat_updateChatMessage

समापन बिंदु:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

नई सादा-पाठ सामग्री के साथ चैट संदेश का अद्यतन करता है. कुछ सिस्टम या अनुपालन संदेश संपादन को अवरुद्ध करते हैं। यदि संपादन की अनुमति नहीं है, तो कार्रवाई 403 या 400 या विरोधों के लिए 409 लौटाती है.

आवश्यक पैरामीटर: चैट-आईडी, संदेश-आईडी

चैनल और टीम उपकरण

mcp_graph_teams_addChannelMember

समापन बिंदु:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

user@odata.bind, @odata.type और वैकल्पिक भूमिकाओं (स्वामी या रिक्त) का उपयोग करके किसी निजी या साझा चैनल में एक सदस्य जोड़ता है. मानक चैनलों पर विफल रहता है। यदि सदस्य पहले से मौजूद है, तो 409 देता है, और यदि अनुमतियों की कमी है तो 403 लौटाता है।

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी, displayName, भूमिकाएं, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

समापन बिंदु:POST /v1.0/teams/{team-id}/channels

displayName, वैकल्पिक विवरण, membershipType (मानक, निजी, साझा) और वैकल्पिक सदस्यों के साथ टीम में एक चैनल बनाता है. निजी या साझा चैनलों के लिए स्पष्ट सदस्यों की आवश्यकता होती है। डुप्लिकेट या अमान्य सदस्यता 400 या 409 का कारण बनती है।

आवश्यक पैरामीटर: टीम-आईडी, डिस्प्लेनाम

वैकल्पिक पैरामीटर: विवरण, सदस्यताप्रकार, सदस्य

mcp_graph_teams_createPrivateChannel

समापन बिंदु:POST /v1.0/teams/{team-id}/channels

membershipType को private पर सेट करके एक निजी चैनल बनाता है। चैनल बनाते समय आपको सदस्यों को शामिल करना होगा और सदस्यों की सूची में कम से कम एक स्वामी होना चाहिए. यदि सदस्य अनुपलब्ध हैं, तो 400, डुप्लिकेट नामों के लिए 409 या यदि कॉल करने वाले के पास अनुमतियाँ नहीं हैं, तो 403 लौटाता है.

आवश्यक पैरामीटर: टीम-आईडी, डिस्प्लेनाम, सदस्य

mcp_graph_teams_getChannel

समापन बिंदु:GET /v1.0/teams/{team-id}/channels/{channel-id}

वैकल्पिक $select और $filter के साथ एक चैनल पुनर्प्राप्त करता है। यदि चैनल नहीं मिलता है या कॉल करने वाले के पास पहुँच नहीं है, तो 404 लौटाता है; यदि अनुमतियाँ अपर्याप्त हैं, तो 403; और असमर्थित फ़िल्टर के लिए 400 लौटाता है।

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी

वैकल्पिक पैरामीटर:,$select$filter

mcp_graph_teams_getTeam

समापन बिंदु:GET /v1.0/teams/{team-id}

वैकल्पिक $select और $expand के साथ टीम गुणों को पुनर्प्राप्त करता है। यदि टीम पहुंच योग्य नहीं है, तो 403 या 404 लौटाता है।

आवश्यक पैरामीटर: टीम-आईडी

वैकल्पिक पैरामीटर:,$select$expand

mcp_graph_teams_listChannelMembers

समापन बिंदु:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

किसी विशिष्ट Microsoft Teams चैनल के सभी सदस्यों को सूचीबद्ध करता है. प्रत्येक सदस्य के बारे में मेटाडेटा लौटाता है, जैसे पहचान, भूमिकाएँ और सदस्यता स्थिति. यह जानकारी चैनल भागीदारी का ऑडिट करने, भूमिका अपडेट से पहले सदस्यता की पुष्टि करने या अनुपालन सुनिश्चित करने के लिए उपयोगी है।

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी

वैकल्पिक पैरामीटर:,$top$expand

mcp_graph_teams_listChannelMessages

समापन बिंदु:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

किसी चैनल में संदेशों को सूचीबद्ध करता है. परिणामों को अनुकूलित करने के लिए वैकल्पिक $top और $expand मापदंडों का उपयोग करें। उदाहरण के लिए, उत्तर शामिल करने के लिए उपयोग करें $expand . पेजिनेशन के माध्यम से @odata.nextLinkनियंत्रित किया जाता है। पढ़ने की अनुमति के बिना 403 या अमान्य क्वेरी विकल्पों के लिए 400 लौटाता है.

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी

वैकल्पिक पैरामीटर:,$top$expand

mcp_graph_teams_listChannels

समापन बिंदु:GET /v1.0/teams/{team-id}/allChannels

किसी टीम में चैनलों की सूची बनाता है. परिणामों को अनुकूलित करने के लिए वैकल्पिक $select या $filter पैरामीटर का उपयोग करें। निजी और साझा किए गए चैनल केवल तभी लौटाता है जब कॉल करने वाला सदस्य हो। यदि कॉलर के पास पठन-अधिकार नहीं हैं, तो यह 403 के साथ विफल होता है, या अमान्य OData क्वेरीज़ होने पर 400 के साथ विफल होता है।

आवश्यक पैरामीटर: टीम-आईडी

वैकल्पिक पैरामीटर:,$select$filter

mcp_graph_teams_listTeams

समापन बिंदु:GET /v1.0/users/{user-id}/joinedTeams

किसी विशिष्ट उपयोगकर्ता की शामिल हुई टीमों को सूचीबद्ध करता है। केवल उस उपयोगकर्ता की सदस्यता लौटाता है, सभी टैनेंट टीमों की नहीं। यदि कॉल करने वाला उपयोगकर्ता से क्वेरी नहीं कर सकता है तो 403 या यदि आईडी अमान्य है तो 404 लौटाता है।

आवश्यक पैरामीटर: उपयोगकर्ता-आईडी

mcp_graph_teams_postChannelMessage

समापन बिंदु:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

किसी चैनल पर सादा-पाठ संदेश पोस्ट करता है. टीम-आईडी, चैनल-आईडी और body.content की आवश्यकता है। ChannelMessage.Send के बिना 403 लौटाता है, चैनल न मिलने पर 404, या सामग्री अनुपस्थित होने पर 400।

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी, बॉडी

mcp_graph_teams_replyToChannelMessage

समापन बिंदु:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

body.content का उपयोग करके किसी चैनल में किसी संदेश का उत्तर देता है। केवल सादा पाठ समर्थित है। यदि पैरेंट संदेश नहीं मिलता है, तो 404, अधिकारों के बिना 403 या अमान्य सामग्री के लिए 400 लौटाता है.

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी, मैसेज-आईडी, बॉडी

mcp_graph_teams_updateChannel

समापन बिंदु:PATCH /teams/{team-id}/channels/{channel-id}

किसी चैनल को नए displayName या विवरण के साथ अपडेट करता है. प्रतिबंध जनरल जैसे विशेष चैनलों पर लागू हो सकते हैं। अधिकार न होने पर 403, डुप्लिकेट नाम होने पर 409, या अमान्य इनपुट के लिए 400 लौटाता है।

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी

वैकल्पिक पैरामीटर: displayName, विवरण

mcp_graph_teams_updateChannelMember

समापन बिंदु:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

भूमिकाएँ बदलकर किसी निजी या साझा चैनल में सदस्य की भूमिका को अपडेट करता है. मानक चैनल टीम से भूमिकाएँ विरासत में प्राप्त करते हैं और आमतौर पर अपडेट को अस्वीकार करते हैं। मानक चैनलों पर प्रयास किए जाने पर 400, अनधिकृत होने पर 403 या सदस्य नहीं मिलने पर 404 लौटाता है.

आवश्यक पैरामीटर: टीम-आईडी, चैनल-आईडी, सदस्यता-आईडी, भूमिकाएं

समर्थित संचालन

• चैट प्रबंधन (बनाएं, पढ़ें, अपडेट करें, हटाएं)
• संदेश संचालन (भेजें, पुनर्प्राप्त करें, संपादित करें, हटाएं)
• चैनल प्रबंधन (बनाएं, कॉन्फ़िगर करें, सूची बनाएं)
• सदस्य प्रबंधन (जोड़ें, अद्यतन, सूची)
• टीम कार्रवाइयाँ (पुनर्प्राप्त करना, सूचीबद्ध करना)

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

• चैट और चैनलों के लिए पूर्ण निर्माण, पठन, अद्यतन और विलोपन (CRUD) संचालन।
• निजी, साझा और मानक चैनलों के लिए समर्थन।
• संदेश शृंखला और जवाब।
• सदस्य भूमिका प्रबंधन।
• फ़िल्टरिंग और पेजिनेशन के लिए OData क्वेरी समर्थन।