Claude Connectors काम नहीं कर रहे या दिख नहीं रहे? इन्हें कैसे ठीक करें

Claude में शायद ही कोई चीज़ उतनी खीझ भरी लगती है जितना एक connector का कल तक चलना और आज गायब हो जाना। Connectors मेन्यू खाली है, Connect बटन लगातार घूमता रहता है, या जो टूल सही लग रहा था वह चैट के बीच में error देता है। अच्छी बात यह है कि लगभग हर मामला कुछ गिने-चुने कारणों में से किसी एक तक पहुँचता है, और सही क्रम में चलें तो लगभग दस मिनट में उन्हें जाँचा जा सकता है।

यह लेख उसी क्रम का पालन करता है। यह सबसे साधारण जाँचों (प्लान, एडमिन सेटिंग्स, अकाउंट) से शुरू होता है, क्योंकि ज़्यादातर "दिख नहीं रहा" वाली रिपोर्ट इन्हीं से समझ में आती हैं। फिर साइन-इन की विफलताओं, सर्वर की पहुँच, लोकल config की गलतियों और उन errors की ओर बढ़ता है जो connector के connected दिखने के बाद ही आते हैं। मेन्यू और लेबल अक्सर बदलते रहते हैं, इसलिए अगर कोई बटन वहाँ न मिले जहाँ आप उम्मीद करते हैं, तो सेटिंग्स में Connectors या Customize वाला हिस्सा ढूँढें।

💡 मोटा नियम: अगर connector दिख ही नहीं रहा, तो अपने प्लान या किसी एडमिन सेटिंग पर शक करें। अगर वह दिख रहा है पर जुड़ नहीं रहा, तो साइन-इन या पहुँच पर शक करें। अगर वह जुड़ जाता है पर चैट में फ़ेल होता है, तो टूल कॉल पर शक करें।

Connectors गायब क्यों होते हैं

पहले अपने लक्षण का नाम तय करें, क्योंकि हर लक्षण का समाधान अलग है:

• सेटिंग्स में Connectors विकल्प ही नहीं है। यह लगभग हमेशा प्लान या ऑर्गनाइज़ेशन की समस्या होती है।
• Connector सूची में है, पर Connect बटन नहीं है या कुछ नहीं करता। यहाँ URL की टाइपिंग गलती, ब्लॉक हुए pop-ups या पुराने सेशन की वजह हो सकती है।
• Connector connected दिखता है, पर Claude उसका इस्तेमाल नहीं करता। चैट वाला टॉगल और टूल की permissions जाँचें।

आपका प्लान सीमाएँ तय करता है

Connectors, और खास तौर पर वे custom connectors जो रिमोट MCP सर्वर की ओर इशारा करते हैं, भुगतान वाले प्लान में आते हैं। जिस प्लान में ये नहीं हैं, वहाँ Connectors विकल्प बस दिखता ही नहीं, और कोई रीफ़्रेश इसे वापस नहीं ला सकता। अपनी अकाउंट सेटिंग्स खोलें, देखें कि कौन सा प्लान सक्रिय है, और उसकी तुलना आधिकारिक connectors help article से करें। अगर आपने हाल में अपग्रेड किया है या workspace बदला है, तो नया प्लान लागू होने के लिए साइन आउट करके दोबारा साइन इन करें।

पहला स्विच एडमिन के पास होता है

Team और Enterprise प्लान पर, कोई भी व्यक्ति connector इस्तेमाल करने से पहले किसी Owner या Primary Owner को उसे ऑर्गनाइज़ेशन के लिए चालू करना होता है। एडमिन एरिया में इसका मतलब है Browse connectors के ज़रिए connector सूची खोलना और Add to your team चुनना। Connector को चालू करने से वह सिर्फ़ उपलब्ध होता है। हर व्यक्ति को फिर भी अपने-अपने अकाउंट से उसमें अलग से साइन इन करना होता है, इसलिए किसी सहकर्मी का उसे "connected" देखना आपके अपने अकाउंट के बारे में कुछ नहीं बताता।

अपने एडमिन से ये तीन सवाल पूछने लायक हैं:

1. क्या connector पूरे ऑर्गनाइज़ेशन के लिए चालू है, या सिर्फ़ कुछ समूहों के लिए?
2. क्या किसी हाल की नीति में बदलाव ने custom connectors को ब्लॉक किया है?
3. क्या आप उसी ईमेल पते से साइन इन हैं जिसे workspace ने आमंत्रित किया था?

पहले ये त्वरित जाँचें करें

इनमें दो मिनट लगते हैं और ये काफ़ी मामलों को ठीक कर देती हैं। किसी भी सर्वर सेटिंग को छूने से पहले इन्हें आज़माएँ।

रीफ़्रेश करें, साइन आउट करें, फिर साइन इन करें

पुराने सेशन अजीब समस्याएँ पैदा करते हैं। इन्हें क्रम से करें और हर चरण के बाद जाँचें:

1. पेज को हार्ड रीफ़्रेश करें (Windows पर Ctrl+Shift+R, Mac पर Cmd+Shift+R)।
2. Claude से साइन आउट करें, टैब बंद करें और फिर से साइन इन करें।
3. डेस्कटॉप ऐप को पूरी तरह बंद करें, जिसमें tray या menu bar वाला आइकन भी शामिल है, फिर उसे दोबारा खोलें।
4. एक्सटेंशन बंद करके प्राइवेट विंडो आज़माएँ, क्योंकि कोई ad blocker साइन-इन pop-up को निगल सकता है।
5. डेस्कटॉप ऐप को नवीनतम वर्ज़न पर अपडेट करें।

चैट-दर-चैट चालू करें

Connector connected हो सकता है और फिर भी उस बातचीत के लिए बंद हो सकता है जिसमें आप हैं। मैसेज बॉक्स के पास वाला tools मेन्यू खोलें और देखें कि connector का टॉगल चालू है। फिर उसकी टूल permissions जाँचें: हर टूल को पहले पूछने, हमेशा अनुमति देने, या ब्लॉक रखने पर सेट किया जा सकता है। ब्लॉक किया गया टूल बिल्कुल गायब टूल जैसा ही दिखता है।

Connectors ठीक करें जो जुड़ नहीं रहे

जब connector दिखता है पर साइन-इन विफल होता है, तो समस्या आपके ब्राउज़र, दूसरी सेवा के लॉगिन पेज और Claude के बीच कहीं होती है।

साइन-इन विंडो कभी पूरी नहीं होती

Connect करने पर दूसरी सेवा का लॉगिन पेज खुलता है: आपका कैलेंडर, आपका CRM, या आपका अपना सर्वर। अगर वह विंडो दिखती ही नहीं, तुरंत बंद हो जाती है, या वापस शुरुआत पर लौट आती है:

• Claude साइट के लिए pop-ups की अनुमति दें।
• पहले दूसरी सेवा में साइन इन करें, उसी ब्राउज़र में, ताकि लॉगिन पेज शून्य से शुरू न हो।
• अगर आपका VPN या content filter redirects बदलता है, तो उसे रोकें।
• Permissions जाँचें। कई सेवाएँ केवल एडमिन को third-party ऐप्स मंज़ूर करने देती हैं।

💡 साफ़ तरीके से दोबारा जोड़ें। Connector हटाएँ, टैब बंद करें, फिर साइन इन करें और connector को नए सिरे से जोड़ें। पिछली अधूरी कोशिश एक टूटी हुई स्थिति छोड़ सकती है, जिसे बार-बार की कोशिशें ठीक नहीं करतीं।

Authorization विफल संदेश

"Authorization with the MCP server failed" आमतौर पर तब आता है जब साइन-इन पहले ही शुरू हो चुका होता है। Anthropic के connector troubleshooting दस्तावेज़ ये सर्वर-साइड कारण बताते हैं:

• Issuer या audience का मेल न खाना। Tokens उसी authority से आने चाहिए जिसे सर्वर घोषित करता है, और वे उसी सर्वर के अपने URL के लिए जारी होने चाहिए।
• PKCE सपोर्ट का न होना। Claude हर authorization request के साथ S256 PKCE challenge भेजता है, इसलिए जिस सर्वर में यह नहीं है वह token चरण पर फ़ेल होता है।
• धीमा token endpoint। Claude token response के लिए अधिकतम 10 सेकंड तक इंतज़ार करता है। जो gateway विलंब बढ़ाता है, वह आपको इस सीमा के पार धकेल सकता है।
• किसी दूसरे होस्ट पर redirect। जब पंजीकृत URL redirect करता है (apex से www सबसे आम उदाहरण है), तो रास्ते में credential छूट जाता है और लक्ष्य 401 लौटाता है।

अगर आप सिर्फ़ किसी और का connector इस्तेमाल करते हैं, तो यह सूची उन्हें भेज दें। अगर आप सर्वर चलाते हैं, तो अगला हिस्सा आपके काम का है।

"MCP सर्वर तक नहीं पहुँच सके" ठीक करें

यह संदेश नेटवर्क आउटेज जैसा लगता है, पर अक्सर कारण ज़्यादा चुपचाप छिपा होता है। ज़रूरी तथ्य यह है: claude.ai पर रिमोट connectors Anthropic के इंफ़्रास्ट्रक्चर पर चलते हैं, आपके कंप्यूटर पर नहीं। Claude आपके सर्वर का hostname सार्वजनिक इंटरनेट से resolve करता है, और अगर परिणाम ग्लोबली रूट करने योग्य नहीं है, तो वह एक भी request भेजे बिना कनेक्शन अस्वीकार कर देता है। आपके access logs में कुछ भी नहीं दिखता।

Private IPs और Split DNS

Claude उन hostnames को अस्वीकार करता है जो private ranges (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), carrier-grade NAT addresses (100.64.0.0/10), loopback या link-local addresses पर resolve होते हैं, या जिनके नतीजे public और private का मिश्रण हैं। Connectors केवल IPv4 पर चलते हैं, इसलिए जिस hostname के पास सिर्फ़ AAAA records हैं, वह फ़ेल होता है।

यही वह क्लासिक शिकायत समझाता है: "यह Claude Code और curl में चलता है, पर claude.ai पर नहीं।" वे टूल आपकी मशीन से कनेक्ट होते हैं, जबकि claude.ai क्लाउड से कनेक्ट होता है। अगर आपका hostname आपके नेटवर्क के अंदर एक तरह से और बाहर दूसरी तरह से resolve होता है (split-horizon DNS), या वह किसी VPN, dynamic DNS provider या CGNAT वाले होम राउटर के पीछे छिपा है, तो वेब ऐप को कभी उपयोगी पता नहीं मिलता।

अपने नेटवर्क के बाहर से इसकी जाँच करें:

dig +short your-server.example.com

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

लौटाया गया हर पता सार्वजनिक होना चाहिए। अपने लैपटॉप पर चल रहे सर्वर के लिए localhost URL के बजाय उसे किसी सार्वजनिक tunnel या reverse proxy के ज़रिए उजागर करें।

Firewalls और छिपे redirects

सही DNS के बावजूद, CDN, WAF या rate limiter अनुरोध को आपके एप्लिकेशन तक पहुँचने से पहले रोक सकता है। Connect कोशिश के दौरान अपने edge logs में 403 या 429 responses देखें, फिर Anthropic के IP address page पर प्रकाशित outbound range को allowlist करें, या MCP और sign-in paths को ब्लॉकिंग नियम से छूट दें।

फिर redirects जाँचें:

curl -sI https://your-server.example.com/mcp

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

अगर response 301, 302, 307, या 308 है और किसी दूसरे होस्ट की ओर इशारा करता है, तो उसके बजाय वही लक्ष्य URL पंजीकृत करें। लोकल clients redirect पर तुरंत फ़ेल होते हैं, जबकि claude.ai उसका पीछा करता है, credential छोड़ देता है और बाद में authorization error दिखाता है।

OAuth metadata lookup विफल होता है

जब सर्वर को साइन-इन चाहिए, तो Claude पहले उसका OAuth metadata देखता है। हर दस्तावेज़ को सार्वजनिक नेटवर्क से माँगें और 200 के साथ वैध JSON की उम्मीद करें:

curl -i https://your-server.example.com/.well-known/oauth-protected-resource
curl -i https://your-server.example.com/.well-known/oauth-authorization-server
curl -i https://your-server.example.com/.well-known/openid-configuration

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

आख़िरी दो में से सिर्फ़ एक का जवाब देना ज़रूरी है। मेटाडेटा में Claude को क्लाइंट के रूप में रजिस्टर करने का तरीका भी होना चाहिए (डायनामिक क्लाइंट रजिस्ट्रेशन, क्लाइंट ID मेटाडेटा डॉक्यूमेंट या पहले से रजिस्टर किए गए क्रेडेंशियल) और उसमें S256 PKCE सपोर्ट की जानकारी भी देनी होगी। अगर कोई प्रॉक्सी WWW-Authenticate हेडर हटा देता है या /.well-known/ पाथ पर 403 लौटाता है, तो पीछे सर्वर पूरी तरह ठीक होने पर भी वही "couldn't reach" मैसेज दिखता है।

Microsoft Entra पर अलग से ध्यान देना चाहिए। अगर token request AADSTS9010010 के साथ फ़ेल होता है, तो Entra उस resource value को अस्वीकार कर रहा है जो Claude भेजता है। अपना पूरा MCP सर्वर URL API app registration पर Application ID URI के रूप में पंजीकृत करें, और अगर आप platform hostname पर हैं, तो सत्यापित custom domain का उपयोग करें।

💡 Reference ID सहेजें। जब claude.ai पर कनेक्शन फ़ेल होता है, तो error पेज के URL में ofid_ से शुरू होने वाली एक वैल्यू होती है। उसे तुरंत कॉपी करें, क्योंकि उसकी समय-सीमा खत्म हो जाती है, और anthropics/claude-ai-mcp tracker पर issue दर्ज करते समय उसे शामिल करें।

Claude Desktop में लोकल सर्वर ठीक करें

आपकी अपनी मशीन पर चलने वाले सर्वर एक अलग रास्ता लेते हैं। डेस्कटॉप ऐप उन्हें एक config फ़ाइल से लॉन्च करता है, इसलिए कुछ भी इंटरनेट से नहीं गुज़रता और ऊपर की DNS सलाह लागू नहीं होती।

Config फ़ाइल की गलतियाँ

सबसे आम लोकल विफलताएँ छोटी होती हैं:

• अमान्य JSON। एक extra trailing comma या छूटा हुआ quote पूरी फ़ाइल को अनदेखा करवा देता है, इसलिए कोई सर्वर लोड नहीं होता।
• गलत command path। ऐप को शायद आपका shell PATH नहीं मिलता, इसलिए npx या node terminal में चलता है पर ऐप से नहीं। executable का absolute path इस्तेमाल करें।
• Arguments में relative paths। Scripts और data folders के लिए absolute paths इस्तेमाल करें।
• पूरा restart न करना। बदलाव तभी लागू होते हैं जब आप ऐप को पूरी तरह बंद करके दोबारा खोलें।

Restart से पहले फ़ाइल को JSON validator से चलाएँ।

Logs पढ़ें

डेस्कटॉप ऐप MCP logs Windows पर %APPDATA%\Claude\logs में और macOS पर ~/Library/Logs/Claude में लिखता है, जिसमें एक सामान्य MCP log और हर सर्वर के लिए एक अलग फ़ाइल होती है। जो सर्वर startup पर crash होता है, वह आमतौर पर वहीं कारण लिखता है: कोई missing package, गलत Node version, या कोई अनुपस्थित environment variable। Claude Code में claude mcp list सभी configured सर्वरों की स्थिति दिखाता है, और session के भीतर /mcp विवरण दिखाता है और साइन इन करने देता है।

चैट के बीच में टूल errors ठीक करें

Connected है पर फ़ेल हो रहा है

"Unexpected error while invoking tool", उसके बाद एक टूल नाम, का मतलब है कि कनेक्शन खुद स्वस्थ है। Claude का अनुरोध सर्वर तक पहुँचा और सर्वर ने error के साथ जवाब दिया। यहाँ ofid_ reference ID नहीं होता, क्योंकि कनेक्शन के समय कुछ फ़ेल नहीं हुआ था।

इस क्रम में दायरा छोटा करें:

1. MCP Inspector में वही कॉल चलाएँ और परिणाम की तुलना उस error से करें जो Claude दिखाता है।
2. ठीक उसी समय के लिए सर्वर logs में handler error देखें।
3. पता करें कि क्या हर उपयोगकर्ता को यह दिक्कत आती है या सिर्फ़ आपके अकाउंट को। सिर्फ़ आपके अकाउंट पर होना दूसरी सेवा की permissions की ओर इशारा करता है।
4. Disconnect करके दोबारा connect करें, ख़ासकर अगर token की समय-सीमा खत्म हो गई या रद्द हो गई हो।

Rate limits एक और आम कारण हैं, और ये बेतरतीब लगते हैं। कई सेवाएँ एक साथ चलने वाले काम की सीमा तय करती हैं। PicassoIA का अपना MCP connection इसका अच्छा उदाहरण है: इसके इमेज, इमेज एडिटिंग और वीडियो मॉडल हर अकाउंट पर, हर credential और MCP connection में मिलाकर, एक साथ चलने वाले 5 predictions की सीमा साझा करते हैं। इस लेख के लिखने के समय, यह connection आप अपने अकाउंट के MCP पेज से जोड़ते हैं, जिसके लिए लॉगिन चाहिए। अगर Claude एक ही अनुरोध में दस generations चलाता है, तो कुछ फ़ेल होंगे। उसे छोटे बैच में काम करने को कहें।

जिन संदेशों से आप सबसे ज़्यादा टकराएँगे, उनका एक त्वरित अर्थ यह है:

डिबग करते समय काम जारी रखें

टूटा हुआ connector आपका दिन नहीं रोकना चाहिए। उसे ठीक करते समय error का टेक्स्ट, log का अंश या screenshot ऐसे मॉडल में चिपकाएँ जो किसी connector पर निर्भर नहीं है। Claude Sonnet 5 PicassoIA पर उपलब्ध है, कोड और टूल-भारी कामों को संभालता है, और इमेज इनपुट स्वीकार करता है, जो error पेज के screenshots के लिए उपयुक्त है।

PicassoIA पर Claude Sonnet 5 इस्तेमाल करें

1. PicassoIA पर Claude Sonnet 5 पेज खोलें।
2. अपना एरर मैसेज, कॉन्फ़िग फ़ाइल या लॉग का हिस्सा Prompt फ़ील्ड में पेस्ट करें। बताएँ कि आप क्या उम्मीद कर रहे थे और असल में क्या हुआ।
3. चाहें तो Image फ़ील्ड में स्क्रीनशॉट जोड़ें, जैसे फ़ेल हो रही सेटिंग्स की स्क्रीन।
4. Effort लेवल चुनें। टाइपो ढूँढने के लिए Low सबसे तेज़ जवाब देता है, जबकि उलझी हुई OAuth समस्या के लिए high या max बेहतर है।
5. एक System Prompt जोड़ें, उदाहरण के लिए: "You are a careful MCP debugging assistant. Ask for missing details before suggesting changes."
6. Max Tokens को डिफ़ॉल्ट 8192 पर रहने दें, जब तक आपको छोटे जवाब न चाहिए हों, फिर इसे चलाएँ।

💡 पहले secrets हटाएँ। किसी भी config या log को कहीं चिपकाने से पहले उसमें से tokens, client secrets और passwords हटा दें।

Picasso IA पर अपनी इमेज बनाएँ

सेटिंग्स का टैब बंद करने से पहले यह आख़िरी चेकलिस्ट चलाएँ:

• प्लान में connectors शामिल हैं, और एक Owner ने आपकी टीम के लिए connector चालू किया है
• सही अकाउंट से साइन इन हैं, और मौजूदा चैट में connector का टॉगल चालू है
• Pop-ups अनुमत हैं, और साफ़ तरीके से दोबारा जोड़ने की कोशिश हो चुकी है
• सर्वर hostname सार्वजनिक IPv4 पते पर resolve होता है, और किसी दूसरे होस्ट पर कोई redirect नहीं है
• OAuth metadata 200 के साथ जवाब देता है, और सहायता चाहिए तो ofid_ reference ID सहेजा हुआ है

एक बार आपके connectors फिर ठीक से काम करने लगें, तो उन्हें कुछ रचनात्मक काम दें। Picasso IA एक छोटे प्रॉम्प्ट को सेकंडों में फ़ोटोरियलिस्टिक इमेज में बदल देता है, PicassoIA Image से, आप PicassoIA Image Editor Pro से परिणाम को और निखार सकते हैं, और PicassoIA Video से एक स्थिर इमेज को एनिमेट कर सकते हैं। प्लेटफ़ॉर्म खोलें, मन में किसी दृश्य का एक प्रॉम्प्ट लिखें, रोशनी या कैमरे का कोण बदलें और फिर चलाएँ। दस मिनट के प्रयोग से पता चल जाएगा कि हर मॉडल किसमें सबसे अच्छा है, और आप सभी मॉडल पेज पर हर विकल्प देख सकते हैं।