Cursor में Supabase MCP काम नहीं कर रहा? सेटअप और समाधान

आपने Cursor में Supabase सर्वर जोड़ा, एडिटर को रीस्टार्ट किया, और अब MCP पैनल में लाल डॉट, खाली टूल लिस्ट, या ऐसा स्पिनर दिख रहा है जो रुकता ही नहीं। या फिर कनेक्शन दिखता है, फिर भी Agent कहता है कि उसके पास डेटाबेस टूल नहीं हैं। "कॉन्फ़िगर" और "काम करता हुआ" के बीच का यही अंतर Cursor Supabase MCP काम नहीं कर रहा की सबसे आम स्थिति है, और लगभग हर मामला कुछ गिने-चुने कारणों तक पहुँचता है: कॉन्फ़िग फ़ाइल गलत जगह पर होना, अधूरा लॉगिन, पुराना OAuth रजिस्ट्रेशन, स्कोप्ड URL जो टूल छिपा देता है, कई सर्वरों में बहुत ज़्यादा टूल, Windows की npx वाली दिक़्क़त, रुका हुआ प्रोजेक्ट, या ऐसा अप्रूवल प्रॉम्प्ट जिस पर किसी ने क्लिक नहीं किया। यहाँ हर कारण उसी क्रम में है जिस क्रम में जाँचना सबसे उपयोगी है, साथ में सटीक कॉन्फ़िग, सिम्प्टम टेबल और वे लॉग जाँच जो एक दोपहर बचा देती हैं।

Cursor और Supabase का लिंक कैसे काम करता है

MCP, यानी Model Context Protocol, किसी एडिटर के AI Agent को बाहरी टूल कॉल करने देता है। Supabase एक MCP सर्वर प्रकाशित करता है, जिसके टूल Agent को टेबल की सूची देखने, SQL चलाने, माइग्रेशन लागू करने, प्रोजेक्ट लॉग पढ़ने और डॉक्स खोजने देते हैं। Cursor क्लाइंट है। वह एक JSON फ़ाइल पढ़ता है, सर्वर से संपर्क करता है या उसे लॉन्च करता है, टूल लिस्ट माँगता है, और वे टूल सेटिंग्स में दिखाता है।

जब कुछ टूटता है, तो वह चार चरणों में से किसी एक पर टूटता है, और यह जानना खोज को आधा कर देता है:

1. कॉन्फ़िग पढ़ना: फ़ाइल गायब है, अमान्य है, या गलत फ़ोल्डर में है।
2. कनेक्शन: URL तक पहुँचा नहीं जा सकता या कमांड लॉन्च नहीं हो सकती।
3. ऑथेंटिकेशन: ब्राउज़र लॉगिन पूरा नहीं हुआ, या टोकन गलत है।
4. टूल लिस्टिंग: सर्वर कनेक्ट हो गया, लेकिन आपके पैरामीटर टूल छिपा रहे हैं या Agent ओवरलोड है।

होस्टेड सर्वर बनाम लोकल npx

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

💡 एक ही चुनें। अगर एक ही सर्वर नाम दो कॉन्फ़िग फ़ाइलों में दिखे, या रिमोट एंट्री और npx एंट्री दोनों supabase पर दावा करें, तो आप गलत वाली को डीबग करने में एक घंटा लगा सकते हैं।

mcp.json कहाँ होना चाहिए

Cursor दो जगह पढ़ता है। .cursor/mcp.json पर मौजूद प्रोजेक्ट फ़ाइल उस रिपॉज़िटरी पर लागू होती है। ~/.cursor/mcp.json पर मौजूद यूज़र फ़ाइल हर जगह लागू होती है, और अगर आप हर प्रोजेक्ट के लिए एक ही कॉन्फ़िग चाहते हैं, तो Supabase के डॉक्स इसी फ़ाइल की ओर इशारा करते हैं।

तीन गलतियाँ कई लाल डॉट्स की वजह बनती हैं: mcp.json को .cursor के अंदर रखने के बजाय रिपो की रूट में सेव करना, ऐसा ट्रेलिंग कॉमा छोड़ना जो JSON को अमान्य कर दे, और टॉप-लेवल mcpServers प्रॉपर्टी की स्पेलिंग गलत लिखना। सर्वर को दोष देने से पहले फ़ाइल को किसी भी JSON वैलिडेटर में डालकर देख लें।

वह साफ़ सेटअप जो काम करता है

समाधान आज़माने से पहले ज्ञात अच्छी स्थिति से शुरू करें। आधी-अधूरी एडिट की गई एंट्री हटाएँ, फिर नीचे दिए कॉन्फ़िग में से ठीक एक जोड़ें।

ब्राउज़र लॉगिन के साथ रिमोट URL

होस्टेड सर्वर को सिर्फ़ एक URL चाहिए:

{
  "mcpServers": {
    "supabase": {
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

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

फ़ाइल सेव करें, Cursor रीस्टार्ट करें, और Settings > Cursor Settings > Tools & MCP खोलें। Supabase एंट्री लॉगिन का विकल्प दिखानी चाहिए। ब्राउज़र विंडो खुलती है, आप Supabase में साइन इन करते हैं, और अपनी ऑर्गनाइज़ेशन को एक्सेस दे देते हैं। अगर आप टर्मिनल पसंद करते हैं, तो Cursor CLI में तीन मिलते-जुलते कमांड हैं:

agent mcp enable supabase
agent mcp login supabase
agent mcp list

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

फिर नई Agent चैट में Supabase का सुझाया स्मोक टेस्ट चलाएँ: "What tables exist in my database? Use MCP tools." आपकी टेबल के नामों वाला असली जवाब बताता है कि पूरी चेन काम कर रही है। टूल न मिलने की माफ़ी का मतलब है कि नीचे दिए समाधानों में से कोई लागू होता है।

टोकन और npx फ़ॉलबैक

कुछ टीमें अब भी सर्वर को लोकली चलाती हैं, अपने Supabase अकाउंट सेटिंग्स में बनाए गए पर्सनल एक्सेस टोकन के साथ। कॉन्फ़िग npx के ज़रिए पैकेज लॉन्च करता है:

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--read-only",
        "--project-ref=<your-project-ref>"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "<personal-access-token>"
      }
    }
  }
}

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

इस रूट के लिए Node.js इंस्टॉल होना ज़रूरी है। --read-only और --project-ref फ़्लैग वही काम करते हैं जो आगे बताए गए URL पैरामीटर करते हैं। टोकन को पासवर्ड की तरह मानें: ऐसा mcp.json कभी पब्लिक रिपॉज़िटरी में कमिट न करें जिसमें यह टोकन हो। Supabase ने समय के साथ अपना अनुशंसित सेटअप बदला है, इसलिए अगर उसके मौजूदा निर्देश इस स्निपेट से अलग हों, तो Supabase डैशबोर्ड का MCP कनेक्शन टैब देखें।

Windows को cmd रैपर चाहिए

Windows पर npx एक batch shim है, और इसे सीधे लॉन्च करने पर अक्सर spawn एरर आता है। इसे cmd /c में लपेटें:

{
  "mcpServers": {
    "supabase": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--read-only",
        "--project-ref=<your-project-ref>"
      ],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "<personal-access-token>"
      }
    }
  }
}

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

पहले एक नए टर्मिनल में node --version और npx --version चलाएँ। अगर Node, Cursor शुरू होने के बाद इंस्टॉल हुआ था, तो एडिटर के पास पुराना PATH है, इसलिए Cursor को पूरी तरह बंद करके दोबारा खोलें, सिर्फ़ विंडो नहीं। होस्टेड URL वाला रूट इन सबसे बच जाता है, और सख्त टूलचेन वाली Windows मशीनों पर इसे चुनने की यह अच्छी वजह है।

आठ सिम्प्टम और उनके समाधान

जो दिख रहा है उसे किसी एक पंक्ति से मिलाएँ, फिर नीचे संबंधित सेक्शन पर जाएँ।

लाल डॉट और खाली टूल लिस्ट

लाल डॉट का मतलब है कि Cursor को कभी काम करता कनेक्शन नहीं मिला, इसलिए सबसे आसान जाँचों से शुरू करें। JSON वैलिडेट करें, पक्का करें कि फ़ाइल .cursor/mcp.json या ~/.cursor/mcp.json पर है, और MCP सेटिंग्स में रिफ़्रेश कंट्रोल दबाएँ। Cursor फ़ोरम पर कुछ यूज़र्स के लिए इससे रुके हुए सर्वर फिर चालू हो गए हैं। हर कॉन्फ़िग बदलाव के बाद Cursor रीस्टार्ट करें, क्योंकि Supabase के अपने नोट्स कहते हैं कि सारे टूल दिखने से पहले रीस्टार्ट ज़रूरी है।

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

लॉगिन लूप और client_id एरर

होस्टेड सर्वर के साथ, Cursor localhost:8787 पर एक पेज खोलकर OAuth हैंडऑफ़ पूरा करता है। वहाँ दो तरह की विफलताएँ दिखती हैं।

• साइन-इन पूरा होने से पहले 431 एरर। आपके दूसरे डेव सर्वर localhost के लिए जो बड़ी कुकीज़ सेव करते हैं, वे इसे ट्रिगर कर सकती हैं। सिर्फ़ localhost की कुकीज़ साफ़ करें, पूरा ब्राउज़र नहीं, फिर लॉगिन दोबारा करें।
• "Unrecognized client_id"। Cursor किसी पुराने सेटअप का कैश्ड OAuth रजिस्ट्रेशन दोबारा इस्तेमाल कर रहा है। सर्वर डिस्कनेक्ट करें, हटाएँ, Cursor को पूरी तरह बंद करें, और फिर से जोड़ें ताकि नया रजिस्ट्रेशन हो।

अगर ब्राउज़र खुलता ही नहीं, तो Cursor के लॉग में authorization URL देखें, उसे हाथ से अपने ब्राउज़र में पेस्ट करें, साइन-इन पूरा करें, और कॉलबैक Cursor पर लौटकर कनेक्शन स्थापित कर देना चाहिए।

कनेक्टेड, पर टूल गायब हैं

हरे डॉट के साथ जो Agent अपने टूल नहीं देख पाता, वह आमतौर पर वही कॉन्फ़िगरेशन है जो आपने जैसा कहा वैसा ही कर रहा है। चार URL पैरामीटर बदलते हैं कि कौन-से टूल मौजूद हैं:

स्कोप्ड उदाहरण कुछ ऐसा दिखता है: https://mcp.supabase.com/mcp?project_ref=abc123&read_only=true

तीन नतीजे लोगों को चौंकाते हैं। project_ref जोड़ने से अकाउंट टूल बंद हो जाते हैं, इसलिए प्रोजेक्ट लिस्टिंग का गायब होना अपेक्षित है। Storage ग्रुप डिफ़ॉल्ट रूप से बंद होता है और उसे चालू करना पड़ता है। और read_only=true डिज़ाइन के अनुसार हर राइट को फ़ेल करता है। Agent से पूछें कि वह अभी कौन-से सभी Supabase टूल कॉल कर सकता है, फिर उस सूची को अपने पैरामीटर से मिलाएँ।

💡 skip_elicitations एक सुरक्षा जाल हटा देता है। इसे सिर्फ़ डिस्पोज़ेबल डेव प्रोजेक्ट पर इस्तेमाल करें, कभी प्रोडक्शन डेटा के पास नहीं।

अप्रूवल और रुके हुए प्रोजेक्ट

दो आख़िरी कारण विफलता जैसे दिखते हैं, पर होते नहीं। पहला, Cursor आम तौर पर MCP टूल चलाने से पहले पूछता है, इसलिए जो Agent जमा हुआ लगे, वह चैट में ऊपर किसी अप्रूवल बटन का इंतज़ार कर रहा हो सकता है। पक्का करें कि आप Agent मोड में हैं, क्योंकि टूल वहीं चलते हैं।

दूसरा, प्रोजेक्ट खुद पॉज़ हो सकता है। फ़्री टियर प्रोजेक्ट लगभग एक हफ़्ते की निष्क्रियता के बाद पॉज़ हो सकते हैं, और पॉज़ किए गए डेटाबेस पर क्वेरी तब भी फ़ेल होती है जब MCP लिंक स्वस्थ हो। इसे Supabase डैशबोर्ड में फिर से शुरू करें और दोबारा कोशिश करें।

अनुमान लगाने से पहले लॉग पढ़ें

ऊपर का हर समाधान तब और तेज़ हो जाता है जब आप असली एरर पढ़ लेते हैं। फ़्लैग का अंदाज़ा लगाने से मूल समस्या के ऊपर नई समस्याएँ जुड़ सकती हैं।

Cursor लॉग कहाँ सेव करता है

View मेनू से Output पैनल खोलें और चैनल ड्रॉपडाउन में अपने Supabase सर्वर की MCP एंट्री चुनें। सर्वर रीस्टार्ट करें, फिर आख़िरी 20 लाइनें पढ़ें। आम पैटर्न ये हैं:

सिर्फ़ नेटवर्क पाथ की जाँच के लिए टर्मिनल से curl -i https://mcp.supabase.com/mcp चलाएँ। कोई भी HTTP स्टेटस, यहाँ तक कि 401 भी, साबित करता है कि होस्ट तक पहुँचा जा सकता है। Timeout या TLS एरर का मतलब है कि समस्या Cursor में नहीं, बल्कि VPN, proxy या firewall में है।

दस मिनट की चेकलिस्ट

गहराई में जाने के बजाय जल्दी से जाँच करनी हो, तो यह सूची क्रम से चलाएँ:

1. JSON वैलिडेट करें और फ़ाइल की जगह की पुष्टि करें।
2. दोनों कॉन्फ़िग फ़ाइलों में सिर्फ़ एक supabase एंट्री रखें।
3. npx रूट इस्तेमाल करते हैं तो node --version और npx --version जाँचें।
4. Windows पर npx को cmd /c में लपेटें।
5. Cursor को पूरी तरह बंद करके दोबारा खोलें।
6. ब्राउज़र लॉगिन पूरा करें, 431 पर localhost की कुकीज़ साफ़ करते हुए।
7. "Unrecognized client_id" एरर पर एंट्री हटाकर दोबारा जोड़ें।
8. URL में project_ref, features और read_only जाँचें।
9. Agent मोड पर जाएँ और लंबित टूल कॉल को अप्रूव करें।
10. पक्का करें कि Supabase प्रोजेक्ट पॉज़ नहीं है।

बहुत ज़्यादा टूल Agent को नुकसान पहुँचाते हैं

जब आपके सभी सर्वरों के टूल 40 से ऊपर जाते हैं, तो Cursor "Exceeding total tools limit" की चेतावनी देता है, और बताता है कि बहुत ज़्यादा टूल परफ़ॉर्मेंस घटा सकते हैं और कुछ मॉडल 40 से ज़्यादा का पालन नहीं कर सकते। नए बिल्ड टूल कॉन्टेक्स्ट को डायनामिक रूप से लोड करते हैं, और कुछ यूज़र्स बताते हैं कि 80 से ज़्यादा टूल चालू होने पर भी कोई चेतावनी नहीं आती।

चेतावनी पहले से नरम है, पर मूल समस्या बनी हुई है: दर्जनों मिलते-जुलते टूल के बीच चुनने वाला Agent खराब चुनता है, और छोटे मॉडल सबसे पहले लड़खड़ाते हैं। 40 टूल की सीमा पर Cursor फ़ोरम का थ्रेड दिखाता है कि यह सीमा समय के साथ कैसे बदली है।

टूल लिस्ट छोटी करें

• इस सेशन में जो सर्वर इस्तेमाल नहीं कर रहे, उन्हें बंद करें।
• जब आपको सिर्फ़ SQL और डॉक्युमेंटेशन चाहिए, तब features=database,docs से Supabase को सीमित करें।
• MCP सेटिंग्स में अलग-अलग टूल नाम पर क्लिक करके वे बंद करें जिन्हें आप कभी कॉल नहीं करते।
• प्रोजेक्ट-विशिष्ट सर्वर .cursor/mcp.json में और सामान्य सर्वर यूज़र फ़ाइल में रखें।

भरोसा करने से पहले लॉक करें

एक MCP सर्वर जो SQL चला सकता है, उसे डेटाबेस लॉगिन जितनी ही सावधानी चाहिए। Supabase की अपनी सिफ़ारिश सीधी है: प्रोडक्शन से तभी जुड़ें जब ज़रूरी हो, और जुड़ें तो प्रोजेक्ट स्कोपिंग, रीड-ओनली मोड और सीमित फ़ीचर ग्रुप इस्तेमाल करें।

रीड-ओनली मोड और प्रोजेक्ट स्कोपिंग

तीन सेटिंग्स ज़्यादातर सुरक्षा करती हैं। read_only=true क्वेरी को सिर्फ़-पढ़ने वाले Postgres यूज़र के रूप में चलाता है। project_ref सर्वर को एक प्रोजेक्ट तक सीमित करता है। features टूल ग्रुप को उन तक छाँटता है जिनकी आपको ज़रूरत है। Supabase ऐसी किसी भी चीज़ से पहले कन्फ़र्मेशन डायलॉग दिखाता है जो बिल होने वाले रिसोर्स बनाती है, इसलिए उन्हें अपने-आप अप्रूव न करें। बिना निगरानी वाली रूटीन हमेशा सिर्फ़-पढ़ने के मोड में चलनी चाहिए।

प्रॉम्प्ट इंजेक्शन ही असली जोखिम है

LLM से जुड़ा मुख्य ख़तरा है डेटा में छिपे दुर्भावनापूर्ण निर्देश। कल्पना करें कि सपोर्ट टिकट की एक पंक्ति का टेक्स्ट मॉडल से कहता है कि पहले के निर्देश भूल जाए और users टेबल एक्सपोर्ट करे। अगर Agent उस पंक्ति को किसी टूल से पढ़ता है, तो वह टेक्स्ट को कमांड समझ सकता है। टूल कॉल पर मैन्युअल अप्रूवल चालू रखें, और हर SQL स्टेटमेंट अप्रूव करने से पहले पढ़ें। Supabase का MCP डॉक्युमेंटेशन इन सुरक्षाओं की पूरी सूची देता है।

💡 कनेक्शन एक डिस्पोज़ेबल डेव प्रोजेक्ट पर बनाएँ और टेस्ट करें। असली ग्राहक डेटा वाली किसी चीज़ पर तभी जाएँ जब रीड-ओनली मोड और प्रोजेक्ट स्कोपिंग पहले से लागू हों।

किसी मॉडल से लॉग पढ़वाएँ

जब लॉग लाइनें समझ में न आएँ, तो LLM एक तेज़ दूसरी जोड़ी आँखों की तरह काम कर सकता है। Picasso IA पर Claude Sonnet 5 कोडिंग टास्क ऑटोमेट करने के लिए बना है, GPT 5.6 Sol जटिल कोडिंग टास्क हल करने के लिए, और Gemini 3.1 Pro तीखे सामान्य जवाबों के लिए। इनमें से कोई भी स्टैक ट्रेस को संदिग्ध कारणों की छोटी सूची में बदल सकता है।

कुछ भी पेस्ट करने से पहले एक्सेस टोकन, संवेदनशील प्रोजेक्ट refs और डेटाबेस URL हटा दें। लॉग के अंश को इनकी शायद ही ज़रूरत होती है, और चैट विंडो तिजोरी नहीं है।

कॉन्फ़िग बग के लिए एक प्रॉम्प्ट

मॉडल को वे तथ्य दें जिनका वह अंदाज़ा नहीं लगा सकता:

I use Cursor on Windows 11 with the hosted Supabase MCP server.
The MCP panel shows a red dot. My mcp.json (secrets removed) is below,
plus the last 20 lines from the MCP output channel.
List the three most likely causes, ranked, with one check for each.

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

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

Picasso IA पर खुद आज़माएँ

इस तरह का समाधान सिर्फ़ कॉन्फ़िग के लंबे-चौड़े ब्लॉक से ज़्यादा का हक़दार है। ब्लॉग पोस्ट, इंटरनल रनबुक या टीम डॉक्युमेंट स्टॉक स्क्रीनशॉट की जगह असली फ़ोटोग्राफ़ी के साथ बेहतर लगते हैं, और Picasso IA एक सादा टेक्स्ट प्रॉम्प्ट को सेकंडों में इमेज में बदल देता है। साफ़ और विस्तृत फ़ोटो के लिए Seedream 4.5 आज़माएँ, या जब आप सादे प्रॉम्प्ट को सटीक दृश्य में बदलना चाहते हैं, तब GPT Image 2।

एक स्टार्टर प्रॉम्प्ट: "Overhead photograph of a developer's desk at sunrise, laptop open to a blurred code editor, ceramic mug, visible oak wood grain, 35mm lens, soft window light, Kodak Portra 400 film grain." लेंस, रोशनी या कोण बदलें, और हर वैरिएशन हेडर इमेज का नया विकल्प बन जाता है। पूरा कैटलॉग picassoia.com/en/all-models पर ब्राउज़ करें और आज ही अपनी पहली इमेज बनाएँ।