للمطورين
خادم MCP لـ Nano Banana Pro
اجعلوا مساعدًا ذكيًا ينشئ الصور والفيديو نيابةً عنكم. أضيفوا خادمًا واحدًا إلى Claude أو Cursor أو أي عميل آخر يدعم Model Context Protocol، ثم صِفوا ما تحتاجون إليه بكلمات بسيطة.
الربط في ثلاث خطوات
عنوان الخادم
https://www.bananapro.site/api/mcp- 01
أنشئوا مفتاح API
افتحوا صفحة مفاتيح API وأنشئوا مفتاحًا. يعمل المساعد بهذا المفتاح، لذا تُخصم تكلفة كل عملية إنشاء من رصيد حسابكم.
فتح مفاتيح API - 02
أضيفوا الخادم إلى العميل
زوّدوا العميل بعنوان الخادم أعلاه وأرسلوا المفتاح بوصفه رمز Bearer. تجدون أدناه إعدادات جاهزة للعملاء الشائعين.
- 03
اطلبوا ما تحتاجون إليه
مثال: «أنشئ صورة منتج بنسبة 16:9 لكوب خزفي باستخدام Nano Banana Pro». يختار المساعد الأداة المناسبة، ويبدأ المهمة، ويعيد رابط النتيجة.
إعدادات العملاء
استبدلوا YOUR_API_KEY بالمفتاح الذي أنشأتموه. أبقوا المفتاح سريًا، فكل من يملكه يستطيع استهلاك رصيدكم.
Claude Code (يُنفَّذ في الطرفية)
claude mcp add --transport http bananapro https://www.bananapro.site/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Cursor والعملاء الآخرون الذين يقرؤون إعدادات بصيغة JSON
{
"mcpServers": {
"bananapro": {
"url": "https://www.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}يستقبل الخادم الطلبات عبر HTTP ويرد على كل استدعاء مباشرة. تسجيل الدخول عبر المتصفح غير متاح، والوصول يتم بمفتاح API فقط.
ما الذي يستطيع المساعد فعله
يوفّر الخادم ست أدوات. أربع منها تقرأ المعلومات فقط ولا تستهلك رصيدًا، واثنتان تبدآن عملية إنشاء وتستهلكان رصيدًا.
| الأداة | وظيفتها | تستهلك رصيدًا |
|---|---|---|
| list_models | تعرض النماذج المتاحة لحسابكم للصور والفيديو، وأنواع الطلبات التي يقبلها كل نموذج. | لا |
| get_balance | تعرض الرصيد المتبقي في الحساب. | لا |
| generate_image | تبدأ إنشاء صورة أو تعديل صورة انطلاقًا من وصف نصي وصور مرجعية اختيارية. | نعم |
| generate_video | تبدأ إنشاء فيديو انطلاقًا من وصف نصي أو صور أو وسائط مرجعية أخرى. | نعم |
| get_task | تتحقق من حالة عملية إنشاء وتعيد روابط النتيجة عند اكتمالها. | لا |
| list_tasks | تعرض أحدث عمليات الإنشاء، وهي مفيدة عند فقدان معرّف المهمة. | لا |
أسئلة حول خادم MCP
كم تبلغ تكلفة الإنشاء عبر MCP؟
التكلفة نفسها عبر API. يُنفّذ استدعاء الأداة طلب API المقابل بمفتاحكم، ويُخصم الرصيد من حسابكم. وتُعاد تكلفة المهمة الفاشلة بالطريقة نفسها.
ما النماذج التي يستطيع المساعد استخدامها؟
كل نموذج تتيحه API لحسابكم. تعيد الأداة list_models القائمة الحالية، فلا يعتمد المساعد على جدول ثابت.
هل أستطيع استخدام صوري أو مقاطعي كمراجع؟
نعم، عبر روابط https عامة. لا يقبل الخادم رفع الملفات؛ استضيفوا الملف في مكان يمكن الوصول إليه ومرّروا عنوانه.
أين تُحفظ النتائج؟
يعيد المساعد روابط النتائج في المحادثة. وتظهر المهام نفسها في list_tasks، كما أنها متاحة عبر API.
كيف أمنع مساعدًا من استخدام حسابي؟
احذفوا مفتاح API من صفحة مفاتيح API. تُرفض الاستدعاءات بهذا المفتاح من تلك اللحظة.
هل تفضّلون استدعاء API بأنفسكم؟
بُني خادم MCP على API العامة. ويسرد التوثيق كل نقطة وصول ومعامل ونموذج.