تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

خادم MCP (وكلاء الذكاء)

uMarker فيها خادم MCP (Model Context Protocol)، يعني وكيل البرمجة يقدر يسحب السياق اللي يحتاجه عشان يعيد إنتاج العلّة ويصلّحها: كلام المُبلِّغ زائد بيانات المتصفّح وتسميات التقرير والتذكرة المرتبطة فيه — وفي التقرير اللي انرسل بوضع الالتقاط التقني، سجلّ الكونسول وطلبات الشبكة والأخطاء وخطوات إعادة الإنتاج. وبعدين يعلّم التقرير محلولاً ويكتب تعليق أول ما ينزل الإصلاح.

الخادم غلاف رفيع فوق الـREST API: يشتغل على جهازك أنت، يتكلّم JSON-RPC عبر stdio، بلا أي تبعيات، ويحمل مفتاح الـAPI مع كل نداء. uMarker ما تتكلّم مع وكيلك. وكيلك هو اللي يتكلّم معها.

  1. اسكّ مفتاح API: اللوحة ← مفاتيح API. على مستوى الحساب، أو محصور بالمشروع الوحيد اللي تبغى الوكيل يشوفه. انسخ السرّ md_live_…؛ يظهر مرّة وحدة.

  2. خذ ملف الخادم. هو ملف واحد، umarker-mcp.mjs — تقريباً 6 كيلوبايت Node عادي، بلا أي تبعيات وبلا شي تنصّبه (يبغى Node 18 أو أحدث). ما هو منشور على npm ولا فيه زرّ تنزيل بهذا الموقع لين الآن: اطلبه من support@umarker.com، أو من اللوحة ← الدعم. احفظه وين ما تبغى؛ المثال تحت يفترض ~/umarker-mcp.mjs.

  3. وجّه وكيلك له. مع 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.
الأداة وش تسوّي
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 هو كمان اللي يفتح للفريق خيارات إقفال الحلقة.

أنت: صلّح أهم علّة في 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، وبلا «ممكن ترسل لي لقطة للكونسول؟».

كل صفحة تقرير فيها زرّ نسخ التقرير كنصّ يحطّ نفس كتلة السياق في الحافظة. الصقها بأي محادثة أو وكيل، سواء ركّبت MCP أو لا. الزرّ يحتاج صلاحية feedback.export، لأن إخراج تقرير من المنتج قرار مستقلّ بحدّ ذاته.

  • خادم MCP يشتغل على جهازك ويتكلّم مع uMarker بس، بمفتاحك أنت. ما فيه وسيط يمرّ عليه الكلام ولا طرف ثالث بالنص.
  • المفاتيح تظهر مرّة، تُخزَّن كبصمة، تنسحب، ولها نطاق (حساب أو مشروع واحد). شوف مفاتيح الـAPI.
  • اللي انخفى، انخفى على جهاز المُبلِّغ، مو عندنا. قيم باراميترات الرابط اللي أسماؤها توحي بسرّ تُفرَّغ على كل مشروع، فالرمز اللي في رابط طلب فاشل ما وصل uMarker أصلاً ومستحيل يوصل وكيلك. أمّا قيم الحقول اللي كتبها الزائر والمناطق اللي تعلّمها أنت بمُحدِّد CSS فتُخفى بنفس الطريقة — في متصفّح المُبلِّغ نفسه قبل ما تُرفع اللقطة — لكن بس على مشروع مشغِّل «إخفاء الحقول الحسّاسة تلقائياً»، والمشروع الجديد يجي وهو مطفأ. وإلى أن تشغّله، اللقطة، وفي التقرير التقني سطور الكونسول اللي معها، تحمل اللي كان على الصفحة، وget_report يسلّمها لوكيلك. شوف إخفاء البيانات الحسّاسة.
  • التقرير الأقدم من نافذة السجلّ في باقتك مخفيّ هنا كمان: الـAPI وخادم MCP يحترمون نفس النافذة اللي تحترمها اللوحة.