إضافات Claude: دليل النشر من GitHub إلى الدليل العام

نشر إضافات Claude: الجواب المختصر

لنشر إضافة Claude، اتبع هذا التسلسل:

1. تأكد من أن حساب Claude الذي سيقدّم الطلب مشترك في Pro أو Max أو Team أو Enterprise.
2. اختر المؤسسة التي ينبغي أن تملك القائمة على المدى الطويل.
3. جهّز الإضافة مع .claude-plugin/plugin.json وREADME وترخيص.
4. اختبر المجلد محليًا، ثم ضعه في مستودع GitHub يستطيع حساب GitHub المتصل الدفع إليه.
5. افتح بوابة المطورين، واختر Plugin bundle، ثم أدخل المستودع ومسار الإضافة الاختياري والفرع أو الوسم المتتبَّع، وشغّل Validate.
6. أكمل إعدادات معالجة البيانات والامتثال والتواصل والتحديث، ثم اختر Submit for review.
7. إذا كانت الإضافة تشير إلى خادم MCP بعيد تديره، فأنشئ طلب MCP connector منفصلًا لذلك الخادم.

يمكن أن يبقى المستودع خاصًا أثناء التحقق والمراجعة إذا استوفيت شروط Anthropic للوصول عبر GitHub ورفع الشيفرة المصدرية. ويجب تحويله إلى مستودع عام قبل نشر الإضافة فعليًا.

حدّد نوع القائمة قبل فتح البوابة

الإضافة والموصل مترابطان، لكن أحدهما لا يحل محل الآخر. تخيّل الإضافة كدليل تشغيل جاهز، وخادم MCP البعيد كمكتب الخدمة الذي ينفّذ العمل خلفه: الأول يعلّم Claude سير العمل، والثاني يمنحه وصولًا مباشرًا إلى منتجك أو بياناتك.

المهارة ليست نوعًا ثالثًا من الطلبات؛ ضعها داخل حزمة إضافة. وإذا كانت الحزمة تشير إلى خادم MCP تستضيفه، فأرسل المنتجين من مؤسسة Claude نفسها واجعلهما يشيران إلى عنوان الخادم نفسه. عندها تستطيع البوابة ربط القائمتين، ولن يرى المستخدمون مجموعات أدوات مكررة.

اختر الجهة التي ستملك القائمة

اختيار المؤسسة قرار دائم يخص المنتج، وليس تفصيلًا إداريًا. في حزمة الإضافة، تصبح القائمة ملكًا لأول مؤسسة ترسل مجلدًا بعينه من مستودع محدد، ولا تستطيع مؤسسة ثانية إرسال المستودع والمجلد نفسيهما.

قواعد الحساب واضحة:

• في Pro أو Max، ترسل الطلب من حسابك الشخصي.
• في Team أو Enterprise، يستطيع Owner إرسال الطلب.
• في Enterprise، يستطيع Owner منح صلاحية Directory من خلال دور مخصص.
• يجب أن يكون حساب GitHub المتصل داخل مؤسسة Claude قادرًا على الدفع إلى المستودع.

إذا أنشأت وكالة الإضافة بينما يجب أن تعود هويتها العامة إلى العميل، فعلى مؤسسة العميل أن تتولى الإرسال. نقل المستودع لاحقًا لا يعني نقل ملكية قائمة الدليل.

ما تكلفة هذا المسار؟

لا تذكر تعليمات Anthropic العامة رسومًا مستقلة للإدراج في الدليل، لكن حساب Free لا يحق له الإرسال. لذلك تبدأ التكلفة النقدية من الاشتراك المدفوع المطلوب لدخول البوابة.

• يستطيع المطور الفردي الذي لا يملك اشتراكًا مدفوعًا البدء بخطة Pro مقابل $20 لشهر واحد بفوترة شهرية، أو $17 شهريًا عند دفع $200 مقدمًا لسنة.
• تتطلب Team شخصين على الأقل. تبلغ تكلفة مقعدين قياسيين $50 لشهر واحد بفوترة شهرية، أو $40 شهريًا مع الفوترة السنوية.
• تبدأ Max من $100 شهريًا، لكنها ليست مطلوبة لمجرد إرسال الطلب.

التكلفة الأكبر هي تجهيز الإصدار. فالمنتج المستضاف يحتاج إلى طلبين جاهزين: أحدهما للحزمة والآخر للموصل. وتحتاج الإضافة أيضًا إلى manifest ثابت، وREADME لا يقل عن 40 كلمة، وترخيص، وإجابات عن معالجة البيانات، وجهة اتصال للمراجعة، ومستودع يمكن جعله عامًا. تجمع البوابة الجديدة التحقق ونتائج الفحص وحالة المراجعة والنشر والتحديثات والاستخدام في مكان واحد، فتخفف عبء التنسيق لكنها لا تلغي العمل نفسه.

جهّز حزمة إضافة صالحة للدليل

أصغر حزمة موثوقة تأخذ هذا الشكل:

your-plugin/
  .claude-plugin/plugin.json
  skills/your-workflow/SKILL.md
  README.md
  LICENSE

يحتاج ملف manifest إلى name دائم بأحرف صغيرة، وdisplayName ظاهر للمستخدم، وversion، وdescription مفيد، واسم المؤلف، وإقرار بالترخيص أو ملف ترخيص مستقل. اختر الاسم الدائم بعناية؛ يمكنك تغيير displayName، لكن اسم manifest هو هوية الإضافة.

ملف README ليس مجرد إجراء تنظيمي للمستودع. يستخدمه الدليل مادةً للقائمة، ويفشل التحقق إذا احتوى README على أقل من 40 كلمة خارج كتل الشيفرة. وضّح وظيفة الإضافة وطريقة استخدامها والبيانات التي ترسلها، ولا تضع أي بيانات اعتماد حقيقية في المستودع.

إذا كانت الحزمة تشير إلى خادم بعيد، فأضف نقطة نهاية HTTPS إلى .mcp.json. لا تضع مفاتيح API فيه، لأن كل من يثبت الإضافة يحصل على ملفاتها.

اختبر محليًا ثم أعد التحقق في البوابة

يكشف التحقق المحلي ملفات الإضافة غير الصحيحة قبل أن يدخل GitHub في المسار:

claude plugin validate ./your-plugin
claude --plugin-dir ./your-plugin

يفحص الأمر الأول صياغة الملفات والمخطط، بينما يفتح الثاني جلسة واحدة من Claude Code بعد تحميل مجلد العمل لتجربة مهاراته وأوامره. لكن التحقق المحلي لا يغني عن زر Validate في البوابة، إذ تفحص البوابة أيضًا متطلبات الدليل وبنية المستودع وتعارضات الأسماء وسياسة الملفات وغيرها من قواعد الإرسال.

لهذا الشرح، أُنشئت إضافة صغيرة باسم release-note-builder تضم مهارة واحدة وثلاثة ملفات لمشكلات افتراضية: تصدير جديد لسجل التدقيق بصيغة CSV، وتحسين ترقيم الصفحات، وإصلاح تكرار البريد الإلكتروني. أعاد Claude Code 2.1.283 نتيجة Validation passed مع رمز خروج 0، ومن دون أخطاء أو تحذيرات.

بعد ذلك حُمّل المجلد باستخدام claude --plugin-dir لإجراء تجربة على البيانات النموذجية. لم تكن هناك جلسة Claude موثّقة على هذا الجهاز، فتوقف الطلب عند Not logged in · Please run /login قبل أي استدعاء للنموذج، ولم تظهر ملاحظة إصدار مولّدة. هذا حد مهم: يمكن تشغيل فحص المجلد محليًا، أما اختبار السلوك فيحتاج إلى وصول موثّق للنموذج. ولمنهج أشمل لاختبار السلوك، راجع الدليل المستقل حول اختبارات إضافات Claude Code.

أكمل طلب الإضافة

تقسّم الوثائق العامة العمل في البوابة إلى ست مراحل عملية.

1. المصدر

أدخل مستودع GitHub على هيئة عنوان URL أو owner/repo. وإذا كانت الإضافة داخل مجلد فرعي، فأضف مسارها. اختر فرعًا أو وسمًا لتتبّع الإصدارات اللاحقة، أو اترك الحقل فارغًا لمتابعة الفرع الافتراضي، ثم اختر Validate.

يقرأ التحقق commit واحدًا. وإذا دفعت إصلاحًا جديدًا، فاختر Re-validate حتى يقرأ التقرير أحدث commit.

2. تفاصيل القائمة

تبني البوابة القائمة من plugin.json وREADME. إذا كان الاسم أو الوصف أو الشرح غير صحيح، فعدّل ملفات المستودع ثم أعد التحقق. وبهذا يبقى الوعد المعلن والحزمة المنشورة ضمن الإصدار نفسه.

3. معالجة البيانات

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

4. الامتثال والتواصل

قدّم بريدًا إلكترونيًا يمكن لـAnthropic استخدامه أثناء المراجعة، ثم أكمل الإقرارات الإلزامية الأربعة. قد تعيد البوابة إصدارًا مصحوبًا بملاحظات أو تعديلات مطلوبة، لذا استخدم صندوق بريد يتابعه شخص فعليًا.

5. التحديثات

اختر webhook الافتراضي للدفع في GitHub أو عمليات الفحص المجدولة فقط. يتيح المساران للدليل مراقبة الفرع أو الوسم المتتبَّع، ويتطلب إعداد webhook صلاحية إدارة المستودع.

6. المراجعة والإرسال

راجع التفاصيل ثم اختر Submit for review. تستطيع المؤسسة إنشاء ما يصل إلى 10 طلبات خلال 24 ساعة، وتدخل المسودات والطلبات المسحوبة ضمن العدد. لا تنشئ طلبًا مكررًا حين يكون المطلوب متابعة مسودة موجودة.

أرسل خادم MCP البعيد في طلب مستقل

إذا كانت إضافتك تستدعي خادم MCP بعيدًا تديره، فارجع إلى Submit new واختر MCP connector. يطلب مسار الموصل تفاصيل تشغيلية أكثر، لأن Anthropic ستدرج خدمة حية لا مجرد مجلد.

جهّز عنوان الخادم، وعناوين URL للوثائق وسياسة الخصوصية، وأيقونة، وبيانات اعتماد اختبار للمراجع، وأي صور للعرض الدوّار في MCP App. يغطي المسار الموثق الاتصال والأدوات المتزامنة والقائمة العامة وحالات الاستخدام والشركة والمصادقة ومعالجة البيانات وتعليمات الاختبار والامتثال والمراجعة النهائية.

تتضمن حقول القائمة العامة اسم خادم يصل إلى 100 حرف، ووصفًا في سطر واحد يصل إلى 200 حرف، ووصفًا أطول يصل إلى 2,000 حرف، ومن فئة واحدة إلى خمس فئات، إلى جانب الوثائق والخصوصية والدعم والأيقونة وslug دائم لعنوان URL. ويحتاج المراجعون أيضًا إلى حساب اختبار مجهّز إذا كان المنتج يتطلب حسابًا. لا تعتبر الموصل جاهزًا لمجرد أن نقطة فحص الصحة تستجيب؛ شغّل كل أداة عبر MCP Inspector أو كموصل مخصص داخل Claude أولًا.

تعامل مع الحالة كقائمة إجراءات

لا توجد مدة مراجعة موعودة. السؤال المفيد ليس «كم تستغرق المراجعة؟»، بل «من عليه أن يتحرك الآن؟»

حالة Approved لا تعني أن الإضافة قابلة للتثبيت؛ ذلك لا يتحقق إلا عند Published. وقد يظل الإعداد الافتراضي متطلبًا أن ينشر مراجع من Anthropic الإصدار الذي اجتاز الفحص. ويمكن لاحقًا ضبط بعض الإضافات لنشر التحديثات الناجحة تلقائيًا، لكن الإصدار المعلّق يظل في الانتظار.

خطّط للتحديثات قبل الإطلاق الأول

بعد النشر، ادمج التغييرات في الفرع المتتبَّع أو انقل الوسم المتتبَّع. يقرأ الدليل commit الجديد ويتحقق منه ويفحصه أمنيًا ويعرضه كإصدار آخر. ارفع قيمة version في plugin.json مع كل إصدار.

لا يؤدي فشل تحديث أو تعليقه إلى إزالة القائمة العاملة؛ يواصل الدليل تقديم آخر إصدار منشور حتى يصبح البديل متاحًا. وهكذا يتحول الفرع إلى موجز للإصدارات، لا مجرد مكان لحفظ الشيفرة.

بعدها تغلق علامة التبويب Usage حلقة الملاحظات. يمكنها عرض عمليات التثبيت والحسابات النشطة والاحتفاظ وحصة كل إصدار واستخدام المكوّنات وأخطاء التحميل واستدعاءات MCP وزمن الاستجابة ومشاهدات القائمة ونقرات التثبيت وعمليات التثبيت خلال مدة محددة تصل إلى 90 يومًا. تُحدّث الأرقام مرة يوميًا بتوقيت UTC، ويمكن تصديرها بصيغة CSV. لا تعد برقم تثبيت قبل أن تسجله البوابة.

أكثر ستة فرق استفادة من الدليل

1. فرق SaaS التي تقدم منتج MCP بعيدًا

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

2. شركات برمجيات سير العمل

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

3. مشرفو الإضافات مفتوحة المصدر

يستطيع المشرف إبقاء الشيفرة عامة، وتتبع فرع الإصدار، واستخدام البوابة كقائمة مستقرة وقناة تحديث. يظل آخر إصدار ناجح متاحًا أثناء إصلاح commit جديد، ما يقلل الضغط لجعل كل دفعة إلى المستودع جاهزة فورًا للمستخدمين.

4. الوكالات التي تسلّم إضافات لعملائها

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

5. فرق المنصات في المؤسسات

يستطيع Enterprise Owner منح أعضاء محددين صلاحية Directory بدل مشاركة دور مالك واسع. وبذلك يفصل الفريق أعمال الإصدار عن الإدارة العامة للمؤسسة، مع إبقاء القائمة داخل مؤسسة الشركة.

6. مطورو أدوات Claude Code الذين يتوسعون خارج الطرفية

يمكن نقل أمر أو مهارة إلى الدليل الأوسع، لكن بعد التحقق من دعم كل واجهة. تعمل المهارات في المحادثة وCowork وClaude Code. أما الوكلاء وhooks فلا يعملون في المحادثة، وكذلك خوادم MCP المحلية، فيما تظل خوادم LSP حصرية لـClaude Code. الفائدة هي تجنب قائمة توحي بتجربة متطابقة في كل مكان بينما لا تستطيع الحزمة تقديمها.

ثلاثة منتجات تستحق البناء حول البوابة

1. Plugin Release Gate: الفرصة الأقوى

يمكن بناء فحص في GitHub يراجع الإضافة قبل وصول فرع الإصدار إلى البوابة. يشغّل التحقق المحلي، ويتأكد من README والترخيص، وينبّه إلى تركيبات المكوّنات غير المدعومة، ويقارن إصدار manifest، ثم يصدر تقريرًا عن الجاهزية للدليل.

الطلب ظاهر بالفعل: تحقق عبارة claude code plugins نحو 5,400 عملية بحث شهرية في الولايات المتحدة، بنية تجارية وCPC قدره $6.22. أصغر منتج قابل للبيع هو GitHub App مع تقرير على الويب وشارة للمستودع. لكن هناك قيدًا مهمًا: لا يمكنه أن يعد بصدق بموافقة البوابة، لأن فحوص دليل Anthropic والمراجعة البشرية تتجاوز الأمر المحلي. قيمته في تقليل الأخطاء التي يمكن منعها، لا ضمان القبول.

2. Directory Listing Optimizer

يمكن بناء طبقة تقارير تستورد ملف CSV من البوابة، ثم تحوّل المشاهدات ونقرات التثبيت وعمليات التثبيت ومصادر الاكتشاف والإصدارات واستخدام المكوّنات إلى توصيات للقائمة والإصدارات. المشتري هو ناشر إضافة يملك حركة كافية لجعل البيانات اليومية مفيدة.

تحقق عبارة claude plugins نحو 8,100 عملية بحث شهرية في الولايات المتحدة، بنية تجارية وCPC قدره $9.05. يحتاج المنتج الأولي إلى رفع CSV وحسابات لمسار التحويل ومقارنة الإصدارات وقائمة إجراءات أسبوعية. المشكلة هي البداية الباردة: قبل النشر وظهور استخدام حقيقي، لا يملك المنتج بيانات خاصة يحللها. كما أنه يعتمد على ملف مُصدّر لا على API تحليلات موثقة.

3. Cross-Surface Plugin Auditor

يمكن بناء ماسح ثابت يوضح للفريق بدقة ما ستحمّله Chat وCowork وClaude Code من مجلد إضافة واحد. وينبغي أن ينبّه إلى مجلد bin/ في المستوى الأعلى، وافتراضات MCP المحلية، والوكلاء وhooks التي تتجاهلها المحادثة، وخوادم LSP الخاصة بـClaude Code، ثم ينشئ مصفوفة اختبار.

تحقق عبارة claude-plugins marketplace نحو 1,900 عملية بحث شهرية في الولايات المتحدة، مع صعوبة 16 ونية تجارية. المنتج الأولي هو ماسح للمستودع يستند إلى جدول دعم Anthropic. أما التحدي فهو الصيانة: سيتغير دعم المنصة، وقد لا يهتم المطورون الذين يستهدفون الطرفية وحدها بالتوافق الأوسع.

يبقى Release Gate الرهان الأفضل لأنه يدخل في كل إصدار، لا في القائمة الأولى فقط، كما أنه يكمل عمل البوابة بدل محاولة استبدالها.

ما الذي لا تحله هذه البوابة؟

لا تجعل البوابة الإضافة الضعيفة مفيدة. يستطيع التحقق إثبات سلامة بنية الملفات وتوافقها مع السياسات، لكنه لا يثبت أن المهارة تحسن النتائج. كما أنها لا تضمن سلوكًا متطابقًا للمكوّنات في كل تطبيقات Claude، ولا توفر مدة مراجعة ثابتة أو شارة Verified عند الطلب أو جمهورًا جاهزًا للتثبيت يوم الإطلاق.

ولا تدمج منتج MCP مستضافًا في قائمة واحدة. ففصل طلب الموصل مقصود لأن مصادقة الخادم وصحته وأدواته وسياساته تحتاج إلى سجل تشغيلي مستقل.

لا تزال تجربة الاكتشاف الموحدة تُطرح تدريجيًا خلال الأسابيع التالية لإطلاق 25 سبتمبر. انشر للواجهات الموثقة الآن، وتعامل مع اتساع الاكتشاف كتوزيع قادم، لا كمدى حالي يمكنك الوعد به.

ما الذي ينبغي فعله يوم الاثنين؟

اختر مؤسسة Claude التي يجب أن تملك القائمة. ضع سير عمل حقيقيًا واحدًا في حزمة إضافة، وامنحه اسم manifest ثابتًا وREADME مفيدًا وترخيصًا، ثم شغّل التحقق المحلي. وإذا كان يستدعي خادم MCP الذي تستضيفه، فجهّز طلب الموصل بالتوازي. لا تفتح البوابة قبل حسم قرار الملكية ومسار المستودع.

إذا أردت بناء إضافة وموصلها الإنتاجي كنظام إصدار واحد موثوق، فاطّلع على أنظمة الذكاء الاصطناعي الإنتاجية.