# समस्या निवारण

Canonical source: https://maguyva.ai/hi/docs/troubleshooting

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

आम Maguyva सेटअप विफलताओं को ठीक करें: API कुंजी समस्याएँ, @maguyva/mcp ब्रिज समस्याएँ, रिपॉज़िटरी लुकअप, और कनेक्शन एरर।

### API कुंजी समस्याएँ

- जाँच लें कि आपकी कुंजी mgv_ प्रीफ़िक्स से शुरू होती है।
- जाँच लें कि आपने कॉन्फ़िग उदाहरणों के mgv_xxxx प्लेसहोल्डर को app.maguyva.ai से मिली अपनी असली कुंजी से बदला है।
- अगर आपका कॉन्फ़िग MAGUYVA_API_KEY से कुंजी पढ़ता है, तो पुष्टि करें कि यह वेरिएबल उस एनवायरनमेंट में सेट है जहाँ से आपका क्लाइंट असल में लॉन्च होता है। ~/.zshrc या ~/.bashrc में जोड़े गए शेल एक्सपोर्ट शेल रीलोड करने के बाद ही लागू होते हैं, और संभव है कि GUI ऐप इन्हें इनहेरिट ही न करें। संदेह हो तो कुंजी सीधे कॉन्फ़िग में लिखें: नेटिव रिमोट कॉन्फ़िग में Authorization हेडर में (Bearer के बाद आपकी कुंजी), या @maguyva/mcp ब्रिज वाले कॉन्फ़िग के env ब्लॉक में।
- पक्का करें कि कुंजी की अवधि समाप्त नहीं हुई है और उसे निरस्त नहीं किया गया है।

### @maguyva/mcp ब्रिज समस्याएँ

- पुष्टि करें कि npx आपके PATH में उपलब्ध है -- ब्रिज को Node.js का काम करता हुआ इंस्टॉल चाहिए। यह कन्फ़र्म करने के लिए कि यह शुरू हो सकता है, टर्मिनल में npx -y @maguyva/mcp --help चलाएँ।
- अपने क्लाइंट के MCP कॉन्फ़िगरेशन सिंटैक्स की जाँच करें -- कुछ क्लाइंट में एक बिगड़ी हुई JSON फ़ाइल चुपचाप फ़ेल हो जाती है।
- कई क्लाइंट को ब्रिज की बिल्कुल ज़रूरत नहीं होती। Claude Code, Maguyva प्लगइन (/plugin install maguyva@maguyva) इस्तेमाल करता है, और Cursor, VS Code, Devin Desktop, और Zed एक Bearer हेडर के साथ नेटिवली रिमोट सर्वर से कनेक्ट होते हैं (Zed, context_servers के ज़रिए)। ब्रिज उन क्लाइंट्स के लिए है जो अपने कॉन्फ़िग से वह हेडर नहीं भेज सकते, जैसे Claude Desktop, जिसकी claude_desktop_config.json सिर्फ़ लोकल सर्वर शुरू करती है। Claude Desktop के कस्टम कनेक्टर authorization रिक्वेस्ट हेडर भेज सकते हैं, लेकिन रिक्वेस्ट हेडर अभी सीमित संगठनों के लिए बीटा में हैं।

### रिपॉज़िटरी नहीं मिली

- सत्यापित करें कि रिपॉज़िटरी app.maguyva.ai में कनेक्टेड और इंडेक्स्ड है।
- फ़ॉर्मैट जाँचें: "owner/repo" डिफ़ॉल्ट ब्रांच को लक्षित करता है, "owner/repo:branch" किसी विशिष्ट ब्रांच को लक्षित करता है (उदा. "owner/repository:develop")।
- पक्का करें कि आपके खाते के पास रिपॉज़िटरी तक एक्सेस है।
- repository_context(action="info", repository="...") से रिपॉज़िटरी रिज़ॉल्यूशन देखें; केवल तब ही रिपॉज़िटरी पैरामीटर छोड़ें जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है।

### MCP कनेक्शन समस्याएँ

- अपनी मशीन से https://maguyva.tools/mcp तक कनेक्टिविटी टेस्ट करें -- कॉर्पोरेट प्रॉक्सी और फ़ायरवॉल आमतौर पर इसकी वजह होते हैं।
- जाँचें कि आपका API टोकन वैध है और उसकी समय-सीमा समाप्त नहीं हुई है।
- अपने क्लाइंट की इंस्टॉलेशन गाइड से कॉन्फ़िग का दोबारा मिलान करें -- कॉन्फ़िग फ़ाइल की लोकेशन और संरचना हर क्लाइंट में अलग होती है।

### फ़िक्स को वेरिफ़ाई करें

किसी भी बदलाव के बाद, अपने एजेंट से "मेरे पास कौन-सी रिपॉज़िटरी कनेक्टेड हैं?" पूछें -- यह कनेक्शन को शुरू से आख़िर तक वेरिफ़ाई कर देता है। फिर अपनी रिपॉज़िटरी के बारे में कोई असली सवाल पूछें; आपको अपनी कनेक्टेड रिपॉज़िटरी से फ़ाइल पाथ और लाइन नंबर के साथ जवाब दिखने चाहिए।