مرجع خَادِم Microsoft Teams MCP

مهم

يجب أن تكون جزءًا من برنامج الإصدار الأولي Frontier للحصول على وصول مبكر إلى Microsoft Agent 365. يربطك Frontier مباشرةً بأحدث ابتكارات الذكاء الاصطناعي في Microsoft. تخضع الإصدارات الأولية في Frontier لشروط الإصدار الأولي الحالية لاتفاقيات العملاء. نظرًا لأن هذه الميزات لا تزال قيد التطوير، فقد يتغير توفرها وقدراتها بمرور الوقت.

نظرة عامة

مُعرف خَادِم	الاسم المعروض	النطاق	الوصف
mcp_TeamsServer	خَادِم MCP لتطبيق Microsoft Teams	McpServers.Teams.All	خَادِم Microsoft Teams Graph MCP لإدارة الدردشات والقنوات والمستخدمين أو الرسائل داخلها. استخدم خَادِم MCP هذا لعمليات Teams مثل إنشاء المحادثات ورسائل الدردشة وتحديثها واستردادها وإدارة الفرق والقنوات وتنفيذ المهام الإدارية المتعلقة بها.

أدوات الدردشة

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

إنشاء دردشة Teams جديدة باِسْتِخْدَام chatType (يتطلب oneOnOne مشاركين اثنين بالضبط، وتتطلب المجموعة أكثر من اثنين) والأعضاء. إرجاع 400 إذا كان oneOnOne يحتوي على عدد أعضاء خاطئ، 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

يقوم بحذف رسالة الدردشة مؤقتًا. إرجاع 403 بدون Chat.ReadWrite، 404 للمعرفات غير الصالحة، وقد يحتفظ بالرسالة للتوافق.

المعلمات المطلوبة: معرف المستخدم، معرف الدردشة، chatMessage-id

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

نشر رسالة نص عادي جديدة في دردشة. يحتاج إلى معرف الدردشة و body.content غير الفارغ؛ النص المعتمد فقط. قد ترجع 429 للتقييد، أو 403 إذا كانت الأذونات مفقودة، أو 404 إذا كانت الدردشة غير صالحة. غير متكرر - تجنب عمليات إعادة المحاولة العمياء.

المعلمات المطلوبة: chat-id, body

mcp_graph_chat_updateChat

نقطة نهاية: PATCH /v1.0/chats/{chat-id}

يحدث خصائص الدردشة، مثل موضوع الدردشات الجماعية فقط. يفشل مع 400 إذا تم اِسْتِخْدَامه في دردشة واحدة أو 403 بدون حقوق أو 404 إذا لم يتم العثور على الدردشة.

المعلمات المطلوبة: chat-id, topic

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 إذا كان يفتقر إلى الأذونات.

المعلمات المطلوبة: team-id، channel-id، displayName، الأدوار، ، user@odata.bind، @odata.type

mcp_graph_teams_createChannel

نقطة النهاية: POST /v1.0/teams/{team-id}/channels

إنشاء قناة في فريق مع displayName والوصف الاختياري و membershipType (قياسي، خاص، مشترك)، وأعضاء اختياريين. تتطلب القنوات الخاصة أو المشتركة أعضاء صريحين؛ تتسبب العضويات المكررة أو غير الصالحة في حدوث 400 أو 409.

المعلمات المطلوبة: team-id، displayName

المعلمات الاختيارية: الوصف، membershipType، الأعضاء

mcp_graph_teams_createPrivateChannel

نقطة النهاية: POST /v1.0/teams/{team-id}/channels

إنشاء قناة خاصة مع membershipType: خاص. يتطلب أعضاء عند الإنشاء، بما في ذلك مالك واحد على الأقل. إرجاع 400 إذا كان أعضاء مفقودين أو 409 أسماء مكررة أو 403 بدون أذونات.

المعلمات المطلوبة: team-id, displayName, members

mcp_graph_teams_getChannel

نقطة نهاية: GET /v1.0/teams/{team-id}/channels/{channel-id}

استرداد قناة باِسْتِخْدَام $select الاختيارية $filter. إرجاع 404 إذا لم يتم العثور على القناة أو إذا كان المتصل يفتقر إلى الوصول، أو 403 إذا كانت الأذونات غير كافية، أو 400 لعوامل التصفية غير المدعومة.

المعلمات المطلوبة: team-id, channel-id

المعلمات الاختيارية: $select، $filter

mcp_graph_teams_getTeam

نقطة نهاية: GET /v1.0/teams/{team-id}/channels

استرداد خصائص الفريق باِسْتِخْدَام $select و$expand الاختياريين. إرجاع 403 أو 404 إذا تعذر الوصول إلى الفريق.

المعلمات المطلوبة: معرف الفريق

المعلمات الاختيارية: $select، $filter

mcp_graph_teams_listChannelMembers

نقطة نهاية: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

يسرد جميع أعضاء قناة Microsoft Teams معينة، مع إرجاع بيانات التعريف حول كل عضو مثل الهوية والأدوار وحالة العضوية. مفيد لتدقيق مشاركة القناة أو التحقق من العضوية قبل تحديثات الأدوار أو ضمان التوافق.

المعلمات المطلوبة: team-id, channel-id

المعلمات الاختيارية: $top، $expand

mcp_graph_teams_listChannelMessages

نقطة نهاية: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

سرد الرسائل في قناة مع $top الاختيارية $expand (على سبيل المثال، الردود). تتم معالجة ترقيم الصفحات من خلال @odata.nextLink. إرجاع 403 بدون إذن قراءة أو 400 لخيارات الاستعلام غير الصالحة.

المعلمات المطلوبة: team-id, channel-id

المعلمات الاختيارية: $top، $expand

mcp_graph_teams_listChannels

Endpoint: GET /v1.0/teams/{team-id}/allChannels

يسرد القنوات في فريق مع $select اختياري أو $filter. إرجاع القنوات الخاصة والمشتركة فقط إذا كان المتصل عضوا. فشل مع 403 إذا كان المتصل يفتقر إلى حقوق القراءة أو 400 على استعلامات OData غير صالحة.

المعلمات المطلوبة: معرف الفريق

المعلمات الاختيارية: $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. إرجاع 403 بدون ChannelMessage.Send أو 404 إذا لم يتم العثور على القناة أو 400 إذا كان المحتوى مفقودا.

المعلمات المطلوبة: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

نقطة نهاية: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

الرد على رسالة في قناة تحتوي على body.content. يتم دعم النص العادي فقط. إرجاع 404 إذا لم يتم العثور على الرسالة الأصل، أو 403 بدون حقوق، أو 400 للمحتوى غير الصالح.

المعلمات المطلوبة: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

نقطة نهاية:PATCH /teams/{team-id}/channels/{channel-id}

تحديث قناة باسم displayName أو وصف جديد. قد تنطبق القيود على القنوات الخاصة مثل عام. إرجاع 403 بدون حقوق أو 409 على أسماء مكررة أو 400 لإدخال غير صالح.

المعلمات المطلوبة: team-id, channel-id

المعلمات الاختيارية: displayName، الوصف

mcp_graph_teams_updateChannelMember

نقطة نهاية: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

يحدث دور العضو في قناة خاصة أو مشتركة عن طريق تغيير الأدوار. ترث القنوات القياسية الأدوار من الفريق وعادة ما ترفض التحديثات. إرجاع 400 إذا تمت المحاولة على قنوات قياسية، أو 403 إذا لم يكن غير مصرح به، أو 404 إذا لم يتم العثور على عضو.

المعلمات المطلوبة: معرف الفريق، معرف القناة، معرف العضوية، الأدوار

العمليات المدعومة

1. إدارة الدردشة (إنشاء، قراءة، تحديث، حذف)
2. عمليات الرسائل (إرسال واسترداد وتحرير وحذف)
3. إدارة القناة (إنشاء وتكوين وقائمة)
4. إدارة الأعضاء (إضافة وتحديث وقائمة)
5. عمليات الفريق (استرداد، قائمة)

الميزات الأساسية

1. عمليات CRUD الكاملة للدردشات والقنوات
2. دعم القنوات الخاصة والمشتركة والقياسية
3. مؤشر ترابط الرسائل والردود
4. إدارة دور الأعضاء
5. دعم استعلام OData للتصفية وفصل الصفحات