إضافة مبرمج لـ Codex وClaude Code: التثبيت والأدوات

ما هما الإضافتان؟

إضافة لـ Claude Code وأخرى لـ Codex، تحملان الاسم «مبرمج — MoparMeg» وخادم MCP واحداً بنسخةٍ مطابقة داخل كلٍّ منهما. يتحدّث الخادم إلى مبرمج عبر /api/v1 بترويسة Authorization: Bearer ومفتاح API منك، ويقدّم للوكيل تسع عشرة أداة أسماؤها تبدأ بـ moparmeg_، ومعهما مهارة تُلزم الوكيل بقراءة البيانات قبل الكتابة وبطلب موافقتك قبل أي عملية لها أثر خارجي.

يتطلّب تواصلاً مع الدعم: ملفات الإضافتين موجودة في مستودع المنصة تحت integrations/agent-plugins، ومعها سوق Claude Code محلي باسم moparmeg-ksa. لكن بطاقة الإضافة في صفحة التنزيلات تفتح هذا الدليل فقط ولا تقدّم الملفات للتنزيل، ولا تشير الشيفرة إلى سوق إضافات عام. التثبيت الموصوف أدناه يحتاج نسخة محلية من ذلك المجلد، وللحصول عليها تواصل مع الدعم.

المتطلّبات

• باقة مدفوعة. المسارات المحميّة ترفض الخطة المجانية برمز API_REQUIRES_PAID_PLAN (HTTP 403). يُستثنى moparmeg_me وفحص الاتصال (مسار /api/v1/me يقبل أي مفتاح صالح)، والقوالب والأقسام عامّة. التفاصيل في مرجع الواجهة البرمجية.
• Claude Code: Node.js 20 أو أحدث على PATH.
• Codex: مشغّل الخادم ملف cmd.exe، أي أنه يعمل على ويندوز فقط، ويبحث أولاً عن Node المرفق مع Codex.

١. أنشئ مفتاح API

1. سجّل الدخول وافتح صفحة «مفاتيح API» على /api-keys.
2. في «إنشاء مفتاح جديد» اكتب اسماً يميّزه (مثل claude-code).
3. تحت «الصلاحيات» اختر ما تحتاجه أدواتك (عمود «الصلاحية» في جدول الأدوات أدناه)، ثم اضغط «إنشاء».
4. انسخ المفتاح فوراً: يبدأ بـ mop_ ويليه ٣٢ محرفاً، ويظهر مرة واحدة فقط. من فقده ينشئ غيره.
5. لا تلصق المفتاح في محادثة الوكيل أبداً؛ ضعه في إعداد الإضافة أو متغيّر البيئة كما في الخطوات التالية.

الصلاحيات المحدَّدة مسبقاً في النموذج هي كلها عدا «نشر المشاريع وإلغاء نشرها» (publish) و«طلب شراء النطاقات ونقلها» (domains:write)؛ هاتان تُختاران عمداً. والصلاحيات تُختار عند الإنشاء ولا تتغيّر بعده: من احتاج غيرها ينشئ مفتاحاً آخر ويُبطل القديم. والمفتاح الذي أُنشئ قبل الصلاحيات يفتح /api/v1/ai و/api/v1/projects وحدهما، وبقية المسارات المحميّة ترفضه برمز API_KEY_SCOPE_REQUIRED (HTTP 403).

خطوات المفتاح بالتفصيل في صفحة مفاتيح API.

٢. التثبيت في Claude Code

1. من نسخة محلية تحتوي مجلد الإضافات، أضف السوق المحلي ثم ثبّت الإضافة:

   /plugin marketplace add ./integrations/agent-plugins
   /plugin install moparmeg@moparmeg-ksa

2. عند تفعيل الإضافة يطلب Claude Code خيار api_key ويخزّنه قيمةً حسّاسة. اتركه فارغاً إن كنت ضبطت المتغيّر MOPARMEG_API_KEY.
3. بديل المتغيّر: في PowerShell [Environment]::SetEnvironmentVariable("MOPARMEG_API_KEY", "<key>", "User") ثم أعد فتح الطرفية، أو في bash/zsh export MOPARMEG_API_KEY=<key>.
4. جرّب بطلب «افحص اتصال مبرمج»؛ فيستدعي الوكيل moparmeg_connection_status.

٣. التثبيت في Codex

1. انسخ مجلد integrations\agent-plugins\codex إلى %USERPROFILE%\plugins\moparmeg (احفظ نسخة من أي إصدار أقدم أولاً).
2. سجّله في السوق الشخصي ~/.agents/plugins/marketplace.json بمصدر محلي مساره ./plugins/moparmeg.
3. شغّل سكربت حفظ المفتاح؛ يقرأ المفتاح بإدخال مخفي، ويرفض ما لا يطابق شكل mop_ + ٣٢ محرفاً، ويجرّبه على GET /api/v1/projects قبل حفظه في متغيّر المستخدم MOPARMEG_API_KEY. ردّ 401 يُلغي الحفظ. وردّ 403 برمز API_KEY_SCOPE_REQUIRED أو API_REQUIRES_PAID_PLAN يحفظ المفتاح مع تحذير يسمّي السبب (الصلاحية الناقصة، أو أن الواجهة للباقات المدفوعة)، وأي ردّ 403 آخر يُلغي الحفظ:

   powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\moparmeg\scripts\configure_moparmeg_key.ps1"

4. أعد تشغيل Codex، وافتح /plugins، وثبّت «مبرمج — MoparMeg».

٤. الأدوات التسع عشرة ومساراتها

كل أداة تنادي مساراً واحداً في /api/v1 (عدا فحص الاتصال، والنشر الذي يقرأ المشروع أولاً)، وكل مسار محميّ يطلب على المفتاح الصلاحية المذكورة في الجدول. القوالب والأقسام عامّة وأداتاهما لا ترسلان المفتاح، وmoparmeg_list_sections تُبقي عند الطلب أقسام تخطيط واحد بمعرّفه pack من قائمة packs في الردّ. وmoparmeg_create_project ترسل العنوان والوصف فقط، فينشأ المشروع بالقالب الفارغ، ويخضع لحدّ عدد المشاريع في باقتك: عند بلوغه يُرفض برمز PROJECT_QUOTA (HTTP 403). الجدول يصف ما تقدّمه شيفرة المنصة؛ فإن كان عنوان المنصة الذي تتصل به يعمل بإصدار أقدم يخلو من مسار ما، تتلقى الأداة 404 ويعرض الخادم رسالة «هذه الأداة تتطلّب إصدار واجهة مبرمج الأحدث». أدوات البناء والتصميم بالذكاء الاصطناعي تستهلك حصة الذكاء لباقتك.

moparmeg_generate_design_system تطلب معرّف المشروع واسم العلامة، وتقرأ بثّ المسار حتى نهايته ثم تعيد الملخّص ورموز التصميم وأسماء الملفات المحفوظة في المشروع؛ وحدث خطأ في البثّ يُعدّ فشلاً. وmoparmeg_generate_logo تولّد شعار SVG، وتحفظه في المشروع حين تُعطى معرّفه. وmoparmeg_check_domain تعيد حالة النطاق (متاح، أو محجوز، أو غير معروف) بلا سعر.

٥. النشر وطلب النطاق يتطلّبان تأكيداً

moparmeg_publish_project وmoparmeg_order_domain عمليتان لهما أثر خارجي: موقع عام، ومال حقيقي. كلتاهما ترفض التنفيذ ما لم يصلها confirm: true صريح، وترفض قبل أي طلب شبكي. والمهارة المرفقة تُلزم الوكيل بأن يعرض عليك العملية كاملة (المشروع وملفاته الحالية التي ستُنشر، أو النطاق وعدد السنوات ونوع الطلب) وينتظر موافقتك الصريحة، ثم يعيد النداء بالتأكيد، ولا يذكر سعراً قبل الطلب. وتحتاج كل منهما على المفتاح صلاحية غير محدَّدة مسبقاً: publish (ومعها projects:read للنشر) أو domains:write.

بعد التأكيد: النشر يقرأ ملفات المشروع الحالية وينشرها هي بعينها، فإن تغيّرت بين القراءة والنشر ردّ المسار 409 برمز PUBLISH_REVISION_CONFLICT ولم يُنشر شيء؛ وإلغاء النشر (unpublish: true) لا يحتاج القراءة. وطلب النطاق يُنشئ طلباً لا شراءً فورياً: يعود بحالته، ويُسعَّر آلياً من كلفة المزوّد إن توفّرت وإلا يبقى PENDING_QUOTE إلى أن يسعّره الفريق، والدفع خطوة لاحقة. ويطلب المسار اسم المسجِّل وبريده في contact، ويرفض الباقة التي لا تشمل النطاقات المخصّصة برمز PLAN_CAPABILITY_REQUIRED (HTTP 402).

الأمان

• المفتاح لا يُطبع: ردود الخادم وأخطاؤه وسجلّه تمرّ بإخفاء المفتاح.
• يُرسل المفتاح عبر https فقط؛ وhttp مسموح للعنوان المحلي وحده (localhost و127.0.0.1). عنوان المنصة الافتراضي https://moparmeg-ksa.com ويُغيَّر بـ MOPARMEG_BASE_URL (أو خيار base_url في Claude Code).
• ما تكتبه لأداتي البناء والتصميم يصل مزوّدي الذكاء الاصطناعي؛ لا تضع فيه كلمات مرور أو مفاتيح أو بيانات شخصية لغيرك.
• إن تسرّب المفتاح فأبطله من صفحة مفاتيح API وأنشئ غيره. المفتاح لا يستطيع إنشاء مفاتيح أخرى: إدارة المفاتيح بجلسة المتصفح وحدها.

رسائل الأخطاء

أسئلة شائعة

هل أستطيع نشر موقعي من Claude Code اليوم؟

تقدّم الإضافة ذلك: moparmeg_publish_project تنشر ملفات المشروع الحالية بمفتاح يحمل publish وprojects:read، وبعد موافقتك الصريحة (confirm: true). وتمرّ بالبوّابات نفسها التي يمرّ بها النشر من المنصة؛ التفاصيل في صفحة النشر.

هل تعمل الإضافة مع الخطة المجانية؟

جزئياً. moparmeg_me وفحص الاتصال وعرض القوالب والأقسام تعمل، وبقية الأدوات تتلقى رفضاً صريحاً: 403 برمز API_REQUIRES_PAID_PLAN، أو 402 حيث تُسأل الباقة عن الذكاء الاصطناعي أولاً.

مفتاحي القديم يعرض المشاريع لكنه يُرفض في الصفحات والنسخ، لماذا؟

المفتاح الذي أُنشئ قبل الصلاحيات يفتح /api/v1/ai و/api/v1/projects وحدهما. أنشئ مفتاحاً جديداً واختر صلاحياته.

هل Codex على ماك أو لينكس مدعوم؟

مشغّل إضافة Codex مكتوب لـ cmd.exe، فهو لويندوز فقط الآن. إضافة Claude Code تحتاج Node.js فقط.