| समस्या |
गड़बड़ी का मैसेज |
वजह |
समस्या को ठीक करने / हल करने का तरीका |
"फ़ेच टूल" के काम न करने की वजह नहीं बताई गई है |
"एमसीपी सर्वर की जानकारी फ़ेच नहीं की जा सकी. कृपया फिर से कोशिश करें." (या टूल फ़ेच करें बटन, गड़बड़ी का कोई मैसेज दिखाए बिना काम नहीं करता). |
अमान्य यूआरएल, ऑफ़लाइन सर्वर या नेटवर्क की गड़बड़ी की वजह से, Connected Console आपके एमसीपी एंडपॉइंट के अनुरोध को पूरा नहीं कर सका. |
इन बातों की पुष्टि करें:
- पक्का करें कि आपके एमसीपी एंडपॉइंट का यूआरएल सही हो और उसमें
https:// का इस्तेमाल किया गया हो.
- पक्का करें कि आपका एमसीपी सर्वर चालू हो.
- पुष्टि करें कि आपका एमसीपी सर्वर, सार्वजनिक इंटरनेट से ऐक्सेस किया जा सकता हो. Google,
localhost या निजी इंट्रानेट पतों को ऐक्सेस नहीं कर सकता.
|
एमसीपी सर्वर से कनेक्ट नहीं किया जा सका |
"एमसीपी सर्वर से कनेक्ट नहीं किया जा सका" |
Google का बैकएंड, आपके एमसीपी एंडपॉइंट से कनेक्ट नहीं हो सका. |
इसकी सामान्य वजहें और उन्हें ठीक करने के तरीके यहां दिए गए हैं:
- फ़ायरवॉल से जुड़ी पाबंदियां: पक्का करें कि आपका फ़ायरवॉल या WAF, Google की आउटबाउंड आईपी रेंज को ब्लॉक न करे.
- एपीआई गेटवे के नियम: पुष्टि करें कि आपका एपीआई गेटवे,
POST अनुरोधों को स्वीकार करता हो. साथ ही, एमसीपी initialize हैंडशेक के दौरान, Google के clientInfo अनुरोधों को अस्वीकार न करता हो.
- सबडोमेन का मेल न खाना: अगर किसी खास सबडोमेन (जैसे,
gemini.mcp.company.com) का इस्तेमाल किया जा रहा है, तो पक्का करें कि उसका /.well-known/oauth-protected-resource मेटाडेटा, उस सबडोमेन से मेल खाता हो. साथ ही, वह किसी दूसरे बेस डोमेन (mcp.company.com) पर रीडायरेक्ट न करता हो.
|
एमसीपी ट्रांसपोर्ट काम नहीं करता (एचटीटीपी 405) |
"एमसीपी सर्वर ने अनुरोध को अस्वीकार कर दिया (एचटीटीपी 405 मेथड नॉट अलाउड). पक्का करें कि यूआरएल, स्ट्रीम किए जा सकने वाले ऐसे एचटीटीपी एंडपॉइंट पर ले जाता हो जो पोस्ट अनुरोधों को स्वीकार करता है. यह ज़रूरी है कि यूआरएल, लेगसी एसएसई एंडपॉइंट पर न ले जाता हो." |
एंडपॉइंट यूआरएल, लेगसी एचटीटीपी+एसएसई एंडपॉइंट पर ले जाता है. यह एंडपॉइंट, सिर्फ़ GET अनुरोधों को स्वीकार करता है या JSON-RPC POST अनुरोधों को अस्वीकार करता है. |
अपने एमसीपी सर्वर और एंडपॉइंट यूआरएल को अपडेट करें, ताकि एमसीपी स्ट्रीम किए जा सकने वाले एचटीटीपी ट्रांसपोर्ट का इस्तेमाल किया जा सके. यह initialize और tools/list के लिए POST अनुरोधों को स्वीकार करता है.
|
OAuth से सुरक्षित की गई संसाधन फ़ाइल मौजूद नहीं है |
"एमसीपी सर्वर पर, /.well-known/oauth-protected-resource फ़ाइल मौजूद नहीं है" |
Google ने OAuth 2.0 के सुरक्षित किए गए संसाधन के मेटाडेटा की खोज (आरएफ़सी 9728) करने की कोशिश की, जो पूरी नहीं हो सकी. |
- अगर आपके एमसीपी सर्वर के लिए पुष्टि करना ज़रूरी नहीं है: आम तौर पर, यह गड़बड़ी तब होती है, जब एमसीपी एंडपॉइंट के यूआरएल में टाइपिंग की कोई गड़बड़ी हो या पाथ सेगमेंट मौजूद न हो. उदाहरण के लिए,
https://mcp.example.com/mcp के बजाय https://mcp.example.com. साथ ही, HTTP 404 या 500 दिखाता है. इस वजह से, क्लाइंट OAuth डिस्कवरी पर वापस चला जाता है. पुष्टि करें कि आपके एमसीपी एंडपॉइंट का सटीक पाथ, बिना पुष्टि वाले POST initialize और tools/list अनुरोधों के लिए HTTP 200 OK दिखाता हो. इसके बाद, ऐक्सेस क्रेडेंशियल में जाकर, क्या आपके सर्वर को अनुमति की ज़रूरत है? में नहीं को चुनें.
- अगर आपके एमसीपी सर्वर को पुष्टि करने की ज़रूरत है: अपने एमसीपी सर्वर पर एक मान्य
/.well-known/oauth-protected-resource JSON फ़ाइल होस्ट करें. इसमें authorization_servers कलेक्शन में, अनुमति देने वाले आपके भरोसेमंद सर्वर की जानकारी होनी चाहिए.
|
OAuth की मदद से अनुमति देने वाले सर्वर का मेटाडेटा मौजूद नहीं है या अमान्य है |
"OAuth सर्वर पर, /.well-known/oauth-authorization-server फ़ाइल मौजूद नहीं है" या "इसमें अमान्य या अधूरा JSON है" |
आपका OAuth सर्वर, /.well-known/oauth-authorization-server पर आरएफ़सी 8414 के मुताबिक मान्य मेटाडेटा दस्तावेज़ नहीं दिखाता है. |
/.well-known/oauth-authorization-server (या /.well-known/openid-configuration) पर, आरएफ़सी 8414 के मुताबिक खोज से जुड़ा मान्य दस्तावेज़ होस्ट करें. इसमें authorization_endpoint और token_endpoint शामिल होने चाहिए.
- इसके अलावा, क्रेडेंशियल सेक्शन में जाकर, कस्टम ऑथराइज़ेशन एंडपॉइंट और कस्टम टोकन एंडपॉइंट के यूआरएल मैन्युअल तरीके से डालें.
|
डोमेन की पुष्टि न हो पाना |
डोमेन सर्टिफ़िकेट में "पुष्टि नहीं हो सकी" या "पुष्टि नहीं हो पाई" मैसेज दिखता है. साथ ही, टूलटिप मैसेज भी दिखता है. जैसे, HTTP 404, रीडायरेक्ट करने की अनुमति नहीं है या टोकन मेल नहीं खाता. |
Google, https://<domain>/.well-known/google-connected-apps पर आपके चैलेंज टोकन की पुष्टि नहीं कर सका. |
- फ़ाइल नहीं मिली (एचटीटीपी 404): पक्का करें कि डाउनलोड किया गया
google-connected-apps.json कॉन्टेंट, https://<domain>/.well-known/google-connected-apps पर पब्लिश किया गया हो. साथ ही, यूआरएल पाथ में .json एक्सटेंशन न हो.
- रीडायरेक्ट करने की अनुमति नहीं है: पुष्टि करने के लिए पेलोड को सीधे
HTTP 200 OK के साथ उपलब्ध कराएं. /.well-known/google-connected-apps को किसी दूसरे यूआरएल पर रीडायरेक्ट न करें.
- टोकन मेल नहीं खाता: पुष्टि करें कि JSON रिस्पॉन्स में
"verification_tokens": ["<YOUR_TOKEN>"] मौजूद हो. साथ ही, इसमें आपके डेवलपर खाते के लिए जनरेट किया गया टोकन बिलकुल सही हो.
|
Dynamic Client Registration (DCR) या सीआईएमडी से जुड़ी गड़बड़ी |
"Dynamic Client Registration (आरएफ़सी 7591) नहीं किया जा सका", "OAuth सर्वर, Dynamic Client Registration (आरएफ़सी 7591) के साथ काम नहीं करता" या "क्लाइंट आईडी मेटाडेटा डॉक्यूमेंट (सीआईएमडी) के ज़रिए रजिस्ट्रेशन नहीं किया जा सका" |
OAuth क्लाइंट का अपने-आप होने वाला रजिस्ट्रेशन पूरा नहीं हो सका या आपका OAuth प्रोवाइडर इस सुविधा के साथ काम नहीं करता. इसके अलावा, ऐसा भी हो सकता है कि Google के रीडायरेक्ट यूआरआई अस्वीकार कर दिए गए हों. |
- पक्का करें कि आपके OAuth सर्वर की अनुमति वाली सूची में, ऐप्लिकेशन के लिए Google के सभी छह रीडायरेक्ट यूआरआई शामिल हों. ये यूआरआई, सर्वर के ऑथराइज़ेशन क्रेडेंशियल (
https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain> वगैरह) में दिखते हैं. ध्यान दें कि कई OAuth 2.1 सर्वर, वाइल्डकार्ड (*) रीडायरेक्ट यूआरआई को अस्वीकार कर देते हैं.
- अगर आपका OAuth प्रोवाइडर, सीआईएमडी या आरएफ़सी 7591 डीसीआर के साथ काम नहीं करता है, तो ऐक्सेस क्रेडेंशियल में जाकर, पहले से रजिस्टर किया गया (उपयोगकर्ता के लिए असाइन किए गए OAuth के लिए) या मशीन-टू-मशीन (OAuth क्लाइंट क्रेडेंशियल) को चुनें. इसके बाद, स्टैटिक क्लाइंट आईडी और क्लाइंट सीक्रेट दें.
|
OAuth लॉगिन पॉप-अप ब्लॉक किया गया है या खाली है |
टूल को सिंक करने या टेस्ट करने के दौरान, "आपके ब्राउज़र ने पुष्टि करने से जुड़े पॉप-अप को ब्लॉक कर दिया है" या OAuth लॉगिन विंडो ठीक से नहीं दिख रही है. |
ब्राउज़र के पॉप-अप ब्लॉकर या आपके लॉगिन पेज पर मौजूद सख्त X-Frame-Options / Content-Security-Policy हेडर की वजह से, पॉप-अप फ़्लो नहीं हो पाया. |
- अपने ब्राउज़र में कंसोल के लिए पॉप-अप की अनुमति दें और फिर से कोशिश करें.
- अपने डेवलपर क्रेडेंशियल से पुष्टि करें में जाकर, ऐक्सेस क्रेडेंशियल में जाएं. इसके बाद, पॉप-अप के ज़रिए पुष्टि करें से रीडायरेक्ट के ज़रिए पुष्टि करें (फ़ॉलबैक) पर स्विच करें, ताकि पुष्टि करने की प्रोसेस उसी टैब में फ़ुल-स्क्रीन पर खुले.
|
एमसीपी सर्वर में निर्देश मौजूद नहीं हैं |
चेतावनी वाला मैसेज: "आपके एमसीपी सर्वर में निर्देश मौजूद नहीं हैं. हमारा सुझाव है कि अपने सर्वर स्कीमा में निर्देश जोड़ें." |
आपके एमसीपी सर्वर ने अपने initialize रिस्पॉन्स में instructions फ़ील्ड नहीं दिखाया. |
- अपने एमसीपी सर्वर को शुरू करते समय, सिस्टम के निर्देशों को साफ़ तौर पर तय करें. इसके लिए, अपने सर्वर की परिभाषा में
instructions पैरामीटर का इस्तेमाल करें.
- स्टेटलेस या कस्टम एचटीटीपी लागू करने के लिए, पक्का करें कि
initialize तरीके के लिए JSON-RPC रिस्पॉन्स पेलोड में instructions फ़ील्ड शामिल हो. इसके बाद, टूल फिर से सिंक करें को चुनें.
|
यूज़र इंटरफ़ेस (यूआई) के संसाधन के साइज़ की सीमा या इस्तेमाल न किया जा सकने वाला एमआईएमई टाइप |
फ़ेच करने से जुड़ी समस्याएं गड़बड़ी का कार्ड: "सभी संसाधनों का कुल साइज़ 100 एमबी से ज़्यादा नहीं हो सकता." या "संसाधन '<uri>' के लिए, एमआईएमई टाइप '<type>' काम नहीं करता." |
आपके एमसीपी सर्वर ने यूआई से जुड़े ऐसे संसाधन दिखाए जिनका कुल साइज़ तय सीमा से ज़्यादा है या जो ऐसे एमआईएमई टाइप का इस्तेमाल करते हैं जो काम नहीं करता. |
- अपने सर्वर से मिलने वाले सभी मेनिफ़ेस्ट यूज़र इंटरफ़ेस (यूआई) संसाधनों का कुल साइज़ कम करें, ताकि वह तय सीमा से ज़्यादा न हो.
- पक्का करें कि सभी यूज़र इंटरफ़ेस (यूआई) रिसॉर्स, इस्तेमाल किए जा सकने वाले एमआईएमई टाइप में से किसी एक का इस्तेमाल करते हों:
text/html, text/html;profile=mcp-app, text/javascript या text/css.
|
आइकॉन अपलोड होने में रुकावट आना या "अनचाही गड़बड़ी" |
ऐप्लिकेशन के बारे में जानकारी में ऐप्लिकेशन का आइकॉन अपलोड करते समय, अपलोड करने की प्रोसेस लोडिंग स्पिनर पर रुक जाती है या "कोई गड़बड़ी हुई है. कृपया फिर से कोशिश करें" (आम तौर पर, कोड 4E696748 के साथ). |
आम तौर पर, ऐसा ब्राउज़र सेशन के पुराना होने, ब्राउज़र एक्सटेंशन के बीच टकराव होने या कैश मेमोरी में सेव की गई पुष्टि की स्थिति की वजह से होता है. |
नीचे बताई गई बातों को इसी क्रम में आज़माएं:
- नई ब्राउज़र प्रोफ़ाइल का इस्तेमाल करें: नई ब्राउज़र प्रोफ़ाइल का इस्तेमाल करके, एक नई विंडो खोलें.
- गुप्त / निजी मोड का इस्तेमाल करें: निजी ब्राउज़िंग विंडो में Google Connected Console में साइन इन करें और आइकॉन अपलोड करें.
- कैश मेमोरी मिटाना: फिर से कोशिश करने से पहले, अपने ब्राउज़र की कैश मेमोरी और कुकी मिटाएं. साथ ही, पुष्टि करें कि आपका आइकॉन 512 पिक्सल × 512 पिक्सल का PNG या JPEG फ़ॉर्मैट में हो और उसका साइज़ 1 एमबी से कम हो.
|