Nano Banana MCP مع Claude Code: الإعداد والمهارة والأسعار

يستطيع وكيل البرمجة الخاص بك أن يهيّئ صفحة هبوط في دقيقة، ثم يتوقف لأن صورة البطل لم تُنشأ بعد. يسدّ خادم Nano Banana MCP هذه الفجوة. تسجّله مرة واحدة في Claude Code، وتطلب صورة بلغة إنجليزية بسيطة، فيُحفظ الملف في مجلد مشروعك بينما تواصل عملك. فيما يلي أوامر الإعداد الدقيقة، وملف مهارة قابل لإعادة الاستخدام، وقائمة تحقق للأمان، وأسعار الصورة الواحدة المنشورة في أكتوبر 2026، حتى تقرر خلال عشر دقائق إن كان يستحق مكانًا في أدواتك.

ما هو Nano Banana فعلًا

بدأ اسم "Nano Banana" لقبًا لنموذج Gemini 2.5 Flash Image من Google، ثم تحوّل إلى اسم علامة تجارية للسلسلة كاملة. هذه هي الأسماء الأربعة التي ستراها في قوائم الأسعار:

لماذا نضيفه إلى Claude Code

يقرأ Claude Code مستودعك بالفعل، ويعدّل الملفات، ويشغّل الأوامر. لكنه لا يستطيع الرسم. يمنحه خادم الصور أداة generate_image، فتنتج الجلسة نفسها التي تكتب المكوّن صورة البطل وبطاقة المشاركة واللوحة الفنية لحالة الفراغ، ثم تربطها بالصفحة عبر مسار الملف. لا تبديل بين علامات التبويب، ولا مجلد تنزيلات، ولا إعادة تسمية لملفات image (3).png.

مهام نموذجية تناسب هذا الأسلوب:

• صور البطل والمدونة تُنشأ بجانب الصفحة التي ستستخدمها
• نماذج منتجات توضع في غرف مختلفة وفصول وإضاءات متعددة
• تعديلات على صور موجودة: استبدال الخلفية، تصحيح الإضاءة، إزالة عنصر مشتت
• فن مؤقت للنماذج الأولية يُستبدل لاحقًا

ما يجيده وما يضعف فيه

يتبع الأوامر النصية الطويلة والوصفية بدقة، ويحافظ على ثبات الموضوع عبر عدة تعديلات، ويعرض النصوص القصيرة بوضوح. يستطيع Nano Banana 2 أيضًا أن يستند إلى البحث المباشر على الويب، وهذا مفيد عندما ينبغي أن تطابق الصورة شيئًا حدث هذا الأسبوع.

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

كيف يعمل رابط MCP

بروتوكول Model Context Protocol معيار مفتوح يتيح لعميل الذكاء الاصطناعي استدعاء أدوات خارجية. تشارك ثلاثة مكوّنات:

1. Claude Code، العميل الذي يقرر متى تكون الأداة ضرورية.
2. خادم MCP، عملية صغيرة بلغة Node أو Python على جهازك يشغّلها Claude Code عند الحاجة.
3. واجهة Gemini API من Google، حيث تُنشأ الصورة فعلًا.

تطلب صورة. يستدعي Claude Code أداة باسم شبيه بـ mcp__nanobanana__generate_image. يرسل الخادم أمرك النصي إلى نموذج صور من Gemini، ويحفظ النتيجة على القرص، ويردّ بمسار الملف. هذه الخطوة الأخيرة أهم مما تبدو عليه.

💡 لماذا تتفوّق المسارات على البيانات الخام: يحدّ Claude Code من حجم المخرجات التي يُسمح لأداة MCP بإعادتها (يمكنك رفع الحد بمتغير البيئة MAX_MCP_OUTPUT_TOKENS). ستستنزف صورة بصيغة base64 نافذة السياق بسرعة. ويذكر سرد @nanobanana/mcp أنه يعيد مسارات الملفات بدلًا من ذلك، وهذا يُبقي جلستك خفيفة.

أي خادم تختار

توجد عدة خوادم من المجتمع. ولا يأتي أيٌّ منها من Anthropic أو Google.

تستخدم الأمثلة أدناه @nanobanana/mcp لأنه الأبسط: ثلاث أدوات ومتغير واحد. تعمل الخوادم الأخرى بالطريقة نفسها، مع اسم حزمة ومتغير مختلفين.

الإعداد في خمس دقائق

احصل على توكن Gemini

افتح صفحة مفاتيح API في Google AI Studio (aistudio.google.com/apikey) وأنشئ توكنًا. توجد باقة مجانية، لكن ملخصات الأسعار تشير إلى أن Google قد تستخدم التوليدات المجانية لتحسين منتجاتها. استخدم مشروعًا مدفوعًا للعمل مع العملاء أو للصور الخاصة.

سجّل الخادم

على macOS أو Linux أو WSL، شغّل:

claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- npx -y @nanobanana/mcp

نسخ الأمر النصي

أما Windows الأصلي فيحتاج إلى غلاف cmd /c حتى يتمكن Claude Code من تشغيل npx:

claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- cmd /c npx -y @nanobanana/mcp

نسخ الأمر النصي

تختار أيضًا النطاق. Local هو الافتراضي ويُطبَّق عليك في هذا المشروع. أضف --scope project لكتابة .mcp.json مشترك يستخدمه الفريق كله، أو --scope user لجعل الخادم متاحًا في كل المشاريع.

💡 ضع كل الأعلام قبل الشرطتين المزدوجتين. كل ما يأتي بعدهما يذهب إلى npx وليس إلى Claude Code، وهذا هو السبب الأكثر شيوعًا في عدم اتصال خادم جديد.

تحقّق من الاتصال

شغّل claude mcp list، ثم افتح Claude Code واكتب /mcp. يجب أن يظهر مدخل nanobanana بعبارة connected. اختبره الآن بطلب حقيقي:

أنشئ صورة بنسبة 16:9 لموزة ناضجة على طاولة خشبية في ضوء صباحي من النافذة، واحفظها في public/images/test.jpg

إذا عاد مسار ملف وفُتحت الصورة، فالرابط يعمل. قد تستغرق المرة الأولى وقتًا أطول لأن npx يحمّل الحزمة؛ أما الاستدعاءات اللاحقة فتبدأ أسرع.

أبقِ الأسرار خارج المحادثة

يجب أن يبقى توكنك في متغير بيئة ولا يُحفظ في أي مكان آخر. لا تلصقه أبدًا في أمر نصي أو ملف مهارة أو إعداد مُرسَل إلى المستودع. وبالنسبة إلى .mcp.json مشترك، أشِر إلى المتغير بدلًا من قيمته:

{
  "mcpServers": {
    "nanobanana": {
      "command": "npx",
      "args": ["-y", "@nanobanana/mcp"],
      "env": { "GEMINI_API_KEY": "${GEMINI_API_KEY}" }
    }
  }
}

نسخ الأمر النصي

يوسّع Claude Code المتغير من الصدفة الخاصة بك عند بدء الخادم، فيستخدم كل عضو في الفريق توكنه الخاص، ويبقى المستودع نظيفًا.

💡 هذه الخوادم مشاريع مجتمعية. npx -y يُنزّل ويشغّل شيفرة بتوكنك في بيئته. افتح المستودع، وتحقّق من المشرف وآخر التحديثات، وثبّت نسخة محددة (@nanobanana/mcp@<version>) قبل أن تثق به.

ابنِ مهارة حوله

يمنح الخادم Claude Code القدرة على الرسم. أما المهارة فتخبره بالطريقة التي تريد بها الرسم. المهارة مجلد يحتوي على ملف SKILL.md، ويُحفظ في .claude/skills/nano-banana/ لمشروع واحد أو في ~/.claude/skills/nano-banana/ لكل المشاريع. يبدأ الملف بترويسة YAML قصيرة تحمل حقلين، هما name وdescription. يقرأ Claude الوصف ليقرر متى تنطبق المهارة، ولا يحمّل المحتوى إلا عندها، لذلك تكلّف المهارة شيئًا يكاد يكون معدومًا إلى أن تحتاج إليها.

ما الذي يوضع داخل SKILL.md

اكتب description كمُحفِّز: "أنشئ الصور أو عدّلها باستخدام خادم Nano Banana MCP. استخدمها عندما يطلب المستخدم صورة بطل أو مصغّرة أو نموذجًا أو رسمًا توضيحيًا." ثم ضع قواعدك في المحتوى:

# Nano Banana image rules

1. Write one prompt before calling the tool: subject, action, setting, camera and lens, lighting, mood.
2. Describe what should be in the frame. Do not list things to avoid.
3. Use 16:9 for hero images and 1:1 for thumbnails.
4. Save files in public/images/ with a kebab-case name that matches the page slug.
5. Generate one image, check it, then ask before making variations.
6. Never request more than 4 images in one turn without confirmation.
7. Add descriptive alt text wherever an image is used.
8. Never print, log, or commit the API token.

نسخ الأمر النصي

القاعدتان 5 و6 هما الأهم. إنهما كابحا التكلفة لديك، والقسم التالي يوضح السبب.

تبدو جلسة حقيقية هكذا: تقول "أضف صورة بطل إلى صفحة الأسعار". يقرأ Claude Code الصفحة، ويحمّل المهارة، ويكتب أمرًا نصيًا واحدًا مفصّلًا، ويستدعي generate_image، ويتسلّم مسارًا، ويحرّر وسم <img> ويضيف إليه النص البديل. تراجع صورة واحدة بدلًا من ثماني صور.

صيغة أمر نصي تعمل

استخدم هذا الترتيب: الموضوع، الفعل، المكان، الإضاءة، الكاميرا، الملمس. على سبيل المثال:

خبّازة تُخرج صينية من خبز العجين المخمّر من فرن حجري، والدقيق يغطي ساعديها، ومطبخ ريفي بأوانٍ نحاسية، وضوء نافذة دافئ من اليسار، وعدسة 50 ملم بفتحة f/2، وعمق ميدان ضحل، وملمس واضح للقشرة، ولون طبيعي.

اجعل أي نص داخل الصورة كلمة أو كلمتين. في التعديلات، اطلب تغييرًا واحدًا في كل تعليمة ("اجعل السماء غائمة")، وافحص النتيجة، ثم اطلب التغيير التالي.

ما الذي يكلّفه فعلًا

نموذج الصور ليس إلا سطرًا واحدًا في فاتورتك. يُحتسب استخدام Claude Code بشكل منفصل عبر باقتك لدى Anthropic أو استخدام API، وتحاسب Google على جانب Gemini.

أسعار الصورة الواحدة حسب النموذج

تسرد متتبعات الأسعار العامة هذه الأرقام اعتبارًا من أكتوبر 2026:

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

ميزانية شهرية لـ 120 صورة

تخيّل مدونة تنشر 20 مقالًا في الشهر بواقع 6 صور لكل مقال:

تفترض هذه الإجماليات أنك تحتفظ بكل صورة. إذا رفضت نصفها، فضاعِف الأرقام. ثلاث عادات تُبقي الرقم منخفضًا:

• ارسم المسودات بأرخص الخيارات، والنهائي بالأعلى جودة. كرّر على النموذج الأصلي أو Lite، ولا تُنشئ إلا الفائز بنسخة Pro.
• شغّل بنظام الدفعات كل ما يمكن أن ينتظر. سعر الدفعات يساوي نصف السعر العادي في المتتبعات المذكورة أعلاه.
• ضع حدًا للحلقة. القاعدتان 5 و6 في مهارتك تمنعان Claude من إنتاج اثنتي عشرة تنويعة غير مطلوبة.

إصلاح المشكلات الشائعة

الخادم يظهر بحالة Failed أو مفقود

نفّذ هذه الخطوات بالترتيب:

1. شغّل claude mcp get nanobanana لترى الأمر والبيئة اللذين خزّنهما Claude Code.
2. شغّل node --version. يحتاج الخادم إلى تثبيت Node حتى يعمل npx.
3. على Windows الأصلي، تأكد من أن الأمر هو cmd /c npx.
4. أعد إضافة الخادم بالعلَم -e قبل الشرطتين المزدوجتين.
5. أعد تشغيل جلسة Claude Code. تُحمَّل الخوادم عند البدء.

الصور تصل لكنها تبدو خاطئة

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

كيف تستخدم Nano Banana على PicassoIA

إذا فضّلت تجاوز التوكن والطرفية، فإن Nano Banana 2 يعمل في متصفحك على Picasso IA. تسرد صفحة النموذج توليدات غير محدودة دون نقاط لكل توليد، ما يجعلها مكانًا مناسبًا لاختبار الأوامر قبل أن تدفع مقابل استدعاءات API. وتستغرق الأمثلة المنفذة على تلك الصفحة نحو 20 إلى 28 ثانية لكل منها، لذا فالتكرار رخيص من حيث الوقت والمال معًا.

Nano Banana 2 خطوة بخطوة

1. افتح صفحة النموذج وانقر داخل مربع الأمر النصي.
2. اكتب المشهد في جمل كاملة: الموضوع، والمكان، والضوء، والعدسة.
3. اختياريًا، ارفع حتى 14 صورة مرجعية لمزج الأساليب أو للحفاظ على ثبات الشخصية.
4. اختر نسبة العرض إلى الارتفاع. الافتراضي هو match_input_image، وتتوفر 15 خيارًا، منها 16:9 و9:16 و4:5 و21:9.
5. اختر الدقة: 1K افتراضيًا، مع توفر 2K و4K. الإعدادات الأعلى تستغرق وقتًا أطول.
6. اختر مخرجات jpg أو png.
7. فعّل تأسيس Google Search أو Image Search عندما ينبغي أن تعكس الصورة أحداثًا جارية أو أماكن حقيقية.
8. وَلِّد الصورة، ثم حسّنها بكتابة متابعة مثل "اجعل الخلفية غائمة" بدلًا من إعادة كتابة الأمر كله.

متى تختار Pro

يقبل Nano Banana Pro أيضًا 14 صورة مرجعية، ويُخرج بدقة 1K أو 2K (وهي الافتراضية) أو 4K، ويضيف إعداد safety_filter_level. تسرد صفحته أنه مجاني للاستخدام، وتراوحت مدة أمثلته بين 18 و113 ثانية، لذا توقّع أنه أبطأ. الجأ إليه عندما تحتاج صورة البطل النهائية إلى أقصى قدر من التفاصيل، واستخدم Nano Banana للتعديلات السريعة.

يمكن تفويض كتابة الأوامر أيضًا. يستطيع نموذج محادثة مثل Claude Sonnet 5 تحويل فكرة أولية إلى الموضوع والفعل وصيغة الإضاءة، بينما يناسب Claude Opus 4.7 المهام الأطول. وعندما ينبغي أن يتحرك المشهد، صِف الحركة لمقطع قصير في Veo 3.1 Fast أو Gemini Omni 1.1.

جرّب أول صورة لك اليوم

لديك الآن الحلقة كاملة: توكن، وأمر واحد من claude mcp add، ومهارة تحافظ على اتساق الأوامر، وميزانية يمكنك الدفاع عنها. أسرع طريقة لتلمس الفرق بين النماذج هي تشغيل الأمر النصي نفسه على كل واحد منها.

افتح Picasso IA، واختر Nano Banana 2، والصق أمر الخبّازة من أعلاه. ثم غيّر تفصيلة واحدة، كالعدسة أو الضوء، وولّد من جديد. عشر دقائق من ذلك ستعلّم ملف مهارتك أكثر من أي دليل إرشادي. ابدأ بمشهد واحد تحتاجه فعلًا هذا الأسبوع، وانطلق منه.