تسليم MCP

الاتصال

نقطة نهاية MCP واحدة، هي نفسها للجميع:

https://masaro.ai/mcp

لا حاجة للبحث عن معرّف مساحة العمل. أنت تختار مساحة العمل التي يتصل بها الوكيل في شاشة الموافقة (أدناه)، تمامًا كما تختار مساحة عمل عند تثبيت تطبيق Slack أو GitHub.

claude mcp add --transport http masaro https://masaro.ai/mcp

مطالبات للبدء

بعد الاتصال، جرّب واحدة من هذه. كل سطر منها يمكنك لصقه كما هو في الوكيل:

List my ready tasks
What's blocked?
File this conversation as tasks

المصادقة: OAuth، لا مفاتيح ملصقة

في أول مرة يلمس فيها وكيلك نقطة النهاية، يتحدّاه الخادم فيفتح عميل MCP لديك متصفحًا:

1. 1

   سجّل الدخول إلى Masaro

   برابط سحري أو عبر Google، كالمعتاد. (وإن كنت مسجّلًا بالفعل، اختفت هذه الخطوة.)
2. 2

   اختر مساحة عمل وراجع

   تعرض شاشة الموافقة ما سيستطيع الوكيل فعله وتتيح لك اختيار مساحة العمل التي ينضم إليها (إن كنت تنتمي إلى أكثر من واحدة). تعمل وحدك؟ فلا شيء لتختاره.
3. 3

   وافق

   يُكمل العميل عملية OAuth ويعيد الاتصال. انتهى؛ ولن ترى هذا مجددًا لذلك العميل.

ما يمنحك ذلك: لا أسرار طويلة العمر قابعة في ملفات الإعداد، ووصول محصور بمساحة عمل واحدة لكل اتصال، وإلغاء من Masaro متى شئت: يموت وصول الوكيل دون المساس بإعداداته. ولا يعمل الوكلاء أبدًا إلا داخل مساحات عمل أنت عضو فيها.

دورة العمل

بمجرد الاتصال، يعمل الوكيل على لوحتك عبر دورة منضبطة. وكل خطوة مرئية على اللوحة لحظيًا.

1. 1

   التوجّه.

   يستدعي الوكيل get_workspace_context (شكل لوحتك: الحالات والوسوم والمشاريع) وget_project_context (ذاكرة المشروع وأعرافه وقراراته) ليبدأ وقد أُطلِع، لا فارغًا.
2. 2

   التقاط العمل.

   يعيد get_next_task المهمة التالية القابلة للعمل فعلًا: غير مُستلَمة، وعوائقها زالت، والأعلى أولوية أولًا. وتُختار مهام «جاهز» قبل أي شيء آخر؛ فإذا نضب «جاهز» جاز للوكيل الرجوع إلى مهام «الانتظار» التي تحمل معايير قبول بالفعل. وإن أسندت مهمة إلى هذا الوكيل، فازت تلك مباشرة. (أو توجّهه إلى مهمة بعينها: list_tasks / get_task.)
3. 3

   الاستلام.

   يضع claim_task المهمة في «قيد التنفيذ» تحت هوية ذلك الوكيل. فيرى الجميع، إنسانًا كان أو وكيلًا، أنها مأخوذة. ولا يكرّر وكيلان العمل بصمت.
4. 4

   العمل والإبلاغ.

   بعد كل جزء ذي معنى (اكتمال الهيكلة، عمل المسار الأساسي، نجاح الاختبارات، فتح طلب سحب)، يستدعي الوكيل update_progress. وتصل هذه إلى موجز نشاط المهمة لحظة حدوثها. وهي تعمل أيضًا كنبض قلب (انظر أدناه).
5. 5

   الإنهاء، أو عدمه، بصدق.

   • complete_task: يقدّم الوكيل ملخصًا ويربط كل معيار قبول بمستوفى / غير مستوفى، ثم تنتقل المهمة إلى «قيد المراجعة» لتقييمك. وتخبر الاستجابة الوكيلَ أي المهام صارت غير محجوبة للتو.
   • report_blocker: عالق على شيء يحتاج إنسانًا. بيان اعتماد مفقود، أو متطلب غامض، أو قرار فوق صلاحياته. تُشعَر فورًا، بأسئلة محددة لا بهزّة كتفين أمام أثر استدعاء.
   • release_task: يعيد الوكيل المهمة بنظافة (الوكيل غير المناسب للعمل، أو انتهاء الجلسة). فتعود إلى «جاهز» ليستلمها أي أحد آخر.

ملاحظة نطاق واحدة: يبحث list_tasks وget_next_task في مساحة العمل كاملة افتراضيًا، بما فيها المهام التي لا تنتمي إلى أي مشروع. فالمشاريع طريقة اختيارية لتجميع العمل، لا جدار حوله. والوكيل الذي يريد لوحة بعينها يمرّر projectId (يكتشفه عبر get_workspace_context) لتضييق البحث.

الحياة: لا مطالبات زائفة

تقارير التقدّم نبض قلب أيضًا. فإن حجز وكيل مهمة ثم صمت (جلسة انهارت، حاسوب أُغلق)، يتقادم الحجز وتعود المهمة إلى اللوحة بدل أن تظل مقفلة خلف عملية ميتة. ويتناسب زمن ذلك مع تعقيد المهمة: مهمة trivial لا ينبغي أن تصمت طويلًا؛ ومهمة xl تنال مساحة أكبر. والنوافذ الدقيقة في حل المشكلات.

يستطيع الوكلاء التأليف، ضمن حدود

الوكلاء ليسوا للقراءة فقط. فأثناء مهمة، يستطيع وكيل اكتشف عملًا تابعًا استدعاء create_task وcreate_epic وlink_tasks (التبعيات) وupdate_task وadd_comment. لكن المهام التي ينشئها الوكيل تصل إلى الفرز، لا إلى قائمة انتظارك: فتقبل كل واحدة أو ترفضها ضمن السياسة الافتراضية الخاضعة للإشراف. الوكلاء يقترحون، وأنت تتحكم بما يدخل الخطة. ومدى هذا المقود إعداد صريح لكل مساحة عمل ولكل وكيل: استقلالية الوكيل.

عمليًا

مع اتصال Claude Code، هذا تسليم كامل:

> Get the next task from Masaro and work it. Report progress as you go.

يتوجّه الوكيل، ويحجز، ويبني مقابل المعايير، وينبض، ثم يعيد. وتراجع أنت على اللوحة، والمراجعة قائمة تحقّق لا حفريات أثرية.

التالي: مرجع الأدوات · التسليم إلى Claude Code · التسليم إلى Cursor