Picsart GenAI MCP

Picsart MCP सर्वर अपने उपलब्ध मॉडल को Model Context Protocol टूल के रूप में उपलब्ध कराता है। इसे किसी भी MCP-संगत एजेंट से कनेक्ट करें और वह एजेंट प्राकृतिक भाषा या संरचित टूल कॉल का उपयोग करके उपलब्ध मॉडलों से इमेज, वीडियो और ऑडियो बना सकता है।

MCP आपके लिए नया है? पहले What is MCP? से शुरुआत करें।

आपको क्या चाहिए

• एक Picsart खाता। एजेंट के पहली बार कनेक्ट होने पर आप ब्राउज़र में उसमें साइन इन करेंगे।
• जनरेशन के लिए उस खाते में क्रेडिट। कैटलॉग ब्राउज़ करना और लागत का अनुमान लेना मुफ़्त है।
• ऐसा एजेंट जो OAuth साइन-इन वाले रिमोट (HTTP) MCP सर्वर का समर्थन करता हो। Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT और Gemini CLI—सभी ऐसा करते हैं।

बस इतना ही। सर्वर Picsart द्वारा होस्ट किया जाता है, इसलिए आपको अपनी मशीन पर कुछ भी इंस्टॉल करने की ज़रूरत नहीं है। MCP का उपयोग करने के लिए आपको gen-ai CLI, gen-ai login, या API key की ज़रूरत नहीं है।

सर्वर का पता है:

https://api.picsart.com/gen-ai/mcp

साइन-इन कैसे काम करता है

जब आपका एजेंट पहली बार कनेक्ट होता है, तो सर्वर बताता है कि साइन-इन आवश्यक है और एजेंट को Picsart के साइन-इन पेज पर भेजता है। एजेंट ब्राउज़र विंडो खोलता है, आप Picsart में साइन इन करके पहुँच की अनुमति देते हैं, और एजेंट स्वयं सेशन सहेज लेता है। इसके बाद हर टूल कॉल आपके रूप में, आपके क्रेडिट बैलेंस से की जाती है।

अगर सेशन की अवधि समाप्त हो जाए, तो अपने एजेंट की MCP या कनेक्टर सेटिंग से सर्वर को फिर से कनेक्ट करें या दोबारा प्रमाणित करें। इसके चरण हर integration guide में दिए गए हैं।

अपने एजेंट से कनेक्ट करें

Claude (वेब और डेस्कटॉप)

Settings → Connectors → Add custom connector पर जाएँ, https://api.picsart.com/gen-ai/mcp पेस्ट करें और खुलने वाली विंडो में Picsart में साइन इन करें। Claude Team या Enterprise प्लान पर, संगठन का मालिक सभी के लिए कनेक्टर जोड़ता है।

Claude Code

claude mcp add --transport http picsart-gen-ai https://api.picsart.com/gen-ai/mcp

फिर Claude Code में /mcp चलाएँ, picsart-gen-ai चुनें और साइन इन करने के लिए Authenticate चुनें। इसे किसी भी बातचीत में इस्तेमाल करें:

"Flux 2 Pro का उपयोग करके सफ़ेद बैकग्राउंड पर 4:3 आस्पेक्ट रेशियो वाली उत्पाद इमेज बनाएँ।"

Skills और समस्या-निवारण सहित Claude Code के पूरे सेटअप के लिए Claude Code integration देखें।

Cursor

अपने प्रोजेक्ट में .cursor/mcp.json में, या हर प्रोजेक्ट के लिए ~/.cursor/mcp.json में यह जोड़ें:

{
  "mcpServers": {
    "picsart-gen-ai": {
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

Cursor integration देखें।

Windsurf

इसे mcp_config.json में जोड़ें (Cascade के ... मेनू → Open MCP config file से खोलें):

{
  "mcpServers": {
    "picsart-gen-ai": {
      "serverUrl": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

Windsurf integration देखें।

VS Code (Copilot)

इसे अपने वर्कस्पेस के .vscode/mcp.json में या अपने उपयोगकर्ता MCP कॉन्फ़िगरेशन में जोड़ें:

{
  "servers": {
    "picsart-gen-ai": {
      "type": "http",
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

VS Code integration देखें।

Codex (OpenAI)

codex mcp add picsart-gen-ai --url https://api.picsart.com/gen-ai/mcp
codex mcp login picsart-gen-ai

Codex integration देखें।

ChatGPT और अन्य MCP क्लाइंट

ऊपर दिए गए पते के साथ एक कनेक्टर जोड़ें (जिसे कभी-कभी रिमोट या कस्टम MCP सर्वर कहा जाता है) और प्रमाणीकरण विधि के रूप में OAuth चुनें। ChatGPT integration और integrations की पूरी सूची देखें।

---

टूल कैटलॉग

कनेक्ट करने पर नीचे दिए गए जनरेशन, कैटलॉग और Drive टूल, साथ ही देखने वाले टूल, निर्देशित क्रिएटिव बोर्ड का एक सेट और आपके पास पहले से मौजूद सामग्री से वीडियो और इमेज बनाने के लिए picsart_media_* टूल उपलब्ध होते हैं।

जनरेट करने के बजाय सामग्री बना रहे हैं?

Picsart Media Studio इसी तरह के काम के लिए समर्पित कनेक्टर है। इसे अलग से जोड़ा और साइन इन किया जाता है, और यह इस कनेक्टर के साथ आसानी से काम करता है।

कनेक्ट होने के बाद हर टूल एजेंट के लिए उपलब्ध होता है। जिन टूल से क्रेडिट खर्च नहीं होते, उन्हें ज़रूरत के अनुसार जितनी बार चाहें मुफ़्त में कॉल किया जा सकता है।

जनरेशन

टूल	उद्देश्य	क्रेडिट खर्च होते हैं
picsart_generate	किसी भी मॉडल को शुरू से अंत तक चलाएँ (इमेज / वीडियो / ऑडियो / टेक्स्ट)	हाँ
picsart_remove_bg	इमेज का बैकग्राउंड हटाएँ	हाँ
picsart_change_bg	प्रॉम्प्ट के आधार पर इमेज का बैकग्राउंड बदलें	हाँ
picsart_enhance	इमेज को अपस्केल / बेहतर बनाएँ	हाँ
picsart_vectorize	रास्टर इमेज को SVG में बदलें	हाँ

कैटलॉग और लागत

टूल	उद्देश्य	क्रेडिट खर्च होते हैं
picsart_list_models	उपयोगकर्ता के लिए मॉडल चुनने वाला विजेट, ताकि वह विज़ुअल रूप से ब्राउज़ कर सके	नहीं
picsart_model_catalog	वही कैटलॉग सादे डेटा के रूप में, एजेंट के अपने तर्क के लिए	नहीं
picsart_model_params	किसी एक मॉडल का पैरामीटर स्कीमा (प्रकार, आवश्यक, enum, न्यूनतम/अधिकतम)	नहीं
picsart_model_choice	उपयोगकर्ता को चुनने के लिए संभावित मॉडलों की छोटी सूची कार्ड के रूप में दिखाएँ	नहीं
picsart_preflight	एक मुफ़्त ड्राई रन में params पेलोड की पुष्टि करें और उसकी क्रेडिट लागत का अनुमान दें	नहीं
picsart_credits	मौजूदा क्रेडिट बैलेंस और कोटा का विवरण	नहीं
picsart_job_status	picsart_generate द्वारा शुरू किए गए जॉब की स्थिति जाँचें	नहीं
picsart_render_monitor	चल रहे जनरेशन के बैच के लिए लाइव प्रगति पैनल	नहीं

देखना

टूल	उद्देश्य	क्रेडिट खर्च होते हैं
picsart_view_image	एजेंट को Picsart पर होस्ट की गई अधिकतम 6 इमेज देखने दें, ताकि वह परिणाम का मूल्यांकन कर सके या किसी संदर्भ का वर्णन कर सके	नहीं

Drive

टूल	उद्देश्य	क्रेडिट खर्च होते हैं
picsart_drive	Picsart Drive के लिए एकल प्रवेश बिंदु; व्यवहार का चयन action से होता है	नहीं

picsart_drive में action पैरामीटर होता है; हर ऑपरेशन के लिए अलग Drive टूल नहीं हैं:

action	यह क्या करता है
list	फ़ोल्डर ब्राउज़ करें (folderUid छोड़ने पर = रूट; flat: true से हर फ़ाइल सूचीबद्ध होती है)
create_folder	फ़ोल्डर बनाएँ (name, या स्लैश से अलग किया गया path, वैकल्पिक पैरेंट folderUid, description)
upload	फ़ाइल सहेजें: file (चैट अटैचमेंट), url + name (HTTPS URL या इनलाइन data: URI), या files से एक बार में अधिकतम 10 फ़ाइलें। result.url एक CDN URL है, जिसे imageUrls में देने के लिए तैयार किया गया है
move	itemUids को targetFolderUid में ले जाएँ
delete	itemUids को ट्रैश में सॉफ़्ट-डिलीट करें (मिटाने के लिए permanent: true)
update	एक फ़ाइल पर कस्टम एट्रिब्यूट सेट करें (itemUid + attributes)

हर कार्रवाई मौजूदा फ़ोल्डर सूची लौटाती है, ताकि Drive विजेट उसे रेंडर कर सके। विवरण के लिए Files & Drive देखें, और शुरुआत में अपनी डिस्क से फ़ाइल प्राप्त करने के लिए Local files → URLs देखें।

क्रिएटिव बोर्ड और मीडिया निर्माण

कुछ टूल टेक्स्ट में जवाब देने के बजाय बातचीत में एक इंटरैक्टिव पैनल खोलते हैं: जैसे फ़िल्म सेटअप कंसोल, शॉट लिस्ट बोर्ड, एसेट समीक्षा बोर्ड, मोशन सेटअप कंसोल और सीन एडिटर। ये लघु फ़िल्म या मोशन-डिज़ाइन वीडियो जैसी कई चरणों वाली परियोजनाओं में मार्गदर्शन करते हैं। picsart_media_* टूल (अपलोड, सीन टेम्पलेट, कैप्शन, ट्रांसक्रिप्शन, रीफ़्रेमिंग, एक्सपोर्ट) उसी परिवार के हैं, जिसका दस्तावेज़ीकरण Media Studio → What you can do के अंतर्गत है। आपका एजेंट इन सभी को अपने-आप खोज लेता है; आपको इन्हें नाम से कॉल करने की ज़रूरत नहीं है।

कोई भी टूल फ़ाइल सिस्टम पाथ स्वीकार नहीं करता

हर इमेज/वीडियो इनपुट एक URL होता है। MCP कॉन्ट्रैक्ट में कहीं भी filePath पैरामीटर नहीं है। वास्तव में काम करने वाले पाथ के लिए Local files → URLs देखें।

सुझाया गया जनरेशन क्रम

टूल एक-दूसरे के साथ क्रम में काम करने के लिए बनाए गए हैं। यह क्रम अप्रत्याशित समस्याओं से बचाता है:

1. picsart_model_catalog (या उपयोगकर्ता को विज़ुअल रूप से चुनने देने के लिए picsart_list_models) → मॉडल चुनें
2. picsart_model_params → उसके इनपुट जानें
3. picsart_preflight → एक मुफ़्त कॉल में पेलोड की पुष्टि करें और लागत का अनुमान लें
4. picsart_generate → इसे शुरू करें
5. picsart_job_status → परिणाम प्राप्त करें (मीडिया मॉडल डिफ़ॉल्ट रूप से एसिंक्रोनस रूप से चलते हैं)

अगर आपके पास पहले से मॉडल id है, तो सीधे picsart_generate पर जाएँ।

टूल कॉल के उदाहरण

इमेज बनाएँ:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting",
    "aspectRatio": "4:3",
    "count": 1
  }
}

वीडियो बनाएँ:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "seedance-2.0",
    "prompt": "a cat skiing down a mountain",
    "duration": 8,
    "aspectRatio": "16:9",
    "generateAudio": true
  }
}

पहले पुष्टि करें और लागत का अनुमान लें:

{
  "name": "picsart_preflight",
  "arguments": {
    "model": "veo-3.1",
    "params": { "prompt": "a drone shot over a snowy ridge", "duration": 8, "resolution": "1080p" }
  }
}

बैकग्राउंड हटाएँ:

{
  "name": "picsart_remove_bg",
  "arguments": {
    "image": "https://example.com/product.jpg"
  }
}

picsart_remove_bg, picsart_change_bg, picsart_enhance और picsart_vectorize में से हर एक एक image URL लेता है और अपने-आप उपयुक्त मॉडल चुनता है। इसे बदलने के लिए model दें।

इनपुट संदर्भ

picsart_generate में ये पैरामीटर होते हैं:

• आवश्यक: model (मॉडल id), prompt (टेक्स्ट प्रॉम्प्ट)
• आम वैकल्पिक: aspectRatio, resolution, duration, count (1 से 10), quality, style, negativePrompt
• इमेज इनपुट: imageUrls (URL की ऐरे, इमेज-टू-इमेज या इमेज-टू-वीडियो मॉडल के लिए)
• वीडियो इनपुट: videoUrl (एक URL, वीडियो-टू-वीडियो मॉडल के लिए)
• ऑडियो जनरेशन: generateAudio (बूलियन, नेटिव ऑडियो का समर्थन करने वाले वीडियो मॉडल के लिए)
• प्रॉम्प्ट बेहतर बनाना: enhancePrompt (बूलियन, जनरेशन से पहले LLM के माध्यम से भेजता है)
• Drive: saveToDrive (डिफ़ॉल्ट true) और folderUid (परिणाम किस Drive फ़ोल्डर में सहेजना है)
• एसिंक: async (हर मीडिया मॉडल के लिए डिफ़ॉल्ट true होता है: कॉल तुरंत जॉब हैंडल लौटाती है और एजेंट परिणाम के लिए picsart_job_status को पोल करता है)
• मॉडल-विशिष्ट पैरामीटर: extra (फ़्री-फ़ॉर्म ऑब्जेक्ट; मॉडल किन पैरामीटर को स्वीकार करता है, यह देखने के लिए picsart_model_params का उपयोग करें)

पूरे हुए परिणाम assets: [{ id, type, url, ... }] के रूप में लौटते हैं, साथ ही हर फ़ाइल के लिए एक resource_link भी लौटता है, ताकि एजेंट आगे की टूल कॉल में उसका संदर्भ दे सके। एसेट HTTPS URL होते हैं, कभी base64 नहीं। टेक्स्ट मॉडल इसके बजाय जनरेट किया गया टेक्स्ट लौटाते हैं।

अक्सर पूछे जाने वाले प्रश्न

क्या MCP का उपयोग करने के लिए मुझे gen-ai CLI चाहिए?

नहीं। MCP सर्वर Picsart द्वारा होस्ट किया जाता है और आपका एजेंट HTTPS पर उससे कनेक्ट होता है। CLI टर्मिनल के लिए एक अलग टूल है। इसे केवल तभी इंस्टॉल करें, जब आप शेल से जनरेट करना या Skills का उपयोग करना चाहते हों।

क्या MCP सर्वर के लिए API key चाहिए?

नहीं। आप अपने एजेंट के माध्यम से Picsart खाते में साइन इन करते हैं। कॉपी या रोटेट करने के लिए कोई key नहीं है।

क्या मैं MCP और CLI का एक साथ उपयोग कर सकता हूँ?

हाँ। दोनों में अलग-अलग साइन इन किया जाता है, लेकिन वे एक ही Picsart खाते और एक ही क्रेडिट बैलेंस का उपयोग करते हैं।

एजेंट कनेक्ट हो गया, लेकिन टूल दिखाई नहीं दे रहे।

सुनिश्चित करें कि आपने साइन-इन पूरा कर लिया है, फिर एजेंट को रीस्टार्ट या रीलोड करें। ज़्यादातर एजेंट टूल सूची लगातार नहीं, बल्कि कनेक्ट होने पर लोड करते हैं।

MCP के ज़रिए कौन-से मॉडल काम करते हैं?

SDK कैटलॉग संदर्भ में 252 मॉडल शामिल हैं। MCP की उपलब्धता सर्वर संस्करण पर निर्भर करती है। मोड, प्रोवाइडर या उद्देश्य के अनुसार फ़िल्टर करने के लिए picsart_model_catalog या picsart_list_models का उपयोग करें, या Model Catalog ब्राउज़ करें।

जनरेट की गई फ़ाइलें कहाँ जाती हैं?

डिफ़ॉल्ट रूप से हर मीडिया परिणाम आपके Picsart Drive में भी सहेजा जाता है, Drive रूट के picsart-genai-mcp फ़ोल्डर में। इसे कहीं और सहेजने के लिए folderUid दें, या सहेजना छोड़ने के लिए "saveToDrive": false दें। URL या चैट अटैचमेंट स्वयं अपलोड करने के लिए picsart_drive का उपयोग करें। Files and Drive देखें।

जनरेशन चलाने से पहले मुझे कैसे पता चलेगा कि किसी मॉडल की लागत कितनी है?

मॉडल id और उन पैरामीटर के साथ picsart_preflight कॉल करें जिनका आप उपयोग करना चाहते हैं। यह जनरेशन चलाए बिना पेलोड की पुष्टि करता है और क्रेडिट का अनुमान लौटाता है।

अगर मेरा क्रेडिट बैलेंस खत्म हो जाए तो क्या होगा?

picsart_credits से अपना बैलेंस जाँचें और दोबारा कोशिश करने से पहले picsart.com पर क्रेडिट जोड़ें।