مرجع الفرق (معاينة)

ملحوظة

الميزات في هذا المقال مدعومة بالحزام القياسي، الذي يستخدم خيارات الفوترة الموضحة في الترخيص للوكلاء المدعومين بالحزام القياسي. تعلم كيفية الوصول إلى الميزات القياسية في وكلاء Access القياسيين وتدفقات الوكلاء.

Important

هذه ميزة إصدار أولي.

• Microsoft إصدارات ميزات المعاينة قبل إصدار رسمي بحيث يمكن للعملاء الوصول المبكر وتقديم الملاحظات.
• تحتوي ميزات المعاينة على وظائف مقيدة ولا يقصد بها استخدام الإنتاج.
• قد تُجري مايكروسوفت تغييرات على أسماء ومعلمات أدوات المعاينة MCP. تجنب التبعيات المشفرة. يحتفظ Microsoft بدعم السيناريو.
• تخضع ميزات المعاينة لشروط الاستخدام الإضافية Microsoft.

نظرة عامة

مُعرف خادم	عنوان URL على مستوى المستأجر	‏‫اسم العرض‬	Scope	الوصف
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	أدوات Microsoft Teams لإدارة المحادثات والقنوات والمستخدمين أو الرسائل داخلها. استخدم خادم 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

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

إخفاء الدردشة بشكل مؤقت. إرجاع 403 إذا كان الإذن مفقودا أو 404 إذا تم حذفه بالفعل. تحكم نهج استبقاء المستأجر هذه العملية.

المعلمات المطلوبة: معرف الدردشة

حذف رسالة الدردشة من المصفوفة في البيانات الرسومية

نقطة نهاية:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

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

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

mcp_graph_chat_getChat

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

يسترجع دردشة حسب المعرف. إرجاع بيانات التعريف مثل النوع والموضوع. إرجاع 404 إذا لم تكن الدردشة موجودة أو غير مرئية، أو 403 إذا تم رفض الأذونات.

المعلمات المطلوبة: معرف الدردشة

mcp_graph_chat_الحصول على رسالة الدردشة

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

استرداد رسالة دردشة حسب المعرف. إرجاع 404 إذا لم تكن الرسالة موجودة أو مخفية، أو 403 بدون حقوق مناسبة.

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

mcp_رسم_بياني_قائمة_أعضاء_الدردشة

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

يعرض قائمة المشاركين في الدردشة. يعيد الأدوار (عضو، مالك، أو ضيف). يتم إرجاع 403 إذا لم تكن هناك أذونات للقراءة أو 404 إذا لم يتم العثور على الدردشة.

المعلمات المطلوبة: معرف الدردشة

قائمة_رسائل_الدردشة_graph_mcp

نقطة نهاية: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_رسم_بياني_دردشة_إرسال_رسالة

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

نشر رسالة نص عادي جديدة في دردشة. يحتاج إلى معرف chat-id وbody.content غير فارغ؛ فقط الرسائل النصية مدعومة. قد تعود 429 لتحديد السرعة، أو 403 إذا كانت الأذونات مفقودة، أو 404 إذا كانت الدردشة غير موجودة. ليس idempotent—avoid إعادة المحاولة دون تمييز.

المعلمات المطلوبة: معرف الدردشة، المحتوى

تحديث_محادثة_المخطط_الرسومي_mcp

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

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

المعلمات المطلوبة: معرف الدردشة، الموضوع

تحديث_رسالة_المحادثة_تحليلي_mcp

نقطة نهاية: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.

المعلمات المطلوبة: معرف الفريق (team-id)، اسم العرض (displayName)

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

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 إذا كان الطرف المتصل يفتقر إلى صلاحيات القراءة أو خطأ 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 إذا كان المحتوى مفقودا.

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

الرد على رسالة القناة في mcp_graph_teams

نقطة نهاية: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_غراف

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

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

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

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

mcp_graph_teams_updateChannelMember

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

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

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

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

• إدارة الدردشة (إنشاء، قراءة، تحديث، حذف)
• عمليات الرسائل (إرسال واسترداد وتحرير وحذف)
• إدارة القناة (إنشاء وتكوين وقائمة)
• إدارة الأعضاء (إضافة وتحديث وقائمة)
• عمليات الفريق (استرجاع، عرض القائمة)

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

• عمليات الإنشاء والقراءة والتحديث والحذف (CRUD) الكاملة للدردشات والقنوات.
• دعم القنوات الخاصة والمشتركة والقياسية.
• ترابط الرسائل والردود.
• إدارة دور العضو.
• دعم استعلام OData للتصفية وفصل الصفحات.