Cursor MCP सर्वर पर लाल डॉट, खाली टूल लिस्ट या चुपचाप होने वाली विफलताएँ दिख रही हैं? लॉग पढ़ें, PATH और JSON की गलतियाँ सुधारें, GitHub टोकन स्कोप, Figma पोर्ट और Playwright ब्राउज़र एरर ठीक करें, फिर इंस्पेक्टर से किसी भी सर्वर की जाँच करें ताकि आपका एजेंट अपने टूल्स दोबारा इस्तेमाल कर सके।
आप mcp.json में सर्वर ब्लॉक पेस्ट करते हैं, Cursor रीस्टार्ट करते हैं, और सेटिंग्स पैनल में लाल डॉट दिखता है, या हरे डॉट के बगल में खाली टूल लिस्ट। एजेंट ऐसे व्यवहार करता है जैसे आपका GitHub, Figma या Playwright सर्वर कभी था ही नहीं। यही चुप्पी MCP डिबगिंग को सबसे ज़्यादा परेशान करने वाला बनाती है: कुछ क्रैश नहीं होता, कुछ समझाया नहीं जाता, और समाधान अक्सर एक ऐसी लाइन होती है जो सेटिंग्स स्क्रीन से दिखाई ही नहीं देती।
यह लेख Cursor MCP सर्वर काम न करने के पीछे की विफलताओं को उस क्रम में समझाता है जिससे उन्हें सबसे तेज़ी से पकड़ा जा सके। पहले सेक्शन में चार जाँचें हैं जो हर सर्वर पर लागू होती हैं। उसके बाद GitHub, Figma और Playwright की खास दिक्कतें आती हैं, फिर टूल की सीमाएँ, अप्रूवल प्रॉम्प्ट, और एडिटर के बाहर किसी भी सर्वर की जाँच का तरीका। हर समाधान अपना लक्षण बताता है, ताकि आप अपनी स्क्रीन से मेल खाने वाले हिस्से तक सीधे पहुँच सकें।
💡 संस्करणों के बारे में एक नोट: Cursor और तीनों सर्वर तेज़ी से बदलते हैं। मेनू के लेबल, फ़्लैग और URL हर रिलीज़ में बदल सकते हैं, इसलिए जब आपकी स्क्रीन पर कोई नाम इस पेज से अलग दिखे, तो इस लेख की बजाय अपने लॉग के आउटपुट पर भरोसा करें।
किसी एक सर्वर को दोष देने से पहले उन समस्याओं को परखें जो सभी को एक साथ तोड़ती हैं। ज़्यादातर मामलों में इन चारों में से कोई एक असली कारण होता है।
Cursor में Output पैनल खोलें और ड्रॉपडाउन से MCP logs चैनल चुनें। इसका सटीक लेबल संस्करण के हिसाब से बदलता है, लेकिन यह बाकी Output चैनलों के साथ ही रहता है। लॉग में वह कमांड दिखता है जो Cursor ने चलाई, और रुकने से पहले सर्वर ने stderr पर जो लिखा। तीन संदेश ज़्यादातर विफलताओं के लिए ज़िम्मेदार होते हैं:
spawn npx ENOENT: Cursor एक्सीक्यूटेबल नहीं ढूँढ पा रहा। नीचे दिया PATH समाधान देखें।MCP error -32000: Connection closed: प्रोसेस शुरू हुई और तुरंत बंद हो गई, आमतौर पर टोकन न होने, गलत आर्गुमेंट या लॉन्च पर क्रैश की वजह से।Request timed out: सर्वर चल रहा है पर धीमा है, अक्सर इसलिए क्योंकि npx पहली बार चलने पर कोई पैकेज डाउनलोड कर रहा है।💡 टिप: कुछ भी बदलने से पहले लॉग की आखिरी 30 लाइनें कॉपी कर लें। अगर आपका पहला अनुमान गलत निकला तो हर रीस्टार्ट वे सबूत मिटा देता है जिनकी आपको ज़रूरत है।
Cursor दो फ़ाइलें पढ़ता है: हर प्रोजेक्ट के लिए ~/.cursor/mcp.json, और मौजूदा प्रोजेक्ट के अंदर .cursor/mcp.json। दोनों को सख़्त JSON चाहिए, यानी कोई कमेंट नहीं, कोई ट्रेलिंग कॉमा नहीं और सिर्फ़ सीधे कोट्स। एक गलत कॉमा Cursor को बिना साफ़ संदेश के पूरी फ़ाइल छोड़ने पर मजबूर कर सकता है।
{
"mcpServers": {
"github": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${env:GITHUB_TOKEN}" }
}
}
}
फ़ाइल जाँचने के लिए node -e "JSON.parse(require('fs').readFileSync('.cursor/mcp.json','utf8'))" चलाएँ। JSON सही हो तो यह कुछ नहीं दिखाता, और गलत हो तो सटीक स्थिति बताता है। हाल के Cursor बिल्ड आपके एनवायरनमेंट से ${env:NAME} प्लेसहोल्डर भरते हैं। अगर आपका बिल्ड इसकी जगह शाब्दिक टेक्स्ट पास करता है, तो सर्वर को नकली टोकन मिलता है और वह ऑथेंटिकेशन एरर के साथ विफल होता है, इसलिए किसी लोकल, कमिट न की गई फ़ाइल में असली मान रखकर टेस्ट करें।
डॉक, Start मेनू या Spotlight से लॉन्च हुआ Cursor आपकी शेल प्रोफ़ाइल नहीं पढ़ता। nvm, fnm या Homebrew से इंस्टॉल किए गए टूल उसे नहीं दिखते, भले ही वे आपके टर्मिनल में काम करते हों, और लॉग में spawn npx ENOENT दिखता है। सादे कमांड की जगह एब्सोल्यूट पाथ लगाएँ। macOS और Linux पर which npx चलाएँ, या Windows पर where npx, और नतीजा पेस्ट करें:
"command": "/Users/you/.nvm/versions/node/v22.11.0/bin/npx"
Windows में एक दूसरा जाल भी है। npx एक .cmd स्क्रिप्ट है, और कुछ लॉन्चर उसे सीधे नहीं चला पाते। उसे cmd में लपेटें, और हमेशा -y पास करें ताकि npx कभी किसी ऐसे डाउनलोड की अनुमति माँगने पर न रुके जो किसी को दिखता ही नहीं।
"command": "cmd",
"args": ["/c", "npx", "-y", "@playwright/mcp@latest"]
फ़ाइल बदलने से चल रहा सर्वर हमेशा रीस्टार्ट नहीं होता। Cursor Settings, Tools & MCP के तहत सर्वर को बंद करके फिर चालू करें (पुराने बिल्ड में इसे सिर्फ़ MCP लिखा होता है), या कमांड पैलेट से Developer: Reload Window चलाएँ। अगर पुरानी स्थिति बनी रहे, तो Cursor को पूरी तरह बंद करें। बची हुई कोई प्रोसेस पोर्ट या ब्राउज़र प्रोफ़ाइल पकड़ सकती है और नई शुरुआत को ऐसे कारणों से विफल कर सकती है जिनका आपके कॉन्फ़िग से कोई लेना-देना नहीं।
GitHub अपना सर्वर github/github-mcp-server रिपॉज़िटरी में दो रूपों में रखता है: Docker में चलने वाला लोकल सर्वर, और होस्टेड सर्वर। अगर आपका कॉन्फ़िग अब भी पुराने @modelcontextprotocol/server-github npm पैकेज की ओर इशारा करता है, तो उसे छोड़ दें। वह पैकेज अब डेप्रिकेट हो चुका है और उसकी जगह GitHub का अपना सर्वर आ गया है। नए फ़िक्स और नए टूल सिर्फ़ नए सर्वर को मिलते हैं।
GitHub की सबसे आम विफलता वह सर्वर है जो ठीक से कनेक्ट हो जाता है, पर हर टूल कॉल 401, 403 या उलझाने वाला 404 लौटाती है। प्राइवेट रिपॉज़िटरी पर 404 का आमतौर पर मतलब होता है कि टोकन उसे देख नहीं सकता, न कि रिपॉज़िटरी मौजूद नहीं है। ये चार चीज़ें जाँचें:
repo स्कोप चाहिए, और अगर आप ऑर्गनाइज़ेशन का डेटा क्वेरी करते हैं तो read:org भी।💡 टिप:
curl -H "Authorization: Bearer $GITHUB_TOKEN" https://api.github.com/userसे Cursor के बाहर टोकन टेस्ट करें। JSON प्रोफ़ाइल दिखे तो टोकन काम करता है, और आपकी समस्या कॉन्फ़िग में है।
लोकल सर्वर को Docker चाहिए। तीन लॉग लाइनें इसी ओर इशारा करती हैं: docker: command not found, Cannot connect to the Docker daemon, और इमेज डाउनलोड होते समय टाइमआउट। पहले Docker Desktop शुरू करें, फिर एक बार टर्मिनल में docker pull ghcr.io/github/github-mcp-server चलाएँ, ताकि Cursor को पहले डाउनलोड का इंतज़ार न करना पड़े। अपने args में -i फ़्लैग भी जाँचें। यह stdin खुला रखता है, और इसके बिना सर्वर शुरू होते ही बंद हो जाता है। कॉर्पोरेट प्रॉक्सी के पीछे ghcr.io से पुल विफल हो सकता है, भले ही बाकी Docker पुल काम कर रहे हों।
अगर Docker लगातार परेशान करे, तो होस्टेड सर्वर पर जाएँ। इसे न Docker चाहिए, न Node, न PATH सेटअप:
"github": {
"url": "https://api.githubcopilot.com/mcp/",
"headers": { "Authorization": "Bearer ${env:GITHUB_TOKEN}" }
}
401 टोकन की ओर इशारा करता है, और टाइमआउट प्रॉक्सी या फ़ायरवॉल की ओर। GitHub के सर्वर पर बड़ी संख्या में टूल भी उपलब्ध हैं, जो आगे की सीमाओं के लिए मायने रखता है। इसके README में टूलसेट का वर्णन है, जिन्हें लोकल सर्वर पर GITHUB_TOOLSETS एनवायरनमेंट वेरिएबल से, या रिमोट सर्वर पर X-MCP-Toolsets हेडर से सेट किया जाता है। इस तरह आप केवल repos, issues और pull_requests लोड कर सकते हैं और बाकी छोड़ सकते हैं।
Figma के पास दो रास्ते हैं। पहला एक लोकल सर्वर है जो Figma के डेस्कटॉप ऐप के अंदर चलता है। दूसरा ब्राउज़र साइन-इन वाला होस्टेड सर्वर है। लॉन्च के बाद से नाम, पोर्ट और पाथ बदल चुके हैं, इसलिए जब नीचे का कोई चरण आपकी स्क्रीन से मेल न खाए, तो उसे Figma के मौजूदा दस्तावेज़ों से मिलाएँ। विफलताएँ तीन श्रेणियों में आती हैं।
लोकल सर्वर ब्राउज़र टैब में नहीं, डेस्कटॉप ऐप के अंदर रहता है। ऐप खुला होना चाहिए, एक डिज़ाइन फ़ाइल लोड होनी चाहिए, और MCP सर्वर को Dev Mode के inspect पैनल से या प्रेफ़रेंस से चालू करना होगा, जो आपके बिल्ड पर निर्भर है। Figma ने MCP एक्सेस को पेड प्लान और खास सीट प्रकारों से भी जोड़ा है, इसलिए कॉन्फ़िग पर घंटा भर लगाने से पहले जाँचें कि आपकी सीट इसकी अनुमति देती है। जब ऐप बंद हो, तो Cursor रिफ़्यूज़्ड कनेक्शन दिखाता है, जो टूटे सर्वर जैसा लगता है पर असल में एक गायब प्रोसेस होती है।
लोकल सर्वर पोर्ट 3845 पर सुनता है। नए बिल्ड /mcp पर जवाब देते हैं, और पुराने /sse का इस्तेमाल करते थे। जो कॉन्फ़िग अब भी पुराना पाथ रखता है, उसे 404 या रिफ़्यूज़्ड हैंडशेक मिलता है:
"figma": { "url": "http://127.0.0.1:3845/mcp" }
localhost की जगह 127.0.0.1 इस्तेमाल करें। कुछ मशीनों पर localhost पहले IPv6 पर रिज़ॉल्व होता है, और IPv4 पर बंधा सर्वर उस रूट को मना कर देता है। अगर पोर्ट पहले से इस्तेमाल में है, तो macOS और Linux पर lsof -i :3845 से, या Windows पर netstat -ano | findstr 3845 से उसका मालिक खोजें। होस्टेड रूट के लिए Cursor को https://mcp.figma.com/mcp की ओर इशारा करें और पूछे जाने पर ब्राउज़र साइन-इन पूरा करें। गलती से साइन-इन टैब बंद हो गया? सर्वर को बंद करके फिर चालू करें ताकि प्रोसेस दोबारा शुरू हो।
लोकल टूल आपकी मौजूदा सिलेक्शन या किसी फ़्रेम के लिंक पर काम करते हैं। बिना कुछ चुने एजेंट से "इस स्क्रीन को बनाएँ" कहेंगे, तो उसे खाली जवाब मिलेगा, जो मृत सर्वर जैसा लगता है जबकि कनेक्शन बिल्कुल ठीक होता है। Figma में एक फ़्रेम चुनें या अपने प्रॉम्प्ट में फ़्रेम का लिंक पेस्ट करें। अगर बहुत बड़ा फ़्रेम टाइमआउट होता है, तो छोटा हिस्सा चुनें और स्क्रीन को टुकड़ों में बनाएँ।
💡 टिप: Figma में हर बदलाव के बाद एजेंट से पहले एक छोटा सवाल पूछें, जैसे चुने गए फ़्रेम का नाम। सही जवाब साबित करता है कि पूरी चेन काम कर रही है, इसके बाद ही पूरा लेआउट माँगें।
Microsoft का @playwright/mcp आम पसंद है, और न्यूनतम कॉन्फ़िग छोटा है:
"playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
क्योंकि यह एक असली ब्राउज़र लॉन्च करता है, इसलिए यह बाकी दो सर्वरों से ज़्यादा तरीकों से विफल होता है।
Executable doesn't exist या Chromium distribution 'chrome' is not found जैसी लॉग लाइन का मतलब है कि मेल खाता ब्राउज़र इंस्टॉल नहीं है। डिफ़ॉल्ट रूप से सर्वर Chrome माँगता है। या तो Chrome को सामान्य तरीके से इंस्टॉल करें, या टर्मिनल में npx playwright install chrome चलाएँ। सर्वर के साथ browser_install टूल भी आता है, इसलिए यह एरर आने पर आप एजेंट से इसे कॉल करने को कह सकते हैं। किसी दूसरे इंजन के लिए args में --browser firefox या --browser webkit जोड़ें और उस इंजन को उसी तरह इंस्टॉल करें।
डिफ़ॉल्ट सेशन एक परसिस्टेंट प्रोफ़ाइल फ़ोल्डर इस्तेमाल करता है। Cursor की दूसरी विंडो, या क्रैश हुए रन की बची Chrome प्रोसेस उस फ़ोल्डर को लॉक कर देती है, और लॉग कहता है कि ब्राउज़र पहले से इस्तेमाल में है और --isolated फ़्लैग सुझाता है। बाहर की प्रोसेस बंद करें, या फ़्लैग जोड़ें ताकि हर सेशन एक नई इन-मेमोरी प्रोफ़ाइल से शुरू हो:
"args": ["@playwright/mcp@latest", "--isolated"]
आइसोलेटेड सेशन लॉगिन भूल जाते हैं। अगर आपको किसी साइट पर साइन-इन बने रहना है, तो सर्वर को --user-data-dir के साथ एक समर्पित प्रोफ़ाइल दें।
कंटेनर, WSL, SSH सेशन और CI मशीनों में आमतौर पर कोई डिस्प्ले नहीं होता, इसलिए --headless जोड़ें। root के रूप में चल रहे कंटेनर में आखिरी उपाय के तौर पर --no-sandbox सैंडबॉक्स एरर हटा देता है, पर इससे आइसोलेशन कमज़ोर होता है। Node का संस्करण भी जाँचें, क्योंकि पैकेज को Node 18 या नए की ज़रूरत है। आखिर में, पहली लॉन्च पैकेज डाउनलोड करती है और ब्राउज़र शुरू करती है, जो Cursor के टाइमआउट से लंबी हो सकती है। कैश गरम करने के लिए टर्मिनल में एक बार npx @playwright/mcp@latest --help चलाएँ, तो Cursor से अगली शुरुआत तेज़ होगी।
कुछ विफलताओं में हर डॉट हरा रहता है। सर्वर कनेक्टेड है और एजेंट उसे कभी इस्तेमाल नहीं करता। ज़्यादातर मामलों के पीछे दो कारण होते हैं।
बहुत सारे टूल लोड हैं। Cursor ने चेतावनी दी है जब सभी सर्वरों में मिलाकर टूल की संख्या बहुत बढ़ जाती है, जिसकी पुरानी सीमा लगभग 40 टूल रही है, जो आपके बिल्ड में अलग हो सकती है। अकेले GitHub दर्जनों टूल दिखा सकता है। जब कुल संख्या सीमा पार करती है, तो हो सकता है कि कुछ सर्वरों के टूल मॉडल तक पहुँचें ही नहीं। मौजूदा प्रोजेक्ट में जिन सर्वरों की ज़रूरत नहीं, उन्हें बंद करें, GitHub टूलसेट इस्तेमाल करें, और प्रोजेक्ट-स्तर की .cursor/mcp.json फ़ाइलें हल्की रखें।
गलत मोड या अनुत्तरित अप्रूवल। MCP टूल Agent मोड में चलते हैं। Ask मोड में मॉडल उन्हें कॉल नहीं कर सकता। डिफ़ॉल्ट रूप से हर कॉल अप्रूवल माँगती है, और अगर आप प्रॉम्प्ट को अनदेखा कर स्क्रॉल कर दें, तो चैट जमी हुई लगती है। कॉल को अप्रूव करें, या भरोसेमंद सर्वरों के लिए auto-run चालू करें। साथ ही सर्वर एंट्री खोलकर पक्का करें कि कोई टूल अलग से बंद तो नहीं किया गया।
💡 टिप: एक अच्छा टेस्ट प्रॉम्प्ट साफ़-साफ़ बताता है: "playwright टूल इस्तेमाल करके example.com खोलें और मुझे पेज का टाइटल बताएँ।" सर्वर का नाम लेने से यह शक नहीं रहता कि मॉडल कौन-सा टूल चुने।
MCP Inspector चलाएँ। आधिकारिक इंस्पेक्टर किसी भी सर्वर को शुरू करता है और उसके टूल की सूची दिखाता है, बिना Cursor के बीच में आए:
npx @modelcontextprotocol/inspector npx -y @playwright/mcp@latest
अगर सर्वर वहाँ कनेक्ट होकर टूल की सूची दिखाता है, पर Cursor में नहीं, तो समस्या Cursor के एनवायरनमेंट में है: PATH, एनवायरनमेंट वेरिएबल या कॉन्फ़िग फ़ाइल में। अगर इंस्पेक्टर में भी विफल होता है, तो समस्या सर्वर या आपकी मशीन में है, और एरर का टेक्स्ट आम तौर पर उसका नाम बता देता है।
किसी LLM से लॉग पढ़वाएँ। लंबे लॉग थकाने वाले होते हैं, और लैंग्वेज मॉडल वह एक ज़रूरी लाइन जल्दी पकड़ लेता है। PicassoIA पर Claude Sonnet 5 के साथ:
REDACTED रखें।GPT 5.6 Sol ज़िद्दी मामलों पर अच्छी दूसरी राय देता है, और Gemini 3.5 Flash बहुत लंबे लॉग पर तेज़ पहला पास देता है। होस्टेड मॉडल में जो भी आप पेस्ट करते हैं, वह आपकी मशीन से बाहर जाता है, इसलिए हर बार पहले सीक्रेट हटा दें।
| लक्षण | संभावित कारण | समाधान |
|---|---|---|
spawn npx ENOENT | Cursor को PATH पर Node नहीं दिखता | npx का एब्सोल्यूट पाथ इस्तेमाल करें |
शुरू होते ही Connection closed | टोकन गायब या लॉन्च पर क्रैश | लॉग में stderr पढ़ें, env वैल्यू जाँचें |
| टूल सूचीबद्ध, कॉल 401 या 403 लौटाती हैं | एक्सपायर या कम स्कोप वाला GitHub टोकन | टोकन दोबारा बनाएँ, SSO के लिए ऑथोराइज़ करें |
docker: command not found | Docker नहीं है या बंद है | Docker Desktop शुरू करें, इमेज पहले से पुल करें |
| Figma कनेक्शन रिफ़्यूज़ करता है | डेस्कटॉप ऐप बंद या MCP सर्वर बंद | डिज़ाइन फ़ाइल खोलें, सर्वर चालू करें |
| Figma 404 लौटाता है | पुराना /sse पाथ | URL को /mcp पर बदलें |
| Playwright एक्ज़ीक्यूटेबल गायब | मेल खाता ब्राउज़र इंस्टॉल नहीं | npx playwright install chrome चलाएँ |
| Playwright ब्राउज़र पहले से इस्तेमाल में | लॉक्ड प्रोफ़ाइल फ़ोल्डर | बाहर की प्रोसेस बंद करें या --isolated जोड़ें |
| हरा डॉट, एजेंट टूल नज़रअंदाज़ करता है | बहुत सारे टूल, या Ask मोड | सर्वर घटाएँ, Agent मोड पर जाएँ |
जब आपके सर्वर ठीक से काम करने लगें, तब MCP कोड से कहीं आगे भी दिलचस्प हो जाता है। PicassoIA अपने जेनरेशन मॉडल अपने MCP कनेक्शन और डेवलपर API के ज़रिए भी उपलब्ध कराता है, जो चार मॉडलों पर आधारित है: PicassoIA Image, Image Editor Pro, PicassoIA Video और ऑडियो के साथ वीडियो के लिए Seedance 2.5 Lite। कनेक्शन आप अपने अकाउंट के MCP पेज पर picassoia.com/en/mcp/accounts से सेट करते हैं, और यह Cursor में किसी भी दूसरे सर्वर की तरह काम करता है, इसलिए ऊपर की हर जाँच इस पर भी लागू होती है।
एक सीमा जानना उपयोगी है जब जॉब रुके हुए लगें: एक अकाउंट एक साथ अधिकतम 5 प्रेडिक्शन चलाता है, जो आपके सभी क्रेडेंशियल और MCP कनेक्शन में साझा होते हैं। छठा जॉब इंतज़ार करता है, और एडिटर से यह किसी अटके हुए सर्वर जैसा दिख सकता है।
हालाँकि, शुरू करने के लिए MCP सर्वर की ज़रूरत नहीं है। वेब ऐप खोलें, एक प्रॉम्प्ट लिखें और कुछ ही सेकंड में नतीजा देखें:
अपने पिछले प्रोजेक्ट की एक असली ज़रूरत चुनें, जैसे README के लिए हीरो इमेज, ब्लॉग पोस्ट का हेडर या डेमो के लिए मॉक प्रोडक्ट फ़ोटो, और तीन वर्ज़न बनाएँ। उनकी तुलना करें, हर बार एक डिटेल बदलें, और जो सही बैठे उसे रखें। Picasso IA खोलें, अपना पहला प्रॉम्प्ट लिखें, और देखें कि आपका अगला प्रोजेक्ट कैसा दिखता है।
अपनी भाषा चुनें
