Cursor MCP सेटअप: mcp.json, Settings और Marketplace

आप कॉन्फ़िग फ़ाइल में एक स्निपेट चिपकाते हैं, एडिटर रीस्टार्ट करते हैं, और नए सर्वर के नाम के बगल में एक लाल बिंदु दिखता है। यही वह पल है, जिससे पता चलता है कि एक साफ़ Cursor MCP सेटअप क्यों मायने रखता है। Model Context Protocol Cursor के Agent को बाहरी टूल कॉल करने देता है, ब्राउज़र से लेकर डेटाबेस और इमेज जनरेटर तक, लेकिन तभी जब कनेक्शन सही तरह से जुड़ा हो। यह लेख इस रास्ते को क्रम से समझाता है। आप देखेंगे कि mcp.json कहाँ रहती है, लोकल और रिमोट एंट्री कैसे लिखें, Settings में कौन-से स्विच हैं, Marketplace सर्वर को एक क्लिक में कैसे इंस्टॉल करता है, और कुछ फ़ेल हो तो क्या जाँचें। नीचे दिया हर कॉन्फ़िग Cursor के अपने डॉक्यूमेंटेशन के फ़ील्ड नामों का इस्तेमाल करता है, और हर सीक्रेट फ़ाइल से बाहर रहता है।

Cursor के अंदर MCP क्या करता है

MCP एक ओपन प्रोटोकॉल है, जो AI क्लाइंट को बाहरी प्रोग्रामों से बात करने का एक मानक तरीका देता है। Cursor क्लाइंट है। आप जो भी प्रोग्राम जोड़ते हैं वह एक सर्वर है, और हर सर्वर टूल दिखाता है, जिन्हें Agent चैट के दौरान कॉल कर सकता है: फ़ाइल पढ़ना, डेटाबेस से क्वेरी करना, वेब पेज खोलना, टिकट दर्ज करना, इमेज जनरेट करना।

सर्वर, टूल और Agent

तीन परतों के बारे में सोचें। Agent तय करता है कि आपने क्या माँगा है। सर्वर बताता है कि वह क्या कर सकता है। टूल एक कार्य है, जिसका नाम, विवरण और इनपुट का सेट होता है। जब आप Cursor से पूछते हैं कि एंडपॉइंट 500 क्यों लौटा रहा है, तो Agent टूल की सूची पढ़ता है, जो टूल फ़िट बैठते हैं उन्हें चुनता है, और चलाने से पहले अनुमति माँगता है।

इसके दो व्यावहारिक नतीजे हैं:

• ज़्यादा सर्वर का मतलब बेहतर नहीं है। हर चालू टूल अपना विवरण उस संदर्भ में जोड़ता है जिसे Agent पढ़ता है, इसलिए एक दर्जन बेकार सर्वर जवाबों को धीमा और विकल्पों को खराब बना देते हैं।
• नाम मायने रखते हैं। github या project-files जैसे साफ़ लेबल बाद में अप्रूवल प्रॉम्प्ट को आसानी से पढ़ने लायक बनाते हैं।

💡 एक या दो ऐसे सर्वर से शुरू करें जिन्हें आप हर दिन इस्तेमाल करेंगे। बाकी तब जोड़ें जब कोई असली काम उनकी माँग करे।

रोज़ के काम में यह ऐसा दिखता है। ब्राउज़र सर्वर Agent को आपकी स्टेजिंग साइट खोलने, चेकआउट में क्लिक करने और बताने देता है कि क्या टूटा। GitHub सर्वर उसे इश्यू पढ़ने, मिलता हुआ कोड खोजने और पull request का टेक्स्ट लिखने देता है। डेटाबेस सर्वर माइग्रेशन सुझाने से पहले एक रो जाँचने देता है। हर मामले में Agent अनुमान लगाना छोड़कर असली डेटा पढ़ने लगता है, और कॉन्फ़िगरेशन पर दस मिनट खर्च करने की असली वजह यही है।

लोकल या रिमोट सर्वर

Cursor तीन ट्रांसपोर्ट सपोर्ट करता है, और चुनाव तय करता है कि mcp.json में एंट्री कैसे लिखी जाएगी।

stdio सर्वर सबसे सरल है: Cursor npx जैसी कमांड लॉन्च करता है और उससे standard input और output के ज़रिए बात करता है। रिमोट सर्वर बस एक URL है। आप उसे चलाने के लिए प्रोवाइडर पर भरोसा करते हैं, और अक्सर टोकन चिपकाने के बजाय OAuth से ब्राउज़र में साइन इन करते हैं।

mcp.json कहाँ रहती है

Cursor MCP परिभाषाएँ mcp.json नाम की JSON फ़ाइल से पढ़ता है। इसके लिए दो जगहें हैं, और आप दोनों एक साथ इस्तेमाल कर सकते हैं।

ग्लोबल फ़ाइल या प्रोजेक्ट फ़ाइल

Windows पर होम फ़ोल्डर आपका यूज़र प्रोफ़ाइल है, इसलिए ग्लोबल फ़ाइल C:\Users\YourName\.cursor\mcp.json पर रहती है।

Cursor दोनों फ़ाइलों को मिला देता है। हर फ़ाइल में सर्वरों को अलग नाम दें, ताकि कभी यह सोचना न पड़े कि कौन-सी परिभाषा चल रही है। प्रोजेक्ट फ़ाइल तभी कमिट करें जब उसमें कोई सीक्रेट न हो, और निजी चीज़ों के लिए वेरिएबल इस्तेमाल करें।

साझा प्रोजेक्ट फ़ाइल का एक और फ़ायदा है: नया साथी रेपो क्लोन करता है और बिना सेटअप कॉल के वही सर्वर सूची पा जाता है। फिर हर व्यक्ति environment variables के ज़रिए अपने टोकन डालता है, तो फ़ाइल सबके लिए एक जैसी रहती है और क्रेडेंशियल निजी रहते हैं।

एंट्री की बनावट

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

stdio एंट्री में command, args, env और envFile इस्तेमाल होते हैं। रिमोट एंट्री में url और headers इस्तेमाल होते हैं। दोनों शेप अलग रखें: एक एंट्री, एक ट्रांसपोर्ट।

आपका पहला सर्वर, चरण-दर-चरण

चार कदम लगभग हर मामले को सँभाल लेते हैं: फ़ाइल बनाएँ, एंट्री जोड़ें, सेव करें, फिर Settings में नतीजा जाँचें। नीचे दिए दो उदाहरण लोकल और रिमोट एंट्री दिखाते हैं।

लोकल सर्वर जोड़ें

1. अगर ~/.cursor/mcp.json अभी मौजूद नहीं है, तो उसे बनाएँ।
2. नीचे दी गई एंट्री चिपकाएँ।
3. फ़ाइल सेव करें। Cursor आमतौर पर बदलाव अपने-आप पहचान लेता है। अगर सर्वर न दिखे, तो Cursor बंद करके फिर खोलें।

{
  "mcpServers": {
    "project-files": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
    }
  }
}

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

-y फ़्लैग npx को बिना पूछे पैकेज इंस्टॉल करने देता है। ${workspaceFolder} वेरिएबल सर्वर को खुले प्रोजेक्ट की ओर इंगित करता है, इसलिए वह केवल उसी फ़ोल्डर के अंदर की फ़ाइलों तक पहुँचता है।

रिमोट सर्वर जोड़ें

रिमोट एंट्री में command और args की जगह url आता है। यह उदाहरण GitHub का होस्टेड सर्वर जोड़ता है और टोकन एक environment variable से पढ़ता है।

{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:GITHUB_TOKEN}"
      }
    }
  }
}

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

OAuth सपोर्ट करने वाले सर्वर को कोई हेडर नहीं चाहिए। पहली बार इस्तेमाल पर Cursor एक ब्राउज़र विंडो खोलता है, आप एक्सेस को मंज़ूरी देते हैं, और साइन इन अगले सेशन के लिए सेव रहता है। जब कोई प्रोवाइडर इसके बजाय एक फ़िक्स्ड client ID और client secret देता है, तो Cursor auth ऑब्जेक्ट स्वीकार करता है, जिसमें CLIENT_ID, CLIENT_SECRET और scopes होते हैं। डेस्कटॉप ऐप के लिए http://localhost:8787/callback को redirect पते के रूप में रजिस्टर करें।

वेरिएबल सीक्रेट को बाहर रखते हैं

Cursor इन वेरिएबल को command, args, env, url और headers के अंदर विस्तारित करता है:

• ${env:NAME} एक environment variable पढ़ता है।
• ${userHome} आपकी होम डायरेक्टरी है।
• ${workspaceFolder} प्रोजेक्ट का रूट है।
• ${workspaceFolderBasename} प्रोजेक्ट फ़ोल्डर का नाम है।
• ${pathSeparator} या ${/} ऑपरेटिंग सिस्टम के लिए सही स्लैश देता है।

एक लोकल सर्वर जिसे डेटाबेस का पता और स्क्रिप्ट का पाथ चाहिए, दोनों को मिला सकता है:

{
  "mcpServers": {
    "notes-db": {
      "command": "node",
      "args": ["${userHome}${/}tools${/}notes-server${/}index.js"],
      "env": { "DB_URL": "${env:NOTES_DB_URL}" },
      "envFile": "${workspaceFolder}/.env"
    }
  }
}

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

💡 कभी भी असली टोकन ऐसी फ़ाइल में न डालें जिसे आप कमिट करते हैं। environment variable का रेफ़रेंस दें, और .env को .gitignore में जोड़ें।

Settings, टॉगल और अप्रूवल

Cursor Settings खोलें और Tools & MCP ढूँढें। हाल के बिल्ड में वही सर्वर साइडबार में Customize के नीचे भी दिखते हैं। यह वह कंट्रोल रूम है जहाँ से आप mcp.json में लिखी हर चीज़ को नियंत्रित करते हैं।

सर्वर चालू और बंद करें

हर सर्वर के साथ एक टॉगल और टूल की गिनती होती है। स्वस्थ सर्वर अपने टूल दिखाता है। फ़ेल होने वाला सर्वर एरर स्टेट दिखाता है। एक नज़र में स्थिति जानने के लिए ये तीन जाँचें कर लें:

• टॉगल चालू है।
• टूल की गिनती शून्य से ऊपर है।
• नाम के बगल में कोई एरर इंडिकेटर नहीं है।

किसी काम के लिए जिन सर्वरों की ज़रूरत नहीं है, उन्हें हटाने के बजाय बंद करें। एंट्री फ़ाइल में रहती है, और उसे दोबारा चालू करने में एक सेकंड लगता है। लंबे रीफ़ैक्टर से पहले संदर्भ का बोझ घटाने का यह सबसे तेज़ तरीका भी है।

टूल अप्रूवल और Run Modes

डिफ़ॉल्ट रूप से Cursor MCP टूल चलने से पहले अनुमति माँगता है। आपको टूल का नाम और उसके आर्गुमेंट दिखते हैं, फिर आप स्वीकार या अस्वीकार करते हैं। MCP टूल वही Run Mode नियम मानते हैं जो टर्मिनल कमांड मानते हैं, इसलिए अगर आपका मोड allowlist वाले कार्य तुरंत चलाता है, तो allowlist वाले MCP टूल भी तुरंत चलेंगे।

💡 सर्च, लिस्ट और fetch जैसे केवल-पढ़ने वाले टूल को अनुमति दें। जो कुछ लिखता, मिटाता, पोस्ट करता या पैसे खर्च करता है, उसके लिए अप्रूवल चालू रखें।

Marketplace से एक क्लिक में इंस्टॉल

JSON हाथ से लिखना काम करता है, लेकिन ज़्यादातर लोग Marketplace से शुरू करते हैं। लिस्टिंग cursor.com/marketplace और cursor.directory पर मिलती हैं।

Add to Cursor क्या करता है

हर लिस्टिंग में Add to Cursor बटन होता है। उस पर क्लिक करने पर Cursor खुलता है, पुष्टि माँगता है, और एंट्री को आपकी ग्लोबल ~/.cursor/mcp.json में लिख देता है। अगर सर्वर को OAuth चाहिए, तो इसके बाद Cursor आपको प्रोवाइडर के साइन इन पेज पर भेजता है।

इसके बाद MCP सूची खोलें और टूल की गिनती जाँचें। एंट्री सामान्य JSON है, इसलिए आप उसे बाद में बदल सकते हैं: नाम बदल सकते हैं, env वैल्यू जोड़ सकते हैं, या उसे प्रोजेक्ट फ़ाइल में ले जा सकते हैं।

इंस्टॉल से पहले जाँचें

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

• प्रकाशक जाँचें। उस सेवा के अपने सर्वर या सार्वजनिक सोर्स कोड वाले प्रोजेक्ट को प्राथमिकता दें।
• कमांड पढ़ें। npx एक रजिस्ट्री से कोड डाउनलोड करता है और आपकी मशीन पर चलाता है।
• टूल सूची पढ़ें। नोट्स सर्वर जो shell access माँगे, वह खतरे की घंटी है।
• जब स्थिरता अपडेट से ज़्यादा ज़रूरी हो, तब package@version के साथ वर्ज़न पिन करें।
• ऐसे प्रोवाइडर के रिमोट सर्वर को प्राथमिकता दें जिस पर आप पहले से भरोसा करते हैं और जिसमें OAuth से साइन इन करते हैं।

अगर आप तय नहीं कर पा रहे कि पहले क्या जोड़ें, तो यह छोटी सूची रोज़ के सबसे आम कामों से मेल खाती है:

ऐसे सर्वर को ठीक करना जो शुरू नहीं होता

ज़्यादातर फ़ेल होने की वजहें पाँच या छह कारणों से आती हैं। पहले लॉग देखें, फिर लक्षण से मिलान करें।

MCP लॉग पढ़ें

Mac पर Cmd+Shift+U या Windows और Linux पर Ctrl+Shift+U से Output पैनल खोलें, फिर ड्रॉपडाउन से MCP Logs चुनें। लॉग में सर्वर की शुरुआत, टूल कॉल और एरर संदेश दर्ज होते हैं। पहला एरर पढ़ें, आख़िरी नहीं। बाद की लाइनें आमतौर पर साइड इफ़ेक्ट होती हैं।

छह आम विफलताएँ

जब इनमें से कोई पंक्ति फ़िट न बैठे, तो सर्वर को हाथ से चलाएँ। अपनी एंट्री से command और args को उन्हीं environment वैल्यू के साथ टर्मिनल में कॉपी करें, और देखें कि वह क्या प्रिंट करता है। अगर वहाँ भी फ़ेल हो, तो समस्या सर्वर या उसके इंस्टॉल में है, Cursor में नहीं। अगर वहाँ ठीक चलता है, तो टर्मिनल के PATH और वेरिएबल की तुलना उससे करें जो Cursor env के ज़रिए पास करता है, और लॉग में एक बार फिर वह पहली लाइन खोजें जिसमें सर्वर का नाम आता हो।

MCP को PicassoIA टूल्स के साथ जोड़ना

कनेक्शन आधा काम है। तीन PicassoIA सुविधाएँ इसके आसपास मदद करती हैं।

कॉन्फ़िग का ड्राफ़्ट बनाना और उसकी समीक्षा। एक लार्ज लैंग्वेज मॉडल trailing comma पकड़ सकता है, MCP Logs की किसी एरर को समझा सकता है, या README के इंस्टॉल स्निपेट को Cursor एंट्री में बदल सकता है। PicassoIA पर आप Claude Sonnet 5, GPT 5.6 Sol, Kimi K2.6 या Gemini 3.5 Flash एक ही जगह से चला सकते हैं, और देख सकते हैं कि हर एक एक ही एरर को कैसे पढ़ता है। कॉन्फ़िग पेस्ट करने से पहले हर टोकन को प्लेसहोल्डर से बदल दें।

डॉक्स और READMEs के लिए विज़ुअल। सेटअप पेज साफ़ हेडर इमेज के साथ बेहतर पढ़े जाते हैं। Seedream 4.5, Flux 2 Pro और GPT Image 2 टेक्स्ट प्रॉम्प्ट को फ़ोटोग्राफ़िक इमेज में बदलते हैं, और इमेज-टू-वीडियो किसी स्थिर इमेज को changelog या सोशल पोस्ट के लिए छोटे क्लिप में बदल सकता है।

अपना MCP कनेक्शन। PicassoIA https://api.picassoia.com/v1 पर एक API देता है, और आपके अकाउंट से मैनेज होने वाले MCP कनेक्शन भी, जो इमेज जनरेशन, इमेज एडिटिंग और ऑडियो के साथ वीडियो जनरेशन को कवर करते हैं। हर अकाउंट पर एक साथ अधिकतम पाँच प्रेडिक्शन चल सकते हैं, और यह टोकन और MCP कनेक्शन में साझा होते हैं, इसलिए जो सेशन बहुत सारे अनुरोध भेजता है, वह कतार में लगेगा। सर्वर का पता आपके अकाउंट के भीतर दिखता है, इसलिए यह लेख कोई पता नहीं छापता। इसे पा लेने के बाद एंट्री उसी url शेप का पालन करती है जो ऊपर github उदाहरण में है। वर्कफ़्लो बनाने से पहले यह पक्का करने के लिए अपने प्लान का पेज देखें कि कौन-से टियर में MCP कनेक्शन शामिल हैं।

इसके बाद अपने विज़ुअल बनाएँ

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