Claude Code को अपने पैनल से जोड़ें — डॉक्स

इसे सेट करने के बाद, जब आप टर्मिनल में काम कर रहे हों, Claude Code आपका पैनल देख सकता है: "मेरा कौन-सा खाता अपनी डिस्क सीमा के सबसे करीब है?", "example.com के DNS रिकॉर्ड दिखाओ"। वह केवल वही पढ़ता है जिसकी आपका टोकन अनुमति देता है। जो कुछ हटाता या रोकता है, वह एक अनुरोध बन जाता है जो पैनल में आपके स्वीकृत दबाने का इंतज़ार करता है। सहायक कभी अपना अनुरोध खुद स्वीकृत नहीं करता।

Nimbopanel के साथ AI इस्तेमाल करने का यह दूसरा तरीका है। पहला, पैनल के अंदर ही चैट पैनल, AI सहायक में बताया गया है। इसे इस्तेमाल करने के लिए उसकी ज़रूरत नहीं है।

शुरू करने से पहले

आपके पैनल का पता, जैसे https://panel.yourdomain.com। पैनल का अपना पता इस्तेमाल करें, IP नहीं।
आपके कंप्यूटर पर Claude Code इंस्टॉल हो (टर्मिनल में claude कमांड चलती हो)।
पैनल पर एक खाता: एडमिनिस्ट्रेटर, रीसेलर, ग्राहक या टीम उपयोगकर्ता।

1. एडमिनिस्ट्रेटर कनेक्शन चालू करता है (एक बार)

सिस्टम → सुरक्षा → AI सहायक कनेक्शन (MCP) खोलें, AI सहायकों को जुड़ने दें पर टिक करें, चुनें कि किस तरह के लोग इसे जोड़ सकते हैं, और Save दबाएँ। कार्ड वह पता दिखाता है जो सहायक इस्तेमाल करते हैं: आपके पैनल के पते के बाद /mcp।

नई इंस्टॉलेशन में यह बंद रहता है। जब तक यह चालू नहीं होता, /mcp 404 देता है और नीचे का कुछ भी काम नहीं करता।

2. केवल सहायक के लिए एक टोकन बनाएँ

पैनल में साइन इन करें और API टोकन खोलें: एडमिनिस्ट्रेटर और रीसेलर के लिए सुरक्षा में, ग्राहकों के लिए उन्नत में। AI सहायक जोड़ें (Claude और अन्य) खोलें।

उसे ऐसा नाम दें जो आपको याद रहे, जैसे Claude Code on my laptop।
पैनल के हर हिस्से के लिए कोई पहुँच नहीं, पढ़ना या पढ़ना और बदलना चुनें। पढ़ना से शुरू करें: सहायक आपके चुने हर हिस्से को देख सकता है और कुछ नहीं बदल सकता।
इतने दिनों बाद बंद (दिन) को 90 पर रहने दें, या अपनी संख्या डालें।
सहायक टोकन बनाएँ दबाएँ।

पैनल अब टोकन सिर्फ़ एक बार दिखाता है। पेज छोड़ने से पहले उसे कॉपी कर लें।

3. एक कमांड पेस्ट करें

पैनल कमांड को आपके पते और टोकन के साथ पहले से भरकर दिखाता है। उसे कॉपी करें और टर्मिनल में चलाएँ। वह कुछ ऐसी दिखती है:

claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"

इसका मतलब: nimbopanel नाम का एक MCP सर्वर जोड़ो, जो पैनल के /mcp पते पर HTTP से पहुँचा जाता है, और हर कॉल में Authorization हेडर में आपका टोकन भेजो।

Claude Code इसे कहाँ रखता है। डिफ़ॉल्ट रूप से सर्वर सिर्फ़ मौजूदा प्रोजेक्ट के लिए सहेजा जाता है, आपके कंप्यूटर पर ~/.claude.json में, प्रोजेक्ट फ़ोल्डर में नहीं। हर प्रोजेक्ट में इस्तेमाल करने के लिए --scope user जोड़ें। असली टोकन के साथ --scope project न जोड़ें: इससे टोकन .mcp.json में लिख जाता है, जो एक ऐसी फ़ाइल है जिसे कमिट करके साझा किया जाता है। अगर कोई टीम कनेक्शन साझा करती है, तो .mcp.json में सिर्फ़ संदर्भ रखें और हर व्यक्ति अपना टोकन अपने एनवायरनमेंट वेरिएबल में रखे:

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

हर व्यक्ति अपना टोकन बनाए, ताकि अनुरोध में दिखे कि किसने माँगा और एक टोकन को अलग से रद्द किया जा सके।

4. जाँचें कि यह काम करता है

claude mcp list

nimbopanel जुड़ा हुआ दिखना चाहिए। Claude Code के अंदर आप /mcp भी टाइप कर सकते हैं। फिर सादे शब्दों में पूछें:

"मेरे होस्टिंग खाते सूचीबद्ध करो और बताओ कि कौन-सा सबसे ज़्यादा डिस्क इस्तेमाल करता है।"
"example.com के DNS रिकॉर्ड दिखाओ।"
"मेरे कौन-से डेटाबेस सबसे बड़े हैं?"
एडमिनिस्ट्रेटर: "क्या सभी सेवाएँ चल रही हैं?", "क्या मेल कतार बढ़ रही है?"

सहायक खाते और उनका उपयोग, डोमेन, DNS रिकॉर्ड, ईमेल खाते (पासवर्ड कभी नहीं), डेटाबेस, बैकअप, सर्वर लोड और सेवाएँ, मेल कतार, रीसेलर और सपोर्ट टिकट देख सकता है — उन हिस्सों के भीतर जिनका नाम आपके टोकन में है और आपकी अपनी भूमिका के भीतर।

जब आप कोई बदलाव माँगते हैं

पढ़ना और बदलना के साथ, किसी नए, रोज़मर्रा के नाम पर साधारण नया पता (A या AAAA) या टेक्स्ट (TXT) रिकॉर्ड तुरंत जुड़ जाता है।
बाकी सब कुछ आपका इंतज़ार करता है: रिकॉर्ड हटाना, किसी खाते को निलंबित करना या वापस चालू करना, मेल रिकॉर्ड, खुद डोमेन, CNAME, SRV और CAA रिकॉर्ड, वाइल्डकार्ड, और वे नाम जिन्हें मेल प्रोग्राम खोजते हैं। वह एक अनुरोध बन जाता है।

API टोकन → सहायक के अनुरोध खोलें। हर अनुरोध सादे शब्दों में बताता है कि क्या होगा। स्वीकृत करें… दबाएँ, फिर हाँ, अभी करें। अनुरोध 30 मिनट बाद समाप्त हो जाता है। अनुरोध पढ़ें, सहायक का संदेश नहीं: अनुरोध पैनल लिखता है और उसमें ठीक-ठीक लिखा होता है कि क्या किया जाएगा।

क्योंकि यह बदलाव सहायक ने माँगा है, पैनल पहले आपसे पासवर्ड (और दो-चरण साइन-इन उपयोग करते हों तो सत्यापन कोड) से पुष्टि करवाता है कि यह आप ही हैं; उसके बाद कुछ मिनट तक वह दोबारा नहीं पूछता।

अगर यह काम न करे

आप क्या देखते हैं	इसका मतलब	क्या करें
`/mcp` से `404 Not found`, या ऐसा पेज जो कहता है कि इस पते के लिए कोई वेबसाइट कॉन्फ़िगर नहीं है	कनेक्शन बंद है, या आपने ऐसा पता इस्तेमाल किया जो आपके पैनल का अपना नहीं है (कोई IP, या दूसरा डोमेन)	चरण 1 देखें; पैनल का अपना पता इस्तेमाल करें, जो `/mcp` पर खत्म हो
`403 forbidden_host`	पता पैनल तक पहुँचता है, लेकिन पैनल उसे अपना नहीं मानता	पैनल का अपना पता इस्तेमाल करें, जैसे `https://panel.yourdomain.com`
`401 Login required`	टोकन गायब है, गलत लिखा है, समाप्त हो गया है या रद्द हो चुका है	नया टोकन बनाएँ और कमांड फिर चलाएँ
`403 mcp_scope_required`	यह सामान्य API टोकन है, सहायकों वाला नहीं	AI सहायक जोड़ें के तहत टोकन बनाएँ
`403 mcp_off_for_role`	आपकी तरह के खाते को सहायक जोड़ने की अनुमति नहीं है	एडमिनिस्ट्रेटर से कहें (चरण 1)
`429 rate_limited`	थोड़े समय में बहुत ज़्यादा कॉल	एक मिनट रुकें
पैनल का कोई हिस्सा गायब है	उस क्षेत्र को कोई पहुँच नहीं पर रखा गया है	उस क्षेत्र को पढ़ना पर रखकर नया टोकन बनाएँ

claude mcp list में विफलता दिखने का आम मतलब है कि URL में /mcp नहीं है, या हेडर ठीक Authorization: Bearer <token> नहीं है।

इसे हटाना

claude mcp remove nimbopanel

यह इसे आपके कंप्यूटर से हटा देता है। टोकन को हर जगह काम करने से रोकने के लिए, उसे API टोकन में हटाएँ; उसके छोड़े हुए खुले अनुरोध रद्द हो जाते हैं। एडमिनिस्ट्रेटर चरण 1 में पूरा कनेक्शन बंद कर सकता है, और /mcp फिर 404 देता है।

अच्छी आदतें

पढ़ना को प्राथमिकता दें। पढ़ना और बदलना केवल उन क्षेत्रों के लिए इस्तेमाल करें जिन्हें उसकी ज़रूरत है।
हर कंप्यूटर या व्यक्ति के लिए एक टोकन, ऐसे नाम के साथ जो बताए कि वह किसका है।
90 दिन का डिफ़ॉल्ट रखें, या साझा मशीन के लिए इससे कम।
टोकन को कभी चैट, टिकट या कमिट की जाने वाली फ़ाइल में पेस्ट न करें।

अभी समर्थित नहीं: ऐसे क्लाइंट जो केवल OAuth साइन-इन से जुड़ सकते हैं। यह एंडपॉइंट हेडर में टोकन स्वीकार करता है।