Gemini CLI میں امیج جنریشن: MCP سرور سیٹ اپ

Gemini CLI گوگل کا اوپن سورس ٹرمینل ایجنٹ ہے، اور MCP وہ پروٹوکول ہے جس کے ذریعے یہ بیرونی ٹولز تک رسائی حاصل کرتا ہے۔ اسے ریموٹ MCP سرور سے جوڑیں، اور وہی چیٹ سیشن جو آپ کا کوڈ ایڈٹ کرتا ہے، تصاویر، ویڈیوز اور آواز بھی تیار کر سکتا ہے اور فائلیں براہ راست آپ کی ورکنگ ڈائرکٹری میں محفوظ کر سکتا ہے۔

فوری جواب: gemini mcp add --transport http --scope user bananabanana https://bananabanana.pro/api/mcp -H "Authorization: Bearer $BB_KEY" کمانڈ چلائیں، CLI کے پوچھنے پر فولڈر پر بھروسے کی تصدیق کریں، پھر gemini mcp list چلا کر سبز رنگ میں Connected اسٹیٹس دیکھیں۔ تصاویر کی قیمت فی جنریشن $0.03 سے شروع ہوتی ہے جو آپ کے اکاؤنٹ بیلنس سے کٹتی ہے۔

نیچے دی گئی تمام معلومات کی جانچ 17 اگست 2026 کو Gemini CLI 0.55.1 اور ایک فعال bb_live_… کی کے ساتھ کی گئی ہے۔ جہاں آفیشل دستاویزات اور CLI کے اصل رویے میں فرق ہے، وہاں واضح طور پر بتا دیا گیا ہے۔

آسان سیٹ اپ

صرف دو کمانڈز۔ پہلی کمانڈ سرور کو رجسٹر کرتی ہے:

export BB_KEY=bb_live_…   # create one at https://bananabanana.pro/profile
 
gemini mcp add --transport http --scope user \
  bananabanana https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer $BB_KEY"

دوسری کمانڈ کنکشن کی تصدیق کرتی ہے:

gemini mcp list
# ✓ bananabanana: https://bananabanana.pro/api/mcp (http) - Connected

اگر آپ کو Connected کے بجائے Disabled نظر آئے تو کچھ بھی تبدیل کرنے سے پہلے اگلا حصہ پڑھیں۔ اس معمولی نکتے کو سمجھنے میں مجھے پانچ منٹ لگے۔

پانچ اہم نکات جو دستاویزات میں درج نہیں ہیں

فولڈر ٹرسٹ ہر چیز کو خاموشی سے غیر فعال کر دیتا ہے۔ اگر آپ ایسی ڈائرکٹری میں gemini mcp list چلاتے ہیں جس پر CLI بھروسہ نہیں کرتا، تو یہ پیغام آتا ہے:

Warning: MCP servers are configured but disabled because this folder is untrusted.
User-level servers are also suppressed in untrusted folders to prevent accidental side-effects.

○ bananabanana: https://bananabanana.pro/api/mcp (http) - Disabled

دوسری سطر پر غور کریں: یہاں تک کہ --scope user والا سرور بھی بند رہتا ہے۔ CLI پہلی بار انٹرایکٹو لانچ پر فولڈر ٹرسٹ کی تصدیق مانگتا ہے؛ آٹومیشن اسکرپٹس کے لیے یہ فیصلہ ~/.gemini/trustedFolders.json میں پاتھ اور TRUST_FOLDER کی میپنگ کے طور پر محفوظ ہوتا ہے۔ یہ حفاظتی لحاظ سے مناسب ہے لیکن خرابی کا پیغام الجھن پیدا کرتا ہے کیونکہ "Disabled" سے فولڈر کی وجہ کا واضح پتہ نہیں چلتا۔

gemini mcp add کمانڈ httpUrl کے بجائے url لکھتی ہے۔ دستاویزات Streamable HTTP کے لیے httpUrl بتاتی ہیں۔ لیکن CLI 0.55.1 نے حقیقت میں یہ کنفیگریشن بنائی:

{
  "mcpServers": {
    "bananabanana": {
      "url": "https://bananabanana.pro/api/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer $BB_KEY" }
    }
  }
}

دونوں فارمیٹس درست طریقے سے جڑتے ہیں۔ لیکن اگر آپ دستاویزات کی مثال سے موازنہ کریں گے تو غلطی کا گمان ہو سکتا ہے۔ دونوں ہی کام کرتے ہیں۔

پہلے سے طے شدہ اسکوپ project ہے، اور آپ کی کی وہاں درج ہو جاتی ہے۔ اگر آپ --scope user چھوڑ دیتے ہیں تو کی آپ کے ریپوزیٹری کے اندر .gemini/settings.json میں چلی جاتی ہے۔ ایک سادہ git add . کے بعد وہ کمٹ ہسٹری میں چلی جائے گی۔ ہمیشہ --scope user کا استعمال کریں یا انوائرنمنٹ ویری ایبل کے ذریعے کی فراہم کریں۔

$BB_KEY متغیر کی تبدیلی کام کرتی ہے، لیکن ناکامی پر خاموش رہتی ہے۔ متغیر ایکسپورٹ ہونے پر اسٹیٹس Connected آتا ہے۔ اگر بغیر ایکسپورٹ کیے نیا ٹرمینل کھولیں تو وہی کنفیگریشن تصدیقی خرابی دینے کے بجائے Disconnected دکھاتی ہے۔ اس کمانڈ کو اپنی شیل پروفائل میں شامل کرنا مفید ہے۔

Gemini CLI باقاعدگی سے SSE چیک کرتا ہے اور 405 حاصل کرتا ہے۔ سرور لاگز کے مطابق تسلسل یوں رہا: POST initialize (200)، اور POST notification (202)، اور GET /api/mcp (405)، اور POST tools/list (200)۔ یہ GET درخواست دراصل اسٹیٹ لیس سرور پر Server-Sent Events چینل کھولنے کی کوشش ہے۔ 405 ملنے پر بھی CLI بغیر کسی مسئلے کے کام جاری رکھتا ہے۔ اگر آپ اپنا MCP سرور چلا رہے ہیں تو اس 405 کی پرواہ نہ کریں۔

دستیاب ٹولز اور ان کے اخراجات

سیشن میں کل نو ٹولز دستیاب ہوتے ہیں، جو کہ ٹول ریفرنس کے مطابق ہیں۔ چار ٹولز کال کرنے کے لیے بالکل مفت ہیں: list_models، get_account، get_result، list_generations۔ باقی ٹولز کے لیے فی جنریشن آپ کے اکاؤنٹ بیلنس سے کٹوتی کی جاتی ہے۔

ویڈیو اور متعدد تصاویر کی درخواستوں پر پہلے قیمت کا تخمینہ ملتا ہے۔ ایجنٹ کو حتمی قیمت معلوم ہوتی ہے، پہلے سے کچھ چارج نہیں ہوتا، اور تصدیق کے بعد ہی کام شروع ہوتا ہے۔ مواد فلٹر کی رکاوٹوں اور اپ اسٹریم ناکامیوں کی صورت میں بیلنس خودکار طور پر واپس کر دیا جاتا ہے۔

بیلنس ریچارج پر بونس ملتا ہے: $50 سے زائد پر 5%، $100 سے زائد پر 10%، اور فعال پرومو کوڈ کے ساتھ ڈپازٹ کا مزید 10% ملتا ہے۔ پرومو کوڈ کے ساتھ $100 ڈپازٹ کرنے پر $120 کا بیلنس شامل ہوتا ہے۔

Gemini سے Nano Banana کی تصاویر بنوانا: اس کا کیا فائدہ ہے؟

Gemini CLI کا کسی تیسرے سرور کے ذریعے Gemini امیج ماڈل سے رابطہ کرنا بظاہر طویل راستہ معلوم ہو سکتا ہے۔ براہ راست طریقہ بھی موجود ہے: Google Cloud بلنگ اکاؤنٹ بنائیں، ماڈل API فعال کریں، اسناد تیار کریں اور علاقائی کوٹہ سنبھالیں۔ اگر آپ کا کام بنیادی کلاؤڈ انفراسٹرکچر بنانا ہے تو یہ بہترین ہے۔

لیکن ہماری سروس دوسری ضرورت پوری کرتی ہے: ایک بیئرر ٹوکن، پری پیڈ بیلنس، کوئی کلاؤڈ بلنگ اکاؤنٹ نہیں، کوٹہ کی درخواستیں نہیں، اور علاقائی پابندیاں نہیں۔ اسی کنکشن سے آپ کو Veo اور Omni کے ویڈیو ماڈلز اور TTS آواز بھی فی جنریشن قیمت پر ملتے ہیں۔ اگر آپ کا مقصد پلیٹ فارم سنبھالنے کے بجائے تخلیق کرنا ہے تو یہ زیادہ عملی طریقہ ہے۔

بہت بڑے پیمانے پر کلاؤڈ کا براہ راست استعمال زیادہ سستا پڑے گا۔ لیکن ہمارا راستہ دو منٹ میں کام شروع کرنے کی سہولت دیتا ہے اور غیر متوقع بلوں کے خطرے سے بچاتا ہے۔

اگر آپ دیگر ایڈیٹرز استعمال کرتے ہیں تو یہی سرور اسی API کی کے ساتھ Claude Code، Cursor اور Codex میں بھی کنفیگر ہو جاتا ہے۔

عملی مثال: دستاویزات کے لیے تصاویر بنانا

ایک حقیقی اور موثر مثال: ایک ریپوزیٹری جس میں docs/ فولڈر کے اندر بارہ صفحات ہیں، اور ہر صفحے کے لیے ایک ہی انداز کی ہیڈر تصویر درکار ہے۔

سیشن میں دیا گیا پرامپٹ:

Read every heading in docs/*.md. For each file, generate a 16:9 illustration matching the page topic, in this style: editorial illustration, pastel paper background, dark ink details, violet and amber accents, no text. Use nano-banana-pro. Save each as docs/img/.png and add the image reference under the page title.

ایجنٹ فائلیں پڑھتا ہے، ہر صفحے کے لیے generate_image کو کال کرتا ہے، get_result کے ذریعے انتظار کرتا ہے، فائلیں ڈاؤن لوڈ کرتا ہے اور مارک ڈاؤن فائلز میں لنک شامل کرتا ہے۔ $0.11 کے حساب سے بارہ تصاویر کی کل لاگت $1.32 بنتی ہے اور یہ سارا کام کافی پینے کے دوران مکمل ہو جاتا ہے۔ اس مضمون کی تمام تصاویر اسی طریقے سے Nano Banana Pro پر ایک ہی اسٹائل پرامپٹ کے تحت بنائی گئی ہیں۔

کام شروع کرنے سے پہلے دو مشورے: اسٹائل چیک کرنے کے لیے پہلے ایک ٹیسٹ تصویر بنائیں (12 فائلوں پر غلط پرامپٹ رن کرنے سے $1.32 ضائع ہوں گے)، اور --trust کو غیر فعال رکھیں تاکہ ہر پیڈ ٹول کال پر تصدیق سے ایجنٹ کسی غلط لوپ میں نہ پھنسے۔

کیا API کی کے بجائے OAuth کام کرتا ہے؟

Gemini CLI ریموٹ MCP سرورز کے لیے OAuth 2.0 (ڈسکوری اور /mcp auth کمانڈ کے ساتھ) سپورٹ فراہم کرتا ہے۔ ہمارا سرور مکمل OAuth 2.1 آتھرائزیشن سرور ہے (ڈائنامک کلائنٹ رجسٹریشن، PKCE S256، RFC 9728 ڈسکوری)، اور Claude Code اور claude.ai جیسے کلائنٹس بغیر مینوئل کی کے لاگ ان ہو سکتے ہیں۔

API کی کا طریقہ مکمل ٹیسٹ شدہ اور مستحکم ہے۔ Gemini CLI کے ذریعے OAuth کے عمل کی اس سیشن میں الگ سے تصدیق نہیں کی گئی ہے، اس لیے اسے ممکنہ آپشن کے طور پر دیکھیں۔ API کی بنانا صرف دس سیکنڈ کا کام ہے اور یہ مستقل فعال رہتی ہے۔

عام سوالات

سیٹنگز فائل کہاں واقع ہے؟

یوزر اسکوپ کے لیے ~/.gemini/settings.json، اور پروجیکٹ اسکوپ کے لیے .gemini/settings.json۔ gemini mcp add --scope user کمانڈ پہلی والی فائل میں لکھتی ہے۔

سرور Disabled کیوں نظر آتا ہے؟

فولڈر قابل اعتماد فہرست میں شامل نہیں ہے۔ اسٹارٹ اپ پر فولڈر کو ٹرسٹ کریں یا ~/.gemini/trustedFolders.json میں پاتھ کو TRUST_FOLDER ویلیو کے ساتھ شامل کریں۔ یوزر اسکوپ سرورز بھی غیر معتبر فولڈرز میں بند ہو جاتے ہیں۔

کیا میں ماڈل کو نظر آنے والے ٹولز کو محدود کر سکتا ہوں؟

جی ہاں۔ gemini mcp add کے ساتھ --include-tools اور --exclude-tools یا سیٹنگز میں includeTools / excludeTools استعمال کریں۔ استثنیٰ کے قواعد کو شمولیت پر ترجیح دی جاتی ہے۔

کیا یہ ٹیم کے ساتھ شیئر کردہ پروجیکٹ میں کام کرتا ہے؟

سرور کو پروجیکٹ اسکوپ میں رکھیں اور کی کو انوائرنمنٹ ویری ایبل میں سیٹ کریں، فائل میں براہ راست نہ لکھیں۔ ہر ڈویلپر اپنی کی کے ساتھ export BB_KEY=… چلائے گا اور گٹ ہسٹری صاف رہے گی۔

اگر جنریشن ناکام ہو جائے تو کیا ہوتا ہے؟

مواد فلٹر کی پابندیوں سمیت پورا معاوضہ خودکار طور پر بیلنس میں واپس آ جاتا ہے۔ اگر پرامپٹ کی زبان نازک ہے تو دوبارہ کوشش کرنا کارآمد ہے کیونکہ سیکیورٹی چیک حتمی پکسلز پر ہوتا ہے اور دوسری بار ایک نئی تصویر بنتی ہے۔

کیا آپ انٹرفیس کے ذریعے کام کرنا پسند کرتے ہیں؟ ویب جنریٹر انہی ماڈلز کو اسی بیلنس پر چلاتا ہے۔ ٹرمینل میں جڑنے کے بعد سب سے پہلے list_models کال کریں: یہ مفت ہے، موجودہ قیمتیں دکھاتا ہے اور رقم خرچ کیے بغیر کنکشن کی تصدیق کرتا ہے۔