MCP जुड़ा है पर काम नहीं कर रहा? Mono में विफलता का चरण खोजें
पता लगाएँ कि Mono की MCP समस्या ट्रांसपोर्ट, प्राधिकरण, क्षमता खोज, मॉडल समर्थन या टूल कॉल से जुड़ी है, फिर एक सीमित रीड-ओनली परीक्षण करें।
सहेजा गया MCP सर्वर इस बात का सबूत नहीं कि टूल काम करता है। पता सही हो सकता है, फिर भी साइन इन अधूरा हो सकता है। साइन इन सफल हो सकता है, फिर भी सर्वर के टूल लोड न हों। और कोई टूल लोड होकर भी गलत अनुरोध पा सकता है। कोई सेटिंग बदलने से पहले वह पहला चरण खोजें जो विफल होता है।
यह गाइड Mono by Reunified में समस्याएँ सुलझाने के बारे में है, जो अभी उपलब्ध नहीं है (प्रतीक्षा सूची में जुड़ें)। पहली बार कनेक्ट करने के लिए MCP सेटअप मार्गदर्शिका देखें। यहाँ लक्ष्य है धुंधले “काम नहीं कर रहा” को एक साफ़ अवलोकन में बदलना जिसे दोहराया जा सके, बिना गलती से कोई लिखने वाली कार्रवाई दोहराए।
1. लक्षण लिखें और अनिश्चित दोबारा कोशिश रोकें
सर्वर का नाम, ट्रांसपोर्ट, डिवाइस, ऐप वर्ज़न, आप क्या करना चाहते थे और सटीक त्रुटि लिखें, सीक्रेट हटाकर। यह भी लिखें कि क्या यही सेटअप पहले काम करता था और तब से क्या बदला। “साइन इन के बाद टूल सूची खाली है” कहना “MCP खराब है” से ज़्यादा उपयोगी है।
अगर पिछला अनुरोध कुछ बना, भेज या बदल सकता था, तो दोबारा कोशिश से पहले गंतव्य जाँचें। जवाब खो जाने का मतलब यह नहीं कि कार्रवाई नहीं हुई। जाँच के लिए किसी छोटे, सिर्फ़ पढ़ने वाले अनुरोध पर जाएँ, जैसे किसी टेस्ट प्रोजेक्ट का एक आइटम सूचीबद्ध करना जिसे आप जाँच सकें।
आखिरी काम करने वाली सेटिंग की एक निजी कॉपी रखें। किसी सार्वजनिक सहायता अनुरोध में टोकन, ऑथराइज़ेशन कोड या टूल का निजी आउटपुट न चिपकाएँ।
2. खाते से पहले ट्रांसपोर्ट जाँचें
Mono में HTTP कनेक्शन को MCP सर्वर का पता चाहिए, कोई सामान्य होमपेज या मॉडल API का पता नहीं। पूरे URL, पाथ सहित, की तुलना सर्वर प्रकाशक के मौजूदा दस्तावेज़ों से करें। ब्राउज़र में खुलने वाला पेज सिर्फ़ यह दिखाता है कि वह पेज पहुँच में है, यह नहीं कि वहाँ MCP काम करता है।
मानक इनपुट/आउटपुट (stdio) के लिए, उस डिवाइस पर कमांड और आर्ग्युमेंट जाँचें जिसे उन्हें शुरू करना है। दोबारा साइन इन करने से गायब कमांड या उसे न चला सकने वाला डिवाइस ठीक नहीं होता। फ़ोन और कंप्यूटर अलग हैं, इसलिए कंप्यूटर की कमांड के फ़ोन पर चलने की उम्मीद न करें।
localhost वाला पता अनुरोध भेजने वाले डिवाइस को दर्शाता है। असली डिवाइस से, समर्थित और साइन-इन रास्ते से जाँच करें। सिर्फ़ टेस्ट पास कराने के लिए किसी चालू सर्वर के एक्सेस नियंत्रण कमज़ोर न करें।
3. सहेजी सेटिंग और पूरी हुई अनुमति अलग करें
देखें कि आपने कौन-सा प्रमाणीकरण तरीका चुना है। Bearer टोकन के लिए उसके फ़ील्ड में सेवा का सही टोकन चाहिए। OAuth के लिए सही खाता, सर्वर की शर्तें और Mono में पूरी वापसी चाहिए; ब्राउज़र जल्दी बंद करना सफल साइन इन नहीं है।
Mono साइन इन पूरा होने से पहले भी सर्वर सहेज सकता है, इसलिए सहेजा सर्वर यह साबित नहीं करता कि साइन इन सफल रहा। सफल साइन इन के बाद भी सर्वर के टूल कुछ समय तक लोड होने में विफल हो सकते हैं। न सहेजी गई प्रविष्टि, न “से कनेक्ट हो गया” संदेश यह साबित करता है कि कोई खास टूल तैयार है।
अगर आप सर्वर का URL या ट्रांसपोर्ट बदलते हैं, तो Mono उसे नया कनेक्शन मानता है, इसलिए हो सकता है आपको फिर से साइन इन करना पड़े। पते की असली गलती ठीक करें, पर काम कर रहे URL को सामान्य रीसेट की तरह बार-बार न बदलें। मान अंदाज़े से भरने के बजाय प्रकाशक की बताई क्लाइंट और रीडायरेक्ट सेटिंग अपनाएँ।
4. क्षमताएँ और चुना गया मॉडल जाँचें
MCP आर्किटेक्चर टूल, संसाधन और प्रॉम्प्ट में फ़र्क करता है। कोई सर्वर इनमें से कुछ ही दे सकता है, इसलिए सिर्फ़ संसाधन देने वाला सर्वर सहायक को बुलाने लायक कोई टूल नहीं देगा।
इंस्टॉल किए गए MCP स्किल में उसका कॉन्फ़िगरेशन वाला हिस्सा खोलें और देखें कि Mono ने कौन-से टूल पाए। अगर वह खाली है, तो साइन इन जाँचें और देखें कि सर्वर अपने टूल दिखाता है या नहीं; यह न मानें कि सेवा की हर कार्रवाई उपलब्ध है। सर्वर सहेजना पूरी सेहत जाँच नहीं है।
चैट में इस्तेमाल हो रहा मॉडल भी जाँचें। हर मॉडल टूल नहीं बुला सकता, आपके खुद जोड़े कुछ मॉडल भी नहीं। जो मॉडल टेक्स्ट में अच्छे जवाब देता है, वही इस बात की वजह हो सकता है कि जुड़ा हुआ टूल कभी इस्तेमाल न हो। कस्टम एंडपॉइंट मार्गदर्शिका इसे समझाती है।
5. एक ज्ञात कार्रवाई जाँचें
एक सुरक्षित अनुरोध इस्तेमाल करें और नतीजे की तुलना मूल सेवा से करें:
मेरे बताए मौजूदा डेमो आइटम का शीर्षक पढ़ें।
कुछ बनाएँ, संपादित, भेजें या हटाएँ नहीं।
पहुँच विफल हो तो शीर्षक का अनुमान लगाने के बजाय विफलता बताएँ।| अवलोकन | अगली जाँच |
|---|---|
| पते से जुड़ नहीं पा रहे | पता, ट्रांसपोर्ट, डिवाइस नेटवर्क और सर्वर चालू है या नहीं |
| साइन इन पूरा नहीं होता | खाता, प्रमाणीकरण तरीका और प्रकाशक की OAuth शर्तें |
| कोई टूल नहीं दिखता | सर्वर क्या देता है, उसके टूल लोड हुए या नहीं, और मॉडल टूल समर्थन करता है या नहीं |
| एक टूल विफल होता है | ज़रूरी जानकारी, सेवा की अनुमतियाँ और लौटी त्रुटि |
| पढ़ना सफल, लिखना अवरुद्ध | आप कितनी पहुँच देना चाहते थे और टूल की अनुमति सेटिंग; सब कुछ न खोलें |
टूल की अपनी त्रुटि और खाली लेकिन सफल नतीजा, दोनों अलग चीज़ें हैं। लौटी स्थिति और ज़रूरी टेक्स्ट, सीक्रेट हटाकर, साथ रखें।
6. सुधार की पुष्टि करें और सहायता रिकॉर्ड रखें
एक बार में एक ही चीज़ बदलें, वही सिर्फ़ पढ़ने वाली जाँच दोहराएँ और नतीजा लिखें। अगर बाद में लिखने वाली कार्रवाई चाहिए, तो उसका सटीक लक्ष्य जाँचें और दोबारा कोशिश से पहले सेवा में नतीजे की पुष्टि करें।
विफल चरण, वर्ज़न, किया गया बदलाव और आखिरी सफल जाँच का छोटा नोट रखें। Mono में कनेक्शन हटाना और प्रदाता के यहाँ पहुँच रद्द करना अलग कदम हैं। इस्तेमाल के दौरान अनुमति के फ़ैसलों के लिए टूल अनुमतियों की समीक्षा पढ़ें; बार-बार मंज़ूरी देने से कनेक्शन ठीक नहीं होता।
