مرجع أدوات MCP
يوفِّر AB Projects أدوات MCP تتيح لمساعدي الذكاء الاصطناعي (مثل Claude) العمل مع مشاريعك ومهامك ومستنداتك. عندما يغيِّر مساعد شيئًا عبر هذه الأدوات، فإنه يمر بالمسار نفسه للتطبيق: مدخل في سجل التغييرات بالملاحظة التي تقدِّمها، ومدخل في سجل التدقيق، وبطاقة Adaptive Cards (البطاقات التكيُّفية) تُنشر في قناة Microsoft Teams المرتبطة — مع الإفصاح بوضوح عن نشاط الذكاء الاصطناعي. أدوات القراءة فقط تعيد البيانات ولا تغيِّر شيئًا.
أدوات المشاريع
| الأداة | الوصف | المعاملات |
|---|---|---|
ab_get_my_projects |
يسرد جميع المشاريع التي أنت عضو فيها، بما في ذلك إحصاءات مثل أعداد المهام ومعدلات الإنجاز. | لا شيء |
ab_get_project_members |
يسرد جميع أعضاء مشروع مع أدوارهم ومعرّفات العضوية. استخدم هذا للحصول على معرّف العضوية اللازم لتكليف مهمة. | project_id مطلوب |
ab_get_project_options |
يحصل على معرّفات الحالة والنوع والبيئة الصالحة لمشروع. استدعِ هذا أولًا قبل تمرير حالة أو نوع أو بيئة إلى ab_create_task أو ab_update_task. |
project_id مطلوب |
أدوات المهام
| الأداة | الوصف | المعاملات |
|---|---|---|
ab_get_my_tasks |
يحصل على مهامك النشطة — المتأخرة، والمستحقة اليوم، وقيد التنفيذ. يعيد معرّف المهمة والعنوان والأولوية والحالة وتاريخ الاستحقاق والتقدُّم. | project_id اختياري — التصفية إلى مشروع محدَّد |
ab_search_tasks |
يبحث في المهام بكلمة مفتاحية عبر جميع مشاريعك. | query مطلوب — كلمة البحث المفتاحية project_id اختياري — تحديد النطاق إلى مشروع محدَّد |
ab_get_task |
يحصل على التفاصيل الكاملة لمهمة — الوصف، التواريخ، المكلَّف، الساعات المقدَّرة/الفعلية، معلومات المهام الفرعية، معرّف المهمة الأصل، فرع GitHub، وأحدث 50 تعليقًا مضمَّنة. تُعاد الحالة والنوع والبيئة كأسماء مقروءة. | project_id مطلوب task_id مطلوب |
ab_create_task |
ينشئ مهمة جديدة. يُسجَّل مدخل في سجل التغييرات ويُنشر إشعار في قناة Teams المرتبطة. | project_id مطلوب title مطلوب description اختياري — يدعم Markdown priority اختياري — 1 = عالية، 2 = متوسطة، 3 = منخفضة (الافتراضي: 2) assignee_id اختياري — معرّف عضوية المكلَّف due_date اختياري — yyyy-MM-dd status / type / environment اختياري — معرّفات من ab_get_project_optionsparent_task_id اختياري — مفتاح صف الأصل؛ عند تعيينه تصبح هذه مهمة فرعية ويُحدَّث علم «لديها مهام فرعية» للأصل تلقائيًا note اختياري — السبب، يظهر في سجل التغييرات وقناة Teams |
ab_update_task |
يحدِّث خصائص مهمة — العنوان، الوصف، الحالة، التقدُّم، الأولوية، المكلَّف، النوع، البيئة، أو الأصل. يُسجَّل كل تغيير في السجل بالملاحظة المقدَّمة. | project_id مطلوب task_id مطلوب title / description اختياري (Markdown) status اختياري — معرّف الحالة الجديدة progress اختياري — من 0 إلى 100 priority اختياري — 1/2/3 assignee_id / type / environment اختياري parent_task_id اختياري — النقل تحت أصل مختلف؛ سلسلة فارغة للفصل note اختياري — السبب، يظهر في سجل التغييرات وقناة Teams |
ab_complete_task |
يضع علامة اكتمال على مهمة. يضبط التقدُّم على 100% ويسجِّل مدخل إنجاز في سجل التغييرات. | project_id مطلوب task_id مطلوب note اختياري — ملاحظة الإنجاز، تظهر في سجل التغييرات وقناة Teams |
ab_add_comment |
يضيف تعليقًا إلى مهمة. يظهر التعليق في محادثة المهمة ويُضمَّن عبر ab_get_task، فيمكن لاستدعاء لاحق قراءته دون استدعاء أداة ثانٍ. |
project_id مطلوب task_id مطلوب content مطلوب — نص التعليق |
أدوات الجدول
| الأداة | الوصف | المعاملات |
|---|---|---|
ab_get_schedule |
يحصل على جدولك للأسبوع الحالي — مجمَّعًا إلى متأخر، ومستحق اليوم، ومستحق هذا الأسبوع. | project_id اختياري — التصفية إلى مشروع محدَّد |
أدوات المستندات (Wiki)
| الأداة | الوصف | المعاملات |
|---|---|---|
ab_get_wiki_tree |
يحصل على شجرة تنقل المستندات (المجلدات والصفحات) لمشروع. | project_id مطلوب |
ab_get_wiki_article |
يقرأ المحتوى الكامل للمستند وبياناته الوصفية ومعلومات الإصدار. | project_id مطلوب article_id مطلوب — من ab_get_wiki_tree أو ab_search_wiki |
ab_search_wiki |
يسرد المستندات تحت مسار مجلد محدَّد. | project_id مطلوب parent_path اختياري — المجلد للسرد منه (الافتراضي: / للجذر) |
ab_create_wiki_article |
ينشئ مستندًا جديدًا بصيغة Markdown. ينشر إشعارًا في قناة Teams المرتبطة. | project_id مطلوب title مطلوب content مطلوب — Markdown parent_path اختياري — المجلد، مثل / أو /Engineering (الافتراضي: /)tags اختياري — مفصولة بفواصل |
ab_update_wiki_article |
يحدِّث مستندًا موجودًا. ينشئ إصدارًا جديدًا بملاحظة تحرير وينشر إشعارًا في قناة Teams. | project_id مطلوب article_id مطلوب content مطلوب — Markdown محدَّث edit_note مطلوب — ما الذي تغيَّر؛ يظهر في سجل الإصدارات tags اختياري — وسوم محدَّثة مفصولة بفواصل |
ab_add_wiki_comment |
يضيف تعليقًا إلى مستند. | project_id مطلوب article_id مطلوب content مطلوب — نص التعليق |
كيف تبقى تغييرات الذكاء الاصطناعي مرئية
عند إنشاء مهمة أو مستند أو تحديثه أو إكماله عبر أداة MCP، يقوم AB Projects تلقائيًا بما يلي:
- يسجِّل التغيير في سجل تغييرات العنصر باسم المستخدم والملاحظة المقدَّمة
- يكتب مدخلًا في سجل العمليات لأغراض التدقيق
- ينشر أو يحدِّث بطاقة Adaptive Cards في قناة Microsoft Teams المرتبطة بالمشروع، مع الإفصاح بوضوح عن النشاط كمُولَّد بالذكاء الاصطناعي
لذا تحمل التغييرات المدفوعة بالذكاء الاصطناعي القدر نفسه من الوضوح وإمكانية التتبُّع كالتغييرات التي تُجرى مباشرةً في تطبيق AB Projects أو علامة تبويب Teams. لمعرفة كيفية توصيل مساعد، راجع توصيل مساعدي الذكاء الاصطناعي عبر MCP.