خادم MCP (وكلاء الذكاء)
uMarker فيها خادم MCP (Model Context Protocol)، يعني وكيل البرمجة يقدر يسحب السياق اللي يحتاجه عشان يعيد إنتاج العلّة ويصلّحها: كلام المُبلِّغ زائد بيانات المتصفّح وتسميات التقرير والتذكرة المرتبطة فيه — وفي التقرير اللي انرسل بوضع الالتقاط التقني، سجلّ الكونسول وطلبات الشبكة والأخطاء وخطوات إعادة الإنتاج. وبعدين يعلّم التقرير محلولاً ويكتب تعليق أول ما ينزل الإصلاح.
الخادم غلاف رفيع فوق الـREST API: يشتغل على جهازك أنت، يتكلّم JSON-RPC عبر stdio، بلا أي تبعيات، ويحمل مفتاح الـAPI مع كل نداء. uMarker ما تتكلّم مع وكيلك. وكيلك هو اللي يتكلّم معها.
الإعداد
Section titled “الإعداد”-
اسكّ مفتاح API: اللوحة ← مفاتيح API. على مستوى الحساب، أو محصور بالمشروع الوحيد اللي تبغى الوكيل يشوفه. انسخ السرّ
md_live_…؛ يظهر مرّة وحدة. -
خذ ملف الخادم. هو ملف واحد،
umarker-mcp.mjs— تقريباً 6 كيلوبايت Node عادي، بلا أي تبعيات وبلا شي تنصّبه (يبغى Node 18 أو أحدث). ما هو منشور على npm ولا فيه زرّ تنزيل بهذا الموقع لين الآن: اطلبه من support@umarker.com، أو من اللوحة ← الدعم. احفظه وين ما تبغى؛ المثال تحت يفترض~/umarker-mcp.mjs. -
وجّه وكيلك له. مع Claude Code:
نافذة طرفيّة claude mcp add umarker \-e UMARKER_URL=https://api.umarker.com \-e UMARKER_API_KEY=md_live_your_key_here \-- node ~/umarker-mcp.mjsومع أي عميل MCP ثاني، عرّف خادم stdio بنفس الأمر ونفس متغيّرات البيئة.
| المتغيّر | القيمة |
|---|---|
UMARKER_URL |
https://api.umarker.com: أساس الـAPI. الخادم يضيف /api/v1 بنفسه. |
UMARKER_API_KEY |
مفتاح md_live_… من اللوحة ← مفاتيح API. |
الأدوات
Section titled “الأدوات”| الأداة | وش تسوّي |
|---|---|
list_projects |
المشاريع اللي يشوفها مفتاحك، وكذا يحلّ الوكيل معرّف المشروع |
list_reports |
تقارير مشروع، الأحدث أوّلاً (per_page افتراضي 25، وسقفه 100 — ولو طلبت أقل من 5 يرفعه لـ5) |
get_report |
السياق الكامل لتقرير واحد: الكونسول، الطلبات الفاشلة، بيانات المتصفّح، التسميات، التذكرة المرتبطة، وكتلة ماركداون جاهزة للّصق |
update_report_status |
ينقل التقرير لـnew أو in_progress أو waiting أو resolved أو archived |
add_comment |
يكتب ملاحظة على التقرير (ملخّص إصلاح، رابط PR)، لين 5000 محرف |
أداتا الكتابة تُطلقان نفس الأحداث اللي يطلقها المنتج، فما أحد يحتاج يراقب الـAPI عشان يعرف وش سوّى الوكيل. تغيير الحالة يُطلق status_change — أو resolved، وهو حدث مستقلّ بنفسه متى كانت الحالة الجديدة resolved — وكلاهما يوصل جرس الفريق وبريدهم وأي مسار توزيع مشترك فيه.
أمّا التعليق فيُطلق comment، وهذا يوصل الجرس والبريد بس، وما يوصل أي قناة أبداً: comment مو من الأحداث السبعة اللي يقدر المسار يشترك فيها. فلو كنت تبغى «نزل الإصلاح، تأكّد منه» اللي يكتبها وكيلك توصل سلاك، خلّه يحلّ التقرير مع التعليق. ونقل التقرير لـresolved هو كمان اللي يفتح للفريق خيارات إقفال الحلقة.
جلسة نموذجية
Section titled “جلسة نموذجية”أنت: صلّح أهم علّة في uMarker
الوكيل: ينادي
list_reports، يختار #42 «زرّ الدفع ما يسوّي شي»، يناديget_report، يشوفTypeError: cart is nullفي الكونسول وطلبPOST /api/cartفاشل (500)، يلقى المعالج، يصلّح مسار الـnull، يشغّل الاختبارات، وبعدها يناديupdate_report_status(42, "resolved")وadd_comment(42, "انحلّت في PR #128: السلّة كانت تُقرأ قبل التهيئة بالصفحات المخزّنة.")
بلا لصق stack traces، وبلا «ممكن ترسل لي لقطة للكونسول؟».
تفضّل النسخ واللصق؟
Section titled “تفضّل النسخ واللصق؟”كل صفحة تقرير فيها زرّ نسخ التقرير كنصّ يحطّ نفس كتلة السياق في الحافظة. الصقها بأي محادثة أو وكيل، سواء ركّبت MCP أو لا. الزرّ يحتاج صلاحية feedback.export، لأن إخراج تقرير من المنتج قرار مستقلّ بحدّ ذاته.
ملاحظات أمنية
Section titled “ملاحظات أمنية”- خادم MCP يشتغل على جهازك ويتكلّم مع uMarker بس، بمفتاحك أنت. ما فيه وسيط يمرّ عليه الكلام ولا طرف ثالث بالنص.
- المفاتيح تظهر مرّة، تُخزَّن كبصمة، تنسحب، ولها نطاق (حساب أو مشروع واحد). شوف مفاتيح الـAPI.
- اللي انخفى، انخفى على جهاز المُبلِّغ، مو عندنا. قيم باراميترات الرابط اللي أسماؤها توحي بسرّ تُفرَّغ على كل مشروع، فالرمز اللي في رابط طلب فاشل ما وصل uMarker أصلاً ومستحيل يوصل وكيلك. أمّا قيم الحقول اللي كتبها الزائر والمناطق اللي تعلّمها أنت بمُحدِّد CSS فتُخفى بنفس الطريقة — في متصفّح المُبلِّغ نفسه قبل ما تُرفع اللقطة — لكن بس على مشروع مشغِّل «إخفاء الحقول الحسّاسة تلقائياً»، والمشروع الجديد يجي وهو مطفأ. وإلى أن تشغّله، اللقطة، وفي التقرير التقني سطور الكونسول اللي معها، تحمل اللي كان على الصفحة، و
get_reportيسلّمها لوكيلك. شوف إخفاء البيانات الحسّاسة. - التقرير الأقدم من نافذة السجلّ في باقتك مخفيّ هنا كمان: الـAPI وخادم MCP يحترمون نفس النافذة اللي تحترمها اللوحة.