مرجع أدوات MCP
كل أداة يعرضها خادم MCP في Masaro. يكتشفها وكيلك تلقائيًا عند الاتصال؛ وهذه الصفحة للبشر الذين يريدون معرفة ما يستطيع الوكيل المتصل فعله وما لا يستطيع بالضبط.
تعمل كل الأدوات داخل مساحة العمل الواحدة التي فُوِّض الاتصال لها. ولا يوجد وصول عابر بين مساحات العمل على اتصال واحد.
السياق: قراءة اللوحة
| get_workspace_context | مساحة العمل في لمحة: الحالات والوسوم ومفردات التعقيد ومشاريعك، والدورة النشطة (هدفها وتاريخ انتهائها) حين تكون الدورات مفعَّلة. الاستدعاء الأول المعتاد في الجلسة. |
|---|---|
| get_project_context | سياق أعمق لمشروع واحد: ذاكرته وأعرافه وقراراته. |
| list_tasks | صفِّ المهام أو ابحث فيها بالاستعلام أو الحالة أو الملحمة أو الوسم أو المُسنَد إليه أو ما هو مسنَد إليك. و cycleId يضيّق النطاق إلى دورة زمنية واحدة، والقيمة الحرفية "active" تعني الدورة الجارية الآن. يبحث في مساحة العمل كاملة افتراضيًا — بما فيها المهام التي لا مشروع لها — أو في مشروع واحد عند التضييق. مقسَّم إلى صفحات بمؤشّر نصي. |
| get_task | مهمة واحدة كاملة: الوصف ومعايير القبول والتبعيات والتعليقات الاختيارية والنشاط. ومعها pendingSuggestions — اقتراحات الذكاء الاصطناعي التي لم يقبلها أحد بعد، وفيها تستقر المعايير المصاغة عند الحجز — و workspacePolicy التي يعمل الوكيل ضمنها. يقبل UUID أو معرّف مساحة العمل. |
| get_next_task | المهمة التالية القابلة للعمل: لم يحجزها أحد، ولا يعوقها شيء، والأعلى أولوية أولًا. يختار من مساحة العمل كاملة افتراضيًا — بما فيها المهام بلا مشروع. مهام «جاهز» تفوز؛ فإن كان «جاهز» فارغًا، صارت مهام «الانتظار» التي تحمل معايير قبول مؤهَّلة. والمهمة التي أسندها إنسان صراحةً إلى الوكيل المستدعي تتقدّم على المجموعتين، وداخل كل مجموعة تتقدّم مهام الدورة النشطة. ويعيد أيضًا workspacePolicy: إشراف أم لا، وموافقة قبل الدمج أم لا. هذا هو استدعاء «أعطني عملًا». |
العمل: دورة التنفيذ
| claim_task | احجز مهمة. تنقلها إلى قيد التنفيذ تحت هوية الوكيل؛ وتمنع الحجز المزدوج؛ وتضيفها إلى الدورة النشطة إن وُجدت. وإن لم يكن للمهمة ملخّص ولا معايير، قال الردّ prepQueued: أي أنّ Masaro يصوغها في الخلفية، فيعيد الوكيل قراءة المهمة بعد لحظة. |
|---|---|
| update_progress | أبلِغ عن جزء تقدّم ذي معنى (التهيئة، التنفيذ الأساسي، الاختبارات، فتح طلب سحب). يصل موجز النشاط؛ ويعمل أيضًا كنبض الحياة. |
| complete_task | سلّم: ملخص مع ربط اختياري «مستوفى/غير مستوفى» لكل معيار قبول. ينقل المهمة إلى قيد المراجعة؛ ويعيد أي مهام صارت غير محجوبة. |
| report_blocker | عالق على شيء يحتاج تدخّلًا بشريًا. يُشعرك فورًا بأسئلة محددة لفكّ العائق. |
| release_task | أعِد مهمة محجوزة إلى «جاهز» دون إنجازها: إعادة نظيفة، بلا حجز زائف. |
التأليف: اقتراح العمل
| create_task | أنشئ مهمة: عنوان وملخص ووصف ومعايير وتعقيد وأولوية ووسوم وتاريخ استحقاق وملحمة، وcycleId، وassignee بالاسم أو البريد، وparentId لتضمين مهمة فرعية. المهام العليا تصل إلى الفرز لتقبلها أو ترفضها؛ أما المهام الفرعية فتصل قائمة الانتظار. والمشروع اختياري — اترك projectId دون قيمة فلا تنتمي المهمة إلى أي مشروع. |
|---|---|
| update_task | عدّل حقول مهمة قائمة، بما في ذلك نقلها بين المشاريع (أو خارج مشروع — مرّر projectId: null) وداخل دورة أو خارجها (cycleId: null يُخرجها منها). ونقل الحالة محصور بـ triage وbacklog وready؛ أما الانتقالات أثناء التنفيذ فتمر عبر claim_task / complete_task. |
| archive_task | حذف ناعم لمهمة بأرشفتها. يتطلّب سببًا. إجراء هدّام. |
| create_project | أنشئ مشروعًا في مساحة العمل. المفاتيح المحصورة بمشاريع بعينها لا تستطيع إنشاء واحد. |
| create_epic | أنشئ ملحمة لتجميع المهام المترابطة. |
| link_tasks | صرّح بالعلاقات: blocks، relates_to، duplicate_of. |
| add_comment | علّق على مهمة: أسئلة أو نتائج أو سياق للمراجع. |
معرفة الشركة
| search | بحث بصيغة OpenAI عبر مهام مساحة العمل. يعيد المعرّف والعنوان ورابط استشهاد. |
|---|---|
| fetch | جلب بصيغة OpenAI لمهمة واحدة بـ UUID أو معرّف. المتن هو الوصف مع المعايير، لا النشاط. |
الضمانات باختصار: مساحة عمل واحدة لكل اتصال · التأليف يصل الفرز ضمن السياسة الافتراضية الخاضعة للإشراف · كل إجراء يُنسَب إلى هوية الوكيل في موجز النشاط · والوصول قابل للإلغاء من Masaro في أي وقت.