Claude Code के लिए इमेज जनरेशन MCP: सेटअप और सबसे अच्छे सर्वर

Claude Code कुछ मिनटों में लैंडिंग पेज बना सकता है, पर उसके हीरो इमेज नहीं बना सकता। बैनर, प्रोडक्ट मॉकअप या ब्लॉग थंबनेल माँगें तो आपको SVG कोड, एक प्लेसहोल्डर पाथ या "मैं इमेज नहीं बना सकता" मिलता है। इमेज जनरेशन MCP सर्वर यह कमी पूरी करता है। एक बार रजिस्टर होने पर Claude Code इमेज मॉडल को एक टूल की तरह कॉल करता है, फ़ाइल आपके रेपो के अंदर सेव करता है, और उसे उसी HTML या markdown से जोड़ देता है जिसे वह पहले से एडिट कर रहा है, यह सब एक ही सेशन में।

यह लेख दिखाता है कि ये हिस्से कैसे जुड़ते हैं, सर्वर रजिस्टर करने के सटीक कमांड, उन विकल्पों की साइड-बाय-साइड तुलना जिन्हें लोग असल में इस्तेमाल करते हैं, और इमेज व वीडियो दोनों के लिए PicassoIA का कनेक्टर कैसे जोड़ें। कमांड Claude Code के मौजूदा डॉक्यूमेंटेशन के अनुसार हैं। जो मैं पक्का नहीं कर सका, जैसे कोई निजी सर्वर URL, उसे अनुमान लगाने के बजाय प्लेसहोल्डर के रूप में दिखाया गया है।

Claude Code को इमेज टूल की ज़रूरत क्यों है

सिर्फ़ टेक्स्ट वाले एजेंट की कमी

Claude Code आपके टर्मिनल में काम करता है, आपकी फ़ाइलें पढ़ता है, कमांड चलाता है और कोड एडिट करता है। यह लूप तब तक तेज़ रहता है जब तक पहला <img> टैग नहीं आता। तब आपको सेशन छोड़कर अलग जनरेटर खोलना पड़ता है, फ़ाइल डाउनलोड करनी पड़ती है, नाम बदलना पड़ता है, सही फ़ोल्डर में डालनी पड़ती है और पाथ वापस पेस्ट करना पड़ता है। हर चरण फ़्लो तोड़ देता है, और आपका लिखा प्रॉम्प्ट उस पेज तक कभी नहीं पहुँचता जिसके लिए वह बना था।

MCP लेयर क्या जोड़ती है

MCP, Model Context Protocol, एक ओपन स्टैंडर्ड है जो AI क्लाइंट को बाहरी टूल कॉल करने देता है। इमेज सर्वर एक या अधिक टूल दिखाता है, आमतौर पर कुछ ऐसा generate_image, और Claude Code उन्हें एक अनुमानित नाम से सूचीबद्ध करता है: mcp__<server-name>__<tool-name>। image-gen नाम का सर्वर जिसमें generate_image टूल है, mcp__image-gen__generate_image के रूप में दिखता है।

इसके बाद एक ही अनुरोध पूरा काम कर देता है:

• Claude Code पेज पढ़ता है और उसके अनुकूल इमेज प्रॉम्प्ट लिखता है
• सर्वर प्रॉम्प्ट को एक मॉडल प्रोवाइडर को भेजता है
• फ़ाइल आपके प्रोजेक्ट फ़ोल्डर में आ जाती है, या एक URL वापस आता है
• Claude Code मार्कअप एडिट करता है ताकि वह इमेज की ओर इशारा करे और alt टेक्स्ट लिखे

💡 टिप: सर्वर का नाम छोटा और lowercase रखें। यह हर टूल कॉल और परमिशन प्रॉम्पट में दिखता है, और image-gen एक लंबे प्रोडक्ट नाम से ज़्यादा पढ़ने में आसान है।

कनेक्शन कैसे काम करता है

क्लाइंट, सर्वर, प्रोवाइडर

इसमें तीन हिस्से शामिल हैं, और इन्हें आपस में मिला देना ही ज़्यादातर सेटअप उलझन की वजह है।

सर्वर एक अनुवादक है। वह Claude Code से टूल कॉल लेता है, उसे ऐसे अनुरोध में बदलता है जिसे प्रोवाइडर स्वीकार करे, और नतीजा वापस देता है। Claude Code चार ट्रांसपोर्ट सपोर्ट करता है: stdio, http, sse, और ws। व्यवहार में आप दो में से चुनते हैं। stdio आपकी मशीन पर एक लोकल प्रोसेस शुरू करता है, आमतौर पर npx के ज़रिए। http किसी रिमोट URL की ओर इशारा करता है जिसे कोई और चलाता है।

इमेज कहाँ सेव होती है

सर्वर आउटपुट दो तरीकों से संभालते हैं, और यह फ़र्क मायने रखता है। कुछ फ़ाइल को डिस्क पर सेव करते हैं और पाथ लौटाते हैं। mcp-image आपके सेट किए गए फ़ोल्डर में लिखता है, और create-image-mcp base64 डेटा के बजाय फ़ाइल मेटाडेटा लौटाता है। दूसरे URL या इनलाइन इमेज डेटा लौटाते हैं।

Claude Code के डॉक्यूमेंटेशन के अनुसार टूल रिज़ल्ट में इमेज MAX_MCP_OUTPUT_TOKENS लिमिट में गिनी जाती हैं। 10,000 टोकन पर चेतावनी दिखती है और डिफ़ॉल्ट सीमा 25,000 है। जो सर्वर छोटा पाथ या URL लौटाता है वह उस रेखा से काफ़ी नीचे रहता है। जो बड़ी इनलाइन इमेज लौटाता है, वह जल्दी उस सीमा तक पहुँच सकता है।

पाँच चरणों में सेटअप

1. Claude Code इंस्टॉल करें और claude --version से पुष्टि करें कि वह चलता है।
2. किसी इमेज प्रोवाइडर के साथ अकाउंट बनाएँ और उसकी दी हुई एक्सेस क्रेडेंशियल कॉपी करें।
3. claude mcp add से सर्वर रजिस्टर करें।
4. एक स्कोप चुनें: local, project, या user।
5. claude mcp list से कनेक्शन की पुष्टि करें।

सर्वर रजिस्टर करें

एक लोकल stdio सर्वर के लिए ढाँचा यह है:

claude mcp add --transport stdio --env <PROVIDER_VARIABLE>=<your-credential> --env IMAGE_OUTPUT_DIR=/absolute/path/to/public/images image-gen -- npx -y mcp-image

प्रॉम्प्ट कॉपी करें

-- से पहले का सब कुछ Claude Code का है। उसके बाद का सब कुछ बिना बदले सर्वर को जाता है। -- भूल गए तो CLI सर्वर के फ़्लैग्स को अपने ही फ़्लैग्स समझने की कोशिश करेगा। सटीक environment variable का नाम सर्वर के README से लें, क्योंकि हर प्रोवाइडर का अपना नाम होता है।

होस्ट किए गए सर्वर के लिए ट्रांसपोर्ट http पर बदलें:

claude mcp add --transport http image-gen <server-url> --header "Authorization: Bearer <your-credential>"

प्रॉम्प्ट कॉपी करें

⚠️ Windows उपयोगकर्ता: नेटिव Windows पर (WSL के बाहर) npx से लॉन्च किए गए सर्वरों को एक wrapper चाहिए: claude mcp add --transport stdio image-gen -- cmd /c npx -y mcp-image। इसके बिना सर्वर शुरू होने में विफल हो सकता है।

स्कोप चुनें

कमांड में --scope project या --scope user जोड़ें। जब एक ही नाम कई स्कोप में मौजूद हो, तो local, project पर भारी पड़ता है, और project, user पर।

प्रोजेक्ट स्कोप इमेज वर्क के लिए ठीक है क्योंकि पूरी टीम को एक ही सेटअप मिलता है। पर क्रेडेंशियल कमिट न करें। .mcp.json ${VAR} विस्तार को command, args, env, url, और headers में सपोर्ट करता है, इसलिए फ़ाइल में सिर्फ़ एक संदर्भ रहता है और हर डेवलपर अपने shell से मान देता है:

{
  "mcpServers": {
    "image-gen": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-image"],
      "env": {
        "IMAGE_OUTPUT_DIR": "${IMAGE_OUTPUT_DIR}",
        "<PROVIDER_VARIABLE>": "${<PROVIDER_VARIABLE>}"
      }
    }
  }
}

प्रॉम्प्ट कॉपी करें

Claude Code प्रोजेक्ट के .mcp.json से सर्वर चलाने से पहले अनुमति माँगता है, इसलिए किसी टीममेट के पहले सेशन में वह pending approval स्टेटस दिखाएगा, जब तक टीममेट उसे मंज़ूरी न दे।

कनेक्शन जाँचें

claude mcp list चलाएँ। हर सर्वर को एक स्टेटस मिलता है: जुड़ा हुआ, कनेक्ट नहीं हो पाया, प्रमाणीकरण की ज़रूरत है, या मंज़ूरी बाकी है। claude mcp get image-gen किसी एक सर्वर का विवरण दिखाता है। सेशन के अंदर /mcp वही पैनल खोलता है, और /mcp reconnect all किसी भी विफल सर्वर को दोबारा कनेक्ट करने की कोशिश करता है।

फिर एक छोटे अनुरोध से जाँचें: "एक लकड़ी की मेज़ पर सिरेमिक मग की एक 16:9 इमेज बनाएँ और उसे public/images/test.jpg में सेव करो।" अगर टूल कॉल mcp__image-gen__generate_image के रूप में दिखे और फ़ोल्डर में फ़ाइल आ जाए, तो सर्वर काम कर रहा है।

सबसे अच्छे सर्वरों की तुलना

नीचे की तालिका हर प्रोजेक्ट की अपनी लिस्टिंग से है, इसलिए इंस्टॉल करने से पहले मौजूदा विकल्पों के लिए README देख लें। मैंने इनकी इमेज क्वालिटी का बेंचमार्क नहीं किया है, क्योंकि क्वालिटी सर्वर से ज़्यादा उस मॉडल पर निर्भर करती है जो उसके पीछे है।

अपने खुद चलाने वाले लोकल सर्वर

mcp-image एक ही generate_image टूल देता है जो text-to-image और इनपुट इमेज से एडिटिंग संभालता है। इसमें तेज़, संतुलित और क्वालिटी प्रीसेट हैं, और 21:9 तक के आस्पेक्ट रेशियो मिलते हैं। आप जो भी प्रोवाइडर चुनें उसके लिए एक क्रेडेंशियल सेट करते हैं, साथ में एक absolute आउटपुट फ़ोल्डर।

create-image-mcp सिर्फ़ OpenAI के लिए है। इसका create_image टूल 4K तक साइज़, क्वालिटी सेटिंग्स, ट्रांसपेरेंसी, प्रति कॉल कई वैरिएशन, और इनपेंटिंग के लिए मास्क सपोर्ट करता है। यह डिस्क पर सेव करता है और पाथ के साथ जवाब देता है, जिससे टोकन खर्च कम रहता है।

Replicate कम्युनिटी सर्वर जैसे mcp-server-replicate Replicate पर जो भी होस्ट है उस पर text-to-image, image-to-image और एडिटिंग देते हैं, और उनमें से एक एक बार में 5 इमेज तक प्रोसेस करता है। जब आप बार-बार मॉडल बदलना चाहें तो यह रास्ता चुनें।

हर लोकल सर्वर की एक कमी यह है कि देखरेख आपकी ज़िम्मेदारी है। Node या Python वर्ज़न आपको संभालने होते हैं, प्रोवाइडर का भुगतान सीधे करना होता है, और पैकेज खुद अपडेट करना होता है।

होस्ट किए गए सर्वर और कनेक्टर

होस्ट किया गया सर्वर इंस्टॉल का चरण हटा देता है। आप एक URL और एक क्रेडेंशियल जोड़ते हैं, और बाकी सब प्रोवाइडर चलाता है। Claude Code टूटे रिमोट कनेक्शन को बढ़ते अंतराल के साथ पाँच बार तक दोबारा कोशिश करता है, इसलिए छोटे आउटेज आपकी मदद के बिना ठीक हो जाते हैं। कीमत यह है कि आप किसी और के अपटाइम और प्लान के नियमों पर निर्भर हैं।

जब आप claude.ai अकाउंट से साइन इन करते हैं, तो Claude Code उस अकाउंट के कनेक्टर भी लोड करता है। ये सबसे कम प्राथमिकता पर रहते हैं, लोकल, प्रोजेक्ट और user सर्वरों के नीचे, और ENABLE_CLAUDEAI_MCP_SERVERS=false सेट करने पर ये बंद हो जाते हैं।

Claude Code से PicassoIA का उपयोग

PicassoIA एक ही कनेक्टर के पीछे इमेज जनरेशन, एडिटिंग और वीडियो देता है, जो ऐसे प्रोजेक्ट के लिए ठीक है जिन्हें एक स्टिल इमेज और उससे मेल खाती एक छोटी क्लिप चाहिए।

कनेक्टर क्या दिखाता है

PicassoIA कनेक्टर नौ टूल देता है: generate_image, edit_image, generate_video_picassoia, generate_video_seedance, get_generation, list_generations, list_models, get_account, और cancel_generation।

जनरेशन असिंक्रोनस है। जनरेट कॉल, जैसे ही कोई GPU जॉब स्वीकार करता है, एक predict_id लौटाता है, और get_generation तब तक स्टेटस बताता है जब तक वह succeeded या failed न पढ़े। एक बार आप नतीजा माँगते हैं, तो Claude Code उस पोलिंग लूप को आपके लिए चलाता है।

इसके पीछे का डेवलपर API Replicate-शैली के डिज़ाइन का पालन करता है। बेस URL https://api.picassoia.com/v1 है, ऑथेंटिकेशन एक Bearer secret है जो pia_sk_ से शुरू होता है, और मुख्य एंडपॉइंट POST /v1/models/{owner}/{name}/predictions और GET /v1/predictions/{id} हैं। इन सीमाओं को ध्यान में रखकर योजना बनाएँ:

• प्रति अकाउंट 5 एक साथ चलने वाले प्रेडिक्शन, जो हर secret और MCP कनेक्शन में साझा होते हैं
• हर प्रॉम्प्ट में 4,000 अक्षर
• हर रिक्वेस्ट बॉडी में 10 MB
• प्रेडिक्शन के टाइम आउट होने से पहले 3 घंटे

💡 पहले अपना प्लान जाँचें। PicassoIA अपने pricing पेज पर API और MCP एक्सेस की जानकारी देता है, और विवरण प्लान के अनुसार अलग हो सकते हैं। किसी वर्कफ़्लो को इसके इर्द-गिर्द बनाने से पहले पक्का करें कि आपके प्लान में यह शामिल है।

कौन सा मॉडल चुनें

PicassoIA के बड़े कैटलॉग में और भी कई इमेज मॉडल हैं, जिनमें GPT Image 2, Seedream 5 Lite, Flux 2 Pro, और Nano Banana 2 शामिल हैं। पहले वेब ऐप में एक प्रॉम्प्ट आज़माएँ, वह लुक चुनें जो आपको पसंद हो, फिर Claude Code से उसे दोबारा बनाने को कहें।

टेक्स्ट वाले काम के लिए, उसी कैटलॉग में Claude Sonnet 5 और Claude Opus 4.7 भी हैं, जो प्रॉम्प्ट के वैरिएशन ड्राफ़्ट करने के लिए काम के हैं, सेशन में पेस्ट करने से पहले।

लूप में वीडियो जोड़ना

एक स्टिल इमेज और एक छोटी क्लिप अक्सर साथ चलती हैं, जैसे हीरो फ़ोटो और एक लूपिंग बैनर। Claude Code से PicassoIA Image से स्टिल बनवाएँ, फिर नतीजा किसी वीडियो टूल को शुरुआती फ़्रेम के रूप में दें। एक समय में एक वीडियो चलाएँ, क्योंकि हर जॉब आपके पाँच concurrent स्लॉट में से एक हिस्सा लेता है।

PicassoIA Image कैसे उपयोग करें

1. एक्सेस जाँचें। अपना PicassoIA अकाउंट खोलें और अपने प्लान पर API और MCP एक्सेस की पुष्टि करें।
2. कनेक्ट करें। अपने claude.ai अकाउंट में PicassoIA कनेक्टर जोड़ें, या picassoia.com/en/mcp/accounts पर अपने अकाउंट के MCP connections पेज से URL लेकर http सर्वर रजिस्टर करें। PicassoIA वह URL अपने सार्वजनिक पेजों पर प्रकाशित नहीं करता, इसलिए उसे अपने अकाउंट से कॉपी करें।
3. सत्यापित करें। claude mcp list चलाएँ, या सेशन में /mcp टाइप करें, और पुष्टि करें कि PicassoIA कनेक्टेड दिख रहा है।
4. मॉडल सूची देखें। पूछें: "मेरा अकाउंट कौन से PicassoIA मॉडल इस्तेमाल कर सकता है?" Claude Code list_models कॉल करता है।
5. जनरेट करें। इमेज के लिए साइज़ और गंतव्य के साथ पूछें, उदाहरण के लिए "सुबह की रोशनी में एक अखरोट की मेज़ की 16:9 हीरो इमेज, इसे public/images/hero.jpg के नाम से सेव करो।"
6. डाउनलोड करें। Claude Code get_generation को पोल करता है, फिर रिज़ल्ट URL से फ़ाइल आपके फ़ोल्डर में लाता है और मार्कअप अपडेट करता है।
7. रिफ़ाइन करें। सेव की गई फ़ाइल को टोन और डिटेल में बदलाव के लिए PicassoIA Image Editor Pro के साथ edit_image पर भेजें।

सेशन में काम करने वाले प्रॉम्प्ट

Claude Code के अंदर इमेज प्रॉम्प्ट का एक फ़ायदा है जो वेब फ़ॉर्म में नहीं मिलता: एजेंट आपकी फ़ाइल देख सकता है। इसका फ़ायदा उठाएँ। इमेज के सिर्फ़ कंटेंट नहीं, उसका काम बताएँ, और फ़ाइल का पाथ और साइज़ लिखें ताकि दूसरे दौर की ज़रूरत न पड़े।

तीन आदतें सबसे ज़्यादा समय बचाती हैं:

• पहले एक इमेज माँगें। स्टाइल जाँचें, फिर बाकी को पाँच या उससे कम के बैच में माँगें।
• उसी संदेश में alt टेक्स्ट माँगें। Claude Code उसे लिखता है जब दृश्य संदर्भ में ताज़ा हो।
• नियम एक बार सेव करें। उन्हें अपने प्रोजेक्ट की CLAUDE.md फ़ाइल में रखें, ताकि हर सेशन एक ही डिफ़ॉल्ट के साथ शुरू हो।

## Images
- Generate images with the image-gen server, 16:9 unless the layout says otherwise
- Save to public/images/ with lowercase hyphenated names
- Write one-sentence alt text that describes the scene
- Photographic style, natural light, no text inside the image

प्रॉम्प्ट कॉपी करें

💡 टिप: आउटपुट फ़ोल्डर को हर प्रॉम्प्ट में नहीं, CLAUDE.md में नाम दें। यह एक लाइन फ़ाइलों को आपके रेपो रूट में गिरने से रोकती है।

आम गलतियों को ठीक करना

सर्वर failed दिखा रहा है

सर्वर कमांड को एक सामान्य टर्मिनल में हाथ से चलाएँ। Node का न होना, package नाम में टाइपो, या सेट न किया गया environment variable तुरंत दिख जाता है। फिर जाँचें कि -- Claude के विकल्पों और सर्वर कमांड के बीच है। Windows पर, पहले बताया गया cmd /c wrapper जोड़ें। अगर सर्वर बस शुरू होने में धीमा है, तो स्टार्टअप सीमा बढ़ाएँ, उदाहरण के लिए MCP_TIMEOUT=10000 claude, जो मिलीसेकंड में मापी जाती है। फिर /mcp reconnect all चलाएँ।

इमेज टोकन सीमा से आगे निकल जाती हैं

अगर कोई टूल रिज़ल्ट 10,000 टोकन की चेतावनी को छूता है, तो सर्वर शायद इनलाइन इमेज डेटा लौटा रहा है। ऐसे सर्वर पर जाएँ जो डिस्क पर सेव करता हो या URL लौटाता हो। MAX_MCP_OUTPUT_TOKENS=50000 claude से सीमा बढ़ाना आख़िरी उपाय के तौर पर काम करता है, पर यह उस context को खर्च करता है जिसे आप कोड के लिए रखना चाहते हैं।

धीमी या अटकी हुई जनरेशन

Claude Code दो मिनट से ज़्यादा चलने वाले टूल कॉल को बैकग्राउंड टास्क में डाल देता है, जिसे आप /tasks में देख सकते हैं। असिंक्रोनस कनेक्टर के साथ धीमा जॉब आमतौर पर भरी हुई कतार का संकेत होता है। जिस अकाउंट पर पाँच concurrent predictions की सीमा है, उस पर एक साथ बारह इमेज माँगने का मतलब है कि उनमें से सात इंतज़ार करेंगी। पाँच-पाँच करके माँगें, और जिस जॉब की अब ज़रूरत नहीं उसके लिए cancel_generation इस्तेमाल करें।

आज ही अपनी पहली इमेज बनाएँ

सेटअप में लगभग दस मिनट लगते हैं: एक कमांड, एक स्कोप चुनना, और एक टेस्ट प्रॉम्प्ट। उसके बाद Claude Code जो भी पेज बनाता है, वह प्लेसहोल्डर बॉक्स के बजाय अपनी तस्वीरों के साथ जा सकता है।

छोटी शुरुआत करें। PicassoIA Image में एक प्रॉम्प्ट आज़माएँ, PicassoIA Image Editor Pro से एक नतीजा रिफ़ाइन करें, फिर अपनी पसंदीदा इमेज को PicassoIA Video से एनिमेट करें। जब लुक सही लगे, तो वही प्रॉम्प्ट Claude Code को दें और उसे आपके प्रोजेक्ट के अंदर लूप चलाने दें। पूरी मॉडल सूची picassoia.com/en/all-models पर देखें, और आज ही Picasso IA के साथ अपनी इमेज बनाएँ।