Ringhum को Claude और दूसरे एआई टूल से कनेक्ट करें (MCP)

Ringhum के पास एक MCP सर्वर है। MCP (Model Context Protocol) एआई ऐप के लिए बाहरी टूल इस्तेमाल करने का एक मानक तरीका है। एक बार जब आप Ringhum को Claude या ChatGPT जैसे किसी एआई ऐप से कनेक्ट कर लेते हैं, तो आप सामान्य भाषा में अपने वर्कस्पेस के बारे में सवाल पूछ सकते हैं। उदाहरण के लिए: "कल की छूटी हुई कॉल का सारांश दें", "इस हफ़्ते किन कॉलर ने कॉलबैक मांगी?" या "हमारा नया खुलने का समय FAQs में जोड़ें"। एआई ऐप उन्हीं नियमों और अनुमतियों से काम करता है जो Ringhum API के हैं।

आपको क्या चाहिए

• सर्वर URL: https://ringhum.com/mcp। यह डेवलपर्स पेज पर MCP सर्वर कार्ड में भी, एक कॉपी करें बटन के साथ दिखता है।
• एक एआई ऐप जो रिमोट MCP सर्वर सपोर्ट करता हो, जैसे Claude, ChatGPT, Claude Code, Cursor, Windsurf या VS Code।
• वर्कस्पेस में ओनर या एडमिन भूमिका। सिर्फ़ ओनर और एडमिन ही कोई ऐप कनेक्ट कर सकते हैं या एक API कुंजी बना सकते हैं।

कनेक्ट करने के दो तरीके हैं। साइन इन करना सबसे आसान है और Claude व ChatGPT जैसे चैट ऐप के लिए उपयुक्त है। एक API कुंजी उन डेवलपर टूल के लिए उपयुक्त है जो एक URL और एक हेडर लेते हैं।

रीड-ओनली या रीड-एंड-चेंज एक्सेस

आप चुनते हैं कि एआई ऐप कितना कर सकता है।

रीड-ओनली एक्सेस के साथ, जो टूल चीज़ें बदलते हैं वे ऐप को बिल्कुल भी नहीं दिए जाते।

ज़रूरी: चेंज एक्सेस के साथ, एआई ऐप आपके ग्राहकों को असली मैसेज भेज सकता है और असली कॉल कर सकता है। Ringhum इन टूल को आपके वर्कस्पेस के बाहर पहुंचने वाले के रूप में और हटाने की कार्रवाइयों को विध्वंसक के रूप में चिह्नित करता है, इसलिए ज़्यादातर एआई ऐप इन्हें चलाने से पहले आपसे पूछते हैं। मंज़ूरी देने से पहले पढ़ें कि ऐप क्या करने वाला है।

साइन इन करके Claude कनेक्ट करें

1. Claude में (वेब, डेस्कटॉप या मोबाइल पर), Settings → Connectors खोलें और Add custom connector चुनें।
2. URL के रूप में https://ringhum.com/mcp पेस्ट करें और सेव करें।
3. कनेक्ट करें पर क्लिक करें। एक Ringhum पेज खुलता है। अगर पूछा जाए तो साइन इन करें।
4. Connect पेज पर, वह वर्कस्पेस चुनें जिसका ऐप इस्तेमाल कर सकता है।
5. यह क्या कर सकता है के तहत, चीज़ें देखना या चीज़ें देखना और बदलाव करना चुनें।
6. अनुमति दें पर क्लिक करें। आप वापस Claude पर भेज दिए जाते हैं।

ऐप आपका पासवर्ड कभी नहीं देखता। Claude में मेन्यू के सटीक नाम समय के साथ बदल सकते हैं; इसकी सेटिंग्स में कनेक्टर या इंटीग्रेशन ढूंढें।

ChatGPT: Settings → Apps & Connectors में URL को एक कस्टम कनेक्टर (MCP सर्वर) के रूप में जोड़ें, फिर Connect पर क्लिक करें और चरण 3 से 6 का पालन करें।

Claude Code: नीचे दिया कमांड चलाएं, फिर /mcp चलाएं और Authenticate चुनें।

claude mcp add --transport http ringhum https://ringhum.com/mcp

एक्सेस की अनुमति देने के बाद, जब तक आप इसे इस्तेमाल करते रहते हैं कनेक्शन खुद को रीन्यू करता रहता है। अगर ऐप 90 दिनों तक इस्तेमाल नहीं होता, तो आपको इसे फिर से कनेक्ट करना होगा।

एक API कुंजी से कनेक्ट करें

इसे उन टूल के लिए इस्तेमाल करें जो आपको एक रिक्वेस्ट हेडर सेट करने देते हैं, या जब आप साइन इन नहीं करना चाहते।

1. डेवलपर्स पर, एक API कुंजी बनाएं। रीड-ओनली कनेक्शन के लिए सिर्फ़ read पर टिक करें, या बदलावों की अनुमति देने के लिए read और write पर। देखें API कुंजियां और स्कोप।
2. Authorization हेडर में कुंजी के साथ अपने ऐप में सर्वर जोड़ें।

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf और Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

जो ऐप सिर्फ़ लोकल सर्वर चला सकता है वह npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…" के ज़रिए कनेक्ट हो सकता है।

टूल क्या-क्या कवर करते हैं

Ringhum API का हर ऑपरेशन एक टूल के रूप में उपलब्ध है: आपका अकाउंट और उपयोग, असिस्टेंट, फ़ोन नंबर, कॉल और ट्रांसक्रिप्ट, कॉन्टैक्ट, अपॉइंटमेंट और उपलब्धता, ऑर्डर और उत्पाद, रूम रिज़र्वेशन, इनबॉक्स, टेक्स्ट और WhatsApp मैसेज, कैंपेन, वेबहुक, कंपनी प्रोफ़ाइल, सेवाएं, FAQs और नॉलेज बेस, अनुत्तरित सवाल, पेमेंट लिंक, रिव्यू रिक्वेस्ट, रेवेन्यू और स्पैम प्रोटेक्शन। कॉल रिकॉर्डिंग एकमात्र अपवाद हैं: ये टूल के रूप में उपलब्ध नहीं हैं।

हर टूल मिलती-जुलती API रिक्वेस्ट चलाता है, इसलिए वही प्लान सीमाएं, वैलिडेशन और रेट लिमिट लागू होती हैं। टूल कॉल API की प्रति मिनट 120 रिक्वेस्ट की सीमा में गिनी जाती हैं। टूल की पूरी सूची /docs पर API रेफरेंस के MCP सेक्शन में है।

कनेक्टेड ऐप देखें और डिसकनेक्ट करें

आपके साइन इन करके कनेक्ट किए गए ऐप डेवलपर्स पर कनेक्टेड AI ऐप के तहत सूचीबद्ध होते हैं, इसके साथ कि किसने उन्हें कनेक्ट किया, उनका एक्सेस (केवल पढ़ना या पढ़ना और बदलना) और आख़िरी बार कब इस्तेमाल हुए।

किसी ऐप को हटाने के लिए, डिसकनेक्ट करें पर क्लिक करें और पुष्टि करें। यह तुरंत एक्सेस खो देता है और फिर से स्वीकृत किया जाना चाहिए। किसी ऐप का एक्सेस बदलने के लिए, इसे डिसकनेक्ट करें और दूसरे विकल्प के साथ फिर से कनेक्ट करें।

API कुंजी से बनाए गए कनेक्शन के लिए, API कुंजियां के तहत कुंजी रद्द करें।

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

"Only owners and admins of a workspace can connect apps." वर्कस्पेस के ओनर से ऐप कनेक्ट करने को कहें, या आपको एडमिन बनाने को कहें। देखें अपनी टीम को आमंत्रित करें।

"The sign-in request expired. Start connecting again from your AI app." स्वीकृति पेज बहुत देर तक खुला रहा। एआई ऐप से फिर से शुरू करें।

ऐप कहता है कि यह अधिकृत नहीं है, या फिर से साइन इन करने को कहता है। ऐप डिसकनेक्ट हो गया था, कुंजी रद्द हो गई थी, या आप अब वर्कस्पेस के सदस्य नहीं हैं। इसे फिर से कनेक्ट करें।

ऐप बदलाव नहीं कर सकता। यह रीड-ओनली एक्सेस के साथ कनेक्ट किया गया था, या इसकी API कुंजी में write स्कोप नहीं है।

ऐप गलत वर्कस्पेस देख रहा है। इसे जांचने के लिए who_am_i कॉल करने को कहें। हर कनेक्शन एक वर्कस्पेस इस्तेमाल करता है। दूसरा चुनने के लिए इसे डिसकनेक्ट करके फिर से कनेक्ट करें। </content>