خادم Cline MCP: توليد الصور مباشرة من محرر الأكواد

يُمثل خادم MCP البعيد في Cline مجموعة أدوات مُستضافة يستدعيها الوكيل عبر بروتوكول HTTP: بمجرد إضافة جزء برمجي واحد إلى ملف إعدادات MCP بتنسيق JSON، يكتسب Cline قدرات لا يستطيع أي نموذج لغوي تنفيذها بمفرده. ويُعد توليد ملفات الصور المثال الأكثر وضوحاً؛ إذ يستطيع Cline إعادة هيكلة الكود وتشغيل الاختبارات وكتابة ملفات التهيئة، لكنه يتوقف تماماً عند الرغبة في إضافة صورة المنتج.

الإعداد الكامل للبدء السريع. أنشئ مفتاحاً في حساب BananaBanana، وافتح إعدادات MCP في Cline وأضف التالي:

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

ستظهر لك عشر أدوات جاهزة للاستخدام. تبدأ تكلفة الصور من $0.03 لكل صورة تُخصم من رصيد مسبق الدفع، ويبدأ الفيديو من $0.10. سطر type إلزامي تماماً، والسبب يعود إلى خطأ تقني خفي سأفصله لاحقاً.

لماذا تضيف أداة توليد صور إلى Cline؟

يقوم جوهر عمل Cline على مبدأ «صف النتيجة واترك الوكيل ينجز الخطوات». ينجح هذا المسار بسلاسة حتى تتطلب النتيجة صورة، وحينها تنقطع السلسلة لتبدأ المهام اليدوية: فتح المتصفح، كتابة الوصف، التنزيل، إعادة التسمية، النقل إلى مجلد public/، ثم العودة واستعادة سياق العمل. يستغرق كل عنصر خمس دقائق، ويكلف تشتت التركيز أكثر من الوقت المستغرق نفسه.

باستخدام أداة MCP، يتولى الوكيل إدارة هذه العملية بالكامل؛ فيكتب الوصف البرمجي، ويستدعي دالة generate_image، ويحفظ الملف الناتج في المسار المحدد مع تحديث الكود. كل ما عليك فعله هو مراجعة الفروقات البرمجية (diff).

يتناسب النموذج المالي كذلك مع مستخدمي Cline؛ إذ يعتمد على نموذج «استخدم نموذجك الخاص»، وبالتالي اعتاد مستخدموه الدفع حسب الاستهلاك الفعلي بدلاً من الاشتراكات الشهرية. أسعار التوليد لدينا تتبع نفس المنطق دون باقات شهرية أو حد أدنى للإنفاق. صور تبدأ من $0.03 وفيديوهات من $0.10 تُخصم من رصيد تشحنه وقتما تشاء.

البديل الآخر هو تشغيل خادم MCP محلي على جهازك، وهو ما يتطلب تشغيل بيئة Node أو Python ومفتاح مزود منفصل مع متابعة الحصص والفواتير. يوفر الخادم السحابي كل ذلك؛ إذ تتم المعالجة على بنيتنا التحتية عبر نفس مسار مولد الويب، وتبقى بيانات اعتمادك محصورة في مفتاح واحد قابل للإلغاء في أي لحظة.

رسم توضيحي لنافذة طرفية يخرج منها شريط ناقل ينقل صوراً مؤطرة إلى مجلد مفتوح

كيف تضيف خادم MCP بعيد في Cline؟

توجد ثلاثة مسارات تؤدي إلى النتيجة نفسها، وجميع التفاصيل أدناه تمت مراجعتها وفقاً لـ توثيق Cline MCP الرسمي بتاريخ 20 أغسطس 2026.

عبر واجهة المستخدم. انقر على أيقونة MCP Servers في شريط أدوات Cline، وافتح تبويب Remote Servers، واكتب اسم الخادم والرابط https://bananabanana.pro/api/mcp، واختر Streamable HTTP كنوع للنقل. اضغط Add Server، ثم أضف ترويسة Authorization في الإعدادات؛ فالواجهة وسيلة سريعة للإضافة ولكن المفتاح يُحفظ في ملف JSON.

عبر تعديل ملف JSON. من الأيقونة نفسها، اختر تبويب Configure واضغط على زر Configure MCP Servers لفتح ملف الإعدادات. يقع الملف في مسار التخزين العام لـ VS Code داخل مجلد saoudrizwan.claude-dev (يحمل معرّف الإضافة اسم المطور الأصلي، وهو ما قد يربك من يبحث عن مجلد باسم «cline»). وفي واجهة الأوامر CLI يكون المسار ببساطة ~/.cline/mcp.json، ويفتح الأمر cline mcp معالج إعداد تفاعلياً.

عبر الطرفية. يعرض الأمر cline config mcp --json الإعدادات المحملة حالياً، وهي أسرع طريقة للتأكد من حفظ التعديلات.

أياً كان المسار، فإن نقطة الاتصال هي https://bananabanana.pro/api/mcp حصراً. لا تستخدم /mcp لأنها صفحة التوثيق الموجهة للقراءة وتعيد كود HTML لطلبات POST. تحتوي صفحة خادم MCP لدينا على الكود العام وجدول التوافق:

مقتطف الإعداد العام لـ MCP في وثائق BananaBanana يوضح رابط نقطة الاتصال وترويسة Authorization

قم بإجراء اختبار مجاني قبل استهلاك الرصيد؛ إذ تعيد دالة get_account رصيدك واسم المفتاح والحد اليومي، بينما تعرض list_models قائمة النماذج مع الأسعار المحدثة، وكلاهما مجاني ويؤكد نجاح الاتصال في ثانية واحدة.

سيناريو تطبيقي: توليد صور المنتجات دفعة واحدة في نمط Act

هنا تبرز كفاءة Cline الحقيقية، وهي مهمة تختلف تماماً عن مجرد إنشاء صورة واحدة للواجهة. نبدأ بنمط Plan: نصف الكتالوج المكون من اثني عشر منتجاً يحتاج كل منها لصورة بنمط بصري موحد، ونترك Cline يصمم مسار المعالجة قبل تعديل أي كود. ثم يتولى نمط Act التنفيذ الفعلي.

يتحقق النمط الموحد عبر صياغة وصفية ثابتة تتكرر مع كل طلب مع تغيير موضوع الصورة فقط؛ فالانسجام بين الصور ينتج عن الجزء الثابت في الوصف وليس عن تذكر النموذج لما أنتجه سابقاً:

→ generate_image {"prompt": "A photorealistic overhead product shot of a
   small monstera in a matte terracotta pot on a pale linen backdrop, soft
   diffused window light from the left, 50mm lens, subtle natural shadow,
   generous empty space around the subject, no text",
   "model": "nano-banana-pro", "aspect_ratio": "4:5"}
← {"job_id": "…", "status": "processing", "cost_charged_usd": 0.11,
   "balance_remaining_usd": 1110.65}

صورة منتج واقعية لنبتة مونستيرا في وعاء فخاري على قماش كتان، تم توليدها بواسطة Cline عبر MCP

المنتج الثاني بالهيكل الوصفي نفسه مع تغيير نوع النبتة وزاوية الالتقاط:

صورة منتج واقعية لنبتة جلد النمر في وعاء خزفي تم توليدها بالنمط الوصفي نفسه لكتالوج متناسق

تكلفة اثنتي عشرة صورة من هذا النوع باستخدام Nano Banana Pro تبلغ $1.32. وباستخدام النموذج القياسي nano-banana-2-lite تصبح التكلفة $0.36، وهو خيار ممتاز للصور المؤقتة؛ ويوضح دليل Lite حدود استخدام هذا النموذج الاقتصادي. استخدمنا Pro في هذا المقال لعرض الصور بكامل دقتها.

يُعد التوليد الجماعي الحالة المثالية التي تستوجب تفعيل ضوابط الأمان، وهناك وسيلتان للحماية: أولاً، يمكن تحديد سقف إنفاق يومي بالدولار لكل مفتاح من تبويب «الحساب → MCP API Keys» لضمان توقف العمليات عند حد معين. ثانياً، تعمل طلبات الصور المتعددة (number_of_images أكبر من 1) مثل الفيديو، حيث يعيد الطلب الأول تقدير التكلفة دون خصم حتى يعيد الوكيل الإرسال متضمناً confirm_cost.

يعمل توليد الفيديو من المحادثة نفسها وبقواعد التأكيد ذاتها. يبدأ مقطع Veo 3.1 Lite بدقة 720p الصامت لمدة 4 ثوانٍ من $0.10، بينما يكلف Omni Flash نحو $0.10 لكل ثانية شاملاً الصوت دائماً (أي $0.30 لمقطع من 3 ثوانٍ). تستغرق المعالجة بين دقيقة وعشر دقائق؛ ولأن دالة generate_video تعيد معرّف المهمة فوراً، يواصل Cline العمل على الكود ويستعلم عن النتيجة عبر get_result في الخلفية.

ملاحظات تقنية هامة في Cline قبل البدء

خمس نقاط أساسية مرتبة حسب ما يمكن أن توفره من وقت أثناء التطوير.

رسم توضيحي لروبوت صغير أمام لوحة تحكم بمفاتيح ذات أغطية حماية وعداد عملات معدنية

1. يجب كتابة "type": "streamableHttp" بدقة وإلا يفشل الاتصال بصمت. يوضح التوثيق أنه في حال ترك هذا الحقل فارغاً، يعتمد العميل نمط sse القديم للتوافق. يتطلب النمط القديم فتح اتصال GET بانتظار بث الأحداث، بينما تعتمد نقطة اتصالنا معيار Streamable HTTP عديم الحالة، مما يجعل رد الخادم 405 Method Not Allowed على أي طلب GET (تحققت من ذلك مجدداً: curl -i https://bananabanana.pro/api/mcp يعيد 405). يظهر هذا في Cline كفشل اتصال دون إشارة إلى الحقل المفقود. كما تفشل كتابة streamable-http بالشرطة بالطريقة ذاتها.

2. يُحفظ المفتاح كنص عادي داخل ملف الإعدادات. يوصي توثيق Cline بحفظ الأسرار في متغيرات البيئة، إلا أن إدراج المتغيرات داخل كائن headers للخوادم البعيدة غير مدعوم رسمياً (على عكس صيغة ${env:…} في Cursor أو ${file:…} في Windsurf). الميزة هنا هي مكان التخزين: ملف الإعدادات محفوظ في مساحة VS Code العامة وليس داخل مستودع المشروع، فلا خطر من رفعه بالخطأ إلى Git. ورغم ذلك، عامله كمفتاح سري: حدد سقفاً يومياً وألغِ المفتاح فور الاستغناء عن الجهاز.

3. خاصية Auto Approve أوسع نطاقاً مما تبدو عليه. في لوحة Auto Approve داخل Cline، يُعد خيار «Use MCP servers» مفتاحاً واحداً يشمل جميع أدوات MCP؛ فتفعيله يمنح الموافقة التلقائية للأدوات المدفوعة والمجانية معاً. يتم التحكم الدقيق داخل ملف الإعدادات عبر مصفوفة autoApprove. أنصح بحصر القائمة في الدوال المجانية الثلاث (list_models، get_account، get_result) لتجنب نوافذ التأكيد المتكررة مع الإبقاء على طلب الإذن لكل توليد مدفوع.

4. يتطلب نمط YOLO مع الأدوات المدفوعة حذراً شديداً. يوافق نمط YOLO في Cline تلقائياً على كافة الإجراءات: تعديل الملفات، أوامر الطرفية، تصفح الويب واستدعاءات MCP. يصنف التوثيق هذا النمط بالخطير لسبب وجيه؛ فلن تمنعك خطوة تأكيد التكلفة هنا لأن الوكيل سيوافق تلقائياً على خطوتي التسعير والتأكيد. الحماية الفعالة الوحيدة هي تحديد سقف يومي للمفتاح قبل تفعيل نمط YOLO.

5. لا يوجد تثبيت عبر المتجر وتخضع المؤسسات لضوابط خاصة. لم تعد إضافة VS Code المعتمدة على الحزمة الرسمية توفر واجهة لتصفح سوق MCP، لذا يُعد التعديل اليدوي لملف JSON المسار المعتمد. ويملك مديرو الفرق خيار remoteMCPServers لنشر الخادم مركزياً لجميع المطورين، مع تفعيل blockPersonalRemoteMCPServers لمنع إضافة خوادم شخصية. عند إعداد الفريق، اعتمد النشر المركزي وزود كل مطور بمفتاحه الخاص.

حد تقني نذكره بشفافية: تعيد دالة generate_speech رابطاً موثقاً لملف WAV بدلاً من مشغل صوتي مدمج داخل لوحة Cline، لذا يتطلب الاستماع فتح الملف. أما الصور فتظهر بمعاينة مصغرة بجوار الرابط مباشرة. يدعم Cline عرض الصور في نتائج الأدوات منذ عام 2025، لذا تظهر المعاينة بشكل سليم في كافة الإصدارات الحديثة.

هل يدعم Cline مصادقة OAuth للخوادم البعيدة؟

لا يدعمها بشكل موثق حتى الآن، ومن المهم توضيح ذلك لاختلاف الدعم بين الأدوات. يغطي توثيق Cline كلاً من stdio وSSE وStreamable HTTP مع المصادقة عبر الترويسات اليدوية دون ذكر لـ OAuth. يوجد طلب ميزة لدعم OAuth في مستودع Cline منذ أغسطس 2025 وما زال مفتوحاً حتى 20 أغسطس 2026.

من الناحية العملية، لا يشكل ذلك عائقاً؛ إذ يقبل خادمنا كلاً من رموز OAuth 2.1 ومفاتيح API بتنسيق Bearer، وهو النمط الذي صُمم Cline للتعامل معه. وهي الطريقة التي أفضلها شخصياً: إنشاء المفاتيح مجاني ويمكنك امتلاك عدة مفاتيح مع سجل استخدام منفصل لكل منها (الأداة، النموذج، التكلفة، مقتطف الوصف) بالإضافة إلى السقف اليومي. عند انتهاء عمل متعاقد خارجي، تلغي مفتاحه فقط دون التأثير على الفريق.

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

كم بلغت تكلفة الصور التجريبية في هذا المقال؟

أسعار التوليد القياسية المطبقة هي الأرقام نفسها التي توفرها دالة list_models للوكيل:

العنصر	النموذج	السعر
صورة منتج للمتجر، مونستيرا	Nano Banana Pro, 1K	$0.11
صورة منتج للمتجر، جلد النمر	Nano Banana Pro, 1K	$0.11
الغلاف + رسمتان توضيحيتان	Nano Banana Pro, 1K	$0.33
لقطة شاشة لصفحة التوثيق	متصفح، بدون تكلفة	$0.00
الإجمالي		$0.55

ملاحظة مفيدة عند شحن الرصيد: عمليات الإيداع من $50 فأكثر تمنح بونص +5%، ومن $100 فأكثر تمنح +10%، ويضيف كود الخصم الفعال +10% إضافية على الإيداع، مما يعني أن إيداع $100 مع كود خصم يمنحك رصيداً بقيمة $120.

يعمل المفتاح نفسه في البيئات الأخرى مثل Cursor أو VS Code دون الحاجة لإنشاء مفاتيح جديدة مع الاحتفاظ بالرصيد والسجل ونقطة الاتصال نفسها. يقدم دليل Cursor وإعداد VS Code تفاصيل ذلك. أنشئ مفتاحك الآن واطلب من Cline إنتاج أول حزمة صور لمشروعك.

الأسئلة الشائعة

هل يدعم Cline خوادم MCP البعيدة عبر Streamable HTTP؟

نعم، وهو خيار النقل الموصى به في وثائق Cline الرسمية. يتطلب الخادم البعيد إدخال url وtype بالقيمة streamableHttp وكائن headers للمصادقة. يجب تحديد type صراحة؛ حيث يؤدي إغفاله إلى الرجوع لنمط SSE القديم غير المتوافق مع نقاط الاتصال الحديثة. تم التحقق وفق التوثيق الرسمي في 20 أغسطس 2026.

أين يقع ملف إعدادات MCP في Cline؟

في مكانين حسب طريقة الاستخدام: تحفظه إضافة VS Code في مساحة التخزين العامة للمحرر داخل مجلد saoudrizwan.claude-dev، وأضمن طريقة لفتحه هي الضغط على زر Configure MCP Servers في تبويب Configure بلوحة MCP. أما في الطرفية فيكون المسار ~/.cline/mcp.json، ويستخدم كلاهما نفس هيكل كائن mcpServers.

هل أحتاج لحساب سحابي خاص لتوليد الصور في Cline؟

لا. يتطلب الخادم المحلي مفاتيح مزودين وحصصاً وفواتير منفصلة، بينما يقوم خادمنا بإجراء عمليات التوليد على بنيتنا التحتية المدارة، وتقتصر حاجتك على مفتاح bb_live_ من ملفك الشخصي. تحصل الحسابات الجديدة على رصيد ترحيبي قدره $0.20 يغطي توليد ست صور بالنموذج الاقتصادي قبل أي دفع.

كيف أمنع الوكيل من استهلاك رصيد زائد؟

استخدم طبقات الحماية الثلاث: قصر autoApprove على الأدوات المجانية فقط، وتحديد سقف إنفاق يومي بالدولار في «الحساب → MCP API Keys» (والذي يظل فعالاً حتى في نمط YOLO)، والاستفادة من خطوة تأكيد التكلفة للفيديوهات والصور المتعددة التي تطلب موافقة صريحة عبر confirm_cost.

لماذا لا يتصل خادم MCP في Cline؟

تأكد من النقاط التالية بالترتيب: كتابة "type": "streamableHttp" بحالة الأحرف الصحيحة (camelCase)؛ انتهاء الرابط بـ /api/mcp وليس /mcp؛ كتابة ترويسة المصادقة بصيغة Bearer bb_live_... دون مسافات إضافية. إذا تم الاتصال ولم تظهر الأدوات، أعد تشغيل الخادم من لوحة MCP، وتأكد في بيئات الشركات من عدم حظر الخوادم الخارجية بسياسات الأمان.