Telerivet MCP

npx add-mcp 'https://api.telerivet.com/mcp'

Telerivet एक Model Context Protocol (MCP) सर्वर प्रदान करता है, जो AI एजेंटों और Claude तथा ChatGPT जैसे LLM-आधारित टूल को मानक MCP इंटरफ़ेस का उपयोग करके Telerivet REST API के साथ इंटरैक्ट करने देता है।

Telerivet का MCP सर्वर AI एजेंटों को Telerivet में कई तरह की कार्रवाइयाँ करने में सक्षम बनाता है, जिनमें संदेश भेजना और शेड्यूल करना, डेटा और उपयोग के आँकड़े प्राप्त करना, संपर्क आयात करना, तथा प्रोजेक्ट, रूट और स्वचालित सेवाएँ कॉन्फ़िगर करना शामिल है।

MCP एंडपॉइंट यहाँ उपलब्ध है:

https://api.telerivet.com/mcp

MCP क्लाइंट HTTP POST अनुरोधों पर JSON-RPC 2.0 संदेशों का उपयोग करते हुए Streamable HTTP ट्रांसपोर्ट के माध्यम से कनेक्ट होते हैं।

क्लाइंट कॉन्फ़िगरेशन

MCP एंडपॉइंट के लिए OAuth 2.0 के माध्यम से प्रमाणीकरण आवश्यक है।

OAuth Client ID Metadata Documents (CIMD) का समर्थन करने वाले MCP क्लाइंट बिना किसी मैन्युअल कॉन्फ़िगरेशन के कनेक्ट हो सकते हैं: उपयोगकर्ता द्वारा पहली बार अधिकृत किए जाने पर Telerivet इसे अपने-आप पंजीकृत कर देता है। Telerivet Dynamic Client Registration का समर्थन नहीं करता।

निम्नलिखित MCP क्लाइंट के लिए सेटअप निर्देश उपलब्ध हैं:

• Claude (claude.ai और Claude Desktop)
• Claude Code
• ChatGPT
• Codex
• Antigravity CLI
• Hermes Agent

जो MCP क्लाइंट Client ID Metadata Documents का समर्थन नहीं करते, उनके लिए OAuth Client को मैन्युअल रूप से कॉन्फ़िगर करना होगा। CIMD का समर्थन न करने वाले किसी अन्य MCP क्लाइंट का उपयोग करने के लिए, आप अपने Telerivet संगठन में नया OAuth Client जोड़ सकते हैं और MCP क्लाइंट के लिए आवश्यक OAuth कॉलबैक URL कॉन्फ़िगर कर सकते हैं। (MCP क्लाइंट प्रदान करने वाली सेवा अपने दस्तावेज़ों में OAuth कॉलबैक URL निर्दिष्ट कर सकती है।) जब OAuth Client को इस तरह मैन्युअल रूप से कॉन्फ़िगर किया जाता है, तो उसे केवल आपके अपने Telerivet संगठन के उपयोगकर्ता ही एक्सेस कर सकते हैं।

MCP क्लाइंट को अधिकृत करना

MCP क्लाइंट कनेक्ट करने पर, वह आपको एक्सेस अधिकृत करने के लिए Telerivet पर रीडायरेक्ट करता है। इस पेज पर आप चुनते हैं:

• अनुमतियाँ – एप्लिकेशन किस प्रकार के डेटा और कार्रवाइयों को एक्सेस कर सकता है (उदाहरण के लिए, संदेश देखें, संदेश भेजें या स्वचालित सेवाएँ संपादित करें)। जिन अनुमतियों की आप एप्लिकेशन को अनुमति नहीं देना चाहते, उनका चेक हटाएँ। एप्लिकेशन कभी भी उससे अधिक नहीं कर सकता जितना आपके अपने उपयोगकर्ता खाते को करने की अनुमति है, और जिन API विधियों के लिए ऐसी अनुमति आवश्यक है जो आपने नहीं दी, वे MCP क्लाइंट से छिपी रहती हैं।
• संगठन – आपके किन संगठनों को एप्लिकेशन एक्सेस कर सकता है। हर प्राधिकरण केवल एक संगठन पर लागू होता है; किसी अन्य संगठन के साथ एप्लिकेशन का उपयोग करने के लिए उसे फिर से कनेक्ट करें।

अपने संगठन के लिए एप्लिकेशन को मंज़ूरी देना। किसी संगठन में उपयोग किए जाने से पहले, प्रत्येक MCP क्लाइंट (जैसे Claude या ChatGPT) को संगठन के व्यवस्थापक से मंज़ूरी मिलनी चाहिए। यदि आप संगठन के व्यवस्थापक हैं, तो प्राधिकरण पेज आपको अपने संगठन के लिए एप्लिकेशन को मंज़ूरी देने और यह चुनने देता है कि इस एप्लिकेशन का उपयोग कौन कर सकता है?: संगठन के सभी उपयोगकर्ता, केवल संगठन के व्यवस्थापक, या केवल संगठन और प्रोजेक्ट के व्यवस्थापक। अन्य उपयोगकर्ताओं को संगठन के व्यवस्थापक से एप्लिकेशन की मंज़ूरी लेने के लिए कहने वाला संदेश दिखाई देगा।

एक्सेस रद्द करना। आप अपने खाता सुरक्षा सेटिंग के Authorized Applications अनुभाग से किसी भी समय अपने खाते के लिए एप्लिकेशन का एक्सेस रद्द कर सकते हैं। संगठन के व्यवस्थापक OAuth Access Tokens पेज से हर उपयोगकर्ता के एक्सेस टोकन की समीक्षा करके उन्हें रद्द कर सकते हैं, या Connected Applications पेज से किसी एप्लिकेशन का एक्सेस पूरी तरह रद्द कर सकते हैं।

संगठन नियंत्रण

संगठन के व्यवस्थापक Connected Applications पेज पर (जो आपके संगठन के Developer API पेज से भी लिंक है) यह नियंत्रित कर सकते हैं कि प्रत्येक स्वीकृत MCP क्लाइंट को उनके संगठन में क्या करने की अनुमति है। किसी एप्लिकेशन की सेटिंग देखने या बदलने के लिए उस पर क्लिक करें। ये सेटिंग संगठन में उस एप्लिकेशन तक हर उपयोगकर्ता के एक्सेस पर लागू होती हैं, चाहे उपयोगकर्ताओं ने उसे कनेक्ट करते समय जो भी अनुमतियाँ दी हों।

आवश्यक अनुमति – संगठन के कौन-से उपयोगकर्ता एप्लिकेशन को अधिकृत कर सकते हैं (सभी उपयोगकर्ता, केवल संगठन के व्यवस्थापक, या केवल संगठन और प्रोजेक्ट के व्यवस्थापक)।

अनुमत कार्रवाइयाँ – हर कार्रवाई श्रेणी के लिए, यह तय करें कि एप्लिकेशन स्वयं कार्रवाई कर सकता है, उपयोगकर्ता को हर कार्रवाई को मंज़ूरी देनी होगी, या कार्रवाई की बिल्कुल अनुमति नहीं है:

कार्रवाई	विवरण	विकल्प	डिफ़ॉल्ट
डेटा पढ़ना	संपर्क, संदेश, आँकड़े और अन्य प्रोजेक्ट डेटा खोजना।	अनुमति है, अनुमति नहीं है	अनुमति है
डेटा बनाना और अपडेट करना	संपर्क, समूह, सेवाएँ, ड्राफ़्ट कैंपेन, रूट और अन्य प्रोजेक्ट डेटा बनाना और संपादित करना।	अनुमति है, मंज़ूरी आवश्यक, अनुमति नहीं है	अनुमति है
संदेश भेजना और सेवाएँ ट्रिगर करना	संपर्कों को संदेश और कॉल भेजना या शेड्यूल करना, स्वचालित सेवाएँ ट्रिगर करना और स्क्रिप्ट चलाना।	अनुमति है, मंज़ूरी आवश्यक, अनुमति नहीं है	मंज़ूरी आवश्यक
डेटा हटाना	संपर्क, संदेश, सेवाएँ और अन्य प्रोजेक्ट डेटा हटाना।	अनुमति है, मंज़ूरी आवश्यक, अनुमति नहीं है	मंज़ूरी आवश्यक
बाहरी वेब अनुरोध करना	इस एप्लिकेशन द्वारा चलाई जाने वाली स्क्रिप्ट से बाहरी वेबसाइटों और तृतीय-पक्ष API को अनुरोध भेजना।	अनुमति है, अनुमति नहीं है	अनुमति है

जब किसी श्रेणी को अनुमति नहीं है पर सेट किया जाता है, तो उससे संबंधित MCP टूल (जैसे send_api या delete_api) MCP क्लाइंट से छिपा रहता है और उस श्रेणी का कोई भी API अनुरोध अस्वीकार कर दिया जाता है। run_script टूल संदेश भेजने, डेटा बनाने/अपडेट करने और डेटा हटाने की सेटिंग में से सबसे सख्त सेटिंग का पालन करता है।

कुछ एप्लिकेशन अपने डिफ़ॉल्ट निर्दिष्ट करते हैं – उदाहरण के लिए, ऐसा स्वायत्त एजेंट जिसे उपयोगकर्ता की अनुपस्थिति में संदेश भेजने की आवश्यकता हो। जब किसी एप्लिकेशन का डिफ़ॉल्ट मान मानक डिफ़ॉल्ट से अलग होता है, तो Connected Applications पेज सेटिंग के पास एप्लिकेशन का डिफ़ॉल्ट दिखाता है। आपके संगठन की सेटिंग को हमेशा प्राथमिकता मिलती है।

अनुमत अनुमतियाँ – इस संगठन में एप्लिकेशन किस प्रकार के डेटा और कार्रवाइयों को एक्सेस कर सकता है। किसी अनुमति का चेक हटाने से संगठन में एप्लिकेशन के सभी उपयोगकर्ताओं के लिए संबंधित API कार्रवाइयाँ अवरुद्ध हो जाती हैं, भले ही किसी उपयोगकर्ता ने एप्लिकेशन कनेक्ट करते समय वह अनुमति दी हो।

एक्सेस रद्द करें – एप्लिकेशन को आपके संगठन के स्वीकृत एप्लिकेशन की सूची से हटाता है और संगठन में उसके सभी मौजूदा एक्सेस टोकन रद्द करता है।

आपके अपने संगठन के स्वामित्व वाले एप्लिकेशन (Add OAuth Client के माध्यम से जोड़े गए) को मंज़ूरी की आवश्यकता नहीं होती, और उनकी अनुमत कार्रवाइयाँ एप्लिकेशन के अपने सेटिंग पेज पर कॉन्फ़िगर की जाती हैं।

मानव की पुष्टि आवश्यक

जब Connected Applications पेज पर किसी कार्रवाई श्रेणी को मंज़ूरी आवश्यक पर सेट किया जाता है, तो MCP क्लाइंट तब तक वे कार्रवाइयाँ नहीं कर सकता जब तक कोई उपयोगकर्ता हर कार्रवाई को स्पष्ट रूप से मंज़ूरी न दे। डिफ़ॉल्ट रूप से, यह संदेश भेजने और सेवाएँ ट्रिगर करने, तथा डेटा हटाने पर लागू होता है।

संदेश भेजने की श्रेणी में संदेश और कॉल भेजना या शेड्यूल करना, संदेश फिर से भेजना, स्वचालित सेवाएँ ट्रिगर करना, बैच टास्क बनाना, आने वाले संदेशों का अनुकरण करना, शेड्यूल किए गए संदेशों या कैंपेन को संपादित करना, किसी स्वचालित सेवा को सक्रिय करना या सक्रिय सेवा का कॉन्फ़िगरेशन बदलना, वेबहुक बनाना या वेबहुक URL बदलना, किसी रूट का फ़ोन नंबर या प्रदाता सेटिंग बदलना, प्रोजेक्ट का डिफ़ॉल्ट रूट बदलना, और run_script टूल से स्क्रिप्ट चलाना शामिल है। डेटा हटाने की श्रेणी में हटाने की सभी विधियाँ, साथ ही किसी प्रोजेक्ट की संदेश प्रतिधारण अवधि कम करना शामिल है।

MCP क्लाइंट के आधार पर, आप निम्नलिखित में से किसी एक तरीके से कार्रवाई को मंज़ूरी दे सकते हैं:

MCP क्लाइंट में मंज़ूरी का संकेत

यदि MCP क्लाइंट MCP elicitation का समर्थन करता है (MCP प्रोटोकॉल संस्करण 2026-07-28 या उसके बाद का उपयोग करके), तो वह आपको सीधे कार्रवाई मंज़ूर करने के लिए संकेत देता है। इसमें सरल भाषा में बताया जाता है कि कार्रवाई क्या करेगी और किस प्रोजेक्ट को प्रभावित करेगी। यदि आप मंज़ूरी देते हैं, तो कार्रवाई तुरंत की जाती है। यदि आप मना करते हैं, तो कार्रवाई नहीं की जाती और AI मॉडल को बताया जाता है कि वह दोबारा प्रयास न करे।

संदेश ड्राफ़्ट

यदि MCP क्लाइंट MCP Apps एक्सटेंशन का समर्थन करता है, तो AI मॉडल आपको प्राप्तकर्ताओं सहित टेक्स्ट संदेश का संपादन योग्य ड्राफ़्ट दिखाने के लिए draft_message टूल का उपयोग कर सकता है। Send पर क्लिक करने से ठीक उसी संदेश को उन्हीं प्राप्तकर्ताओं को भेजने की मंज़ूरी मिलती है।

मंज़ूरी लिंक

यदि MCP क्लाइंट ऊपर दिए गए किसी भी तरीके का समर्थन नहीं करता, या कार्रवाई को उन तरीकों से मंज़ूरी नहीं दी जा सकती, तो AI मॉडल को Telerivet वेब ऐप के Approve Action पेज का लिंक मिलता है और उसे आपसे वह पेज खोलने के लिए कहना चाहिए। इस पेज पर एप्लिकेशन, प्रोजेक्ट, कार्रवाई का विवरण और अनुरोध की पूरी जानकारी दिखाई जाती है। Approve पर क्लिक करने के बाद, MCP क्लाइंट पर लौटें और उससे फिर से प्रयास करने को कहें।

किसी कार्रवाई को मंज़ूरी देने के लिए, आपके पास उस कार्रवाई के लिए आवश्यक अनुमति होनी चाहिए (उदाहरण के लिए, प्रोजेक्ट में संदेश भेजने की अनुमति)। किसी कार्रवाई को मंज़ूरी देने से एप्लिकेशन को कोई अतिरिक्त अनुमति नहीं मिलती।

मंज़ूरियाँ कैसे काम करती हैं

• हर मंज़ूरी केवल एक सटीक अनुरोध पर लागू होती है – वही API विधि और वही पैरामीटर – और उसका उपयोग केवल एक बार किया जा सकता है। यदि AI मॉडल अनुरोध में कुछ भी बदलता है, तो उसे फिर से मंज़ूरी लेनी होगी।
• मंज़ूरियाँ 1 घंटे बाद समाप्त हो जाती हैं।
• run_script के माध्यम से आपके द्वारा मंज़ूर की गई स्क्रिप्ट से किए गए API अनुरोधों के लिए अलग से मंज़ूरी आवश्यक नहीं है।
• यदि एप्लिकेशन MCP के बजाय अपने एक्सेस टोकन से सीधे REST API को कॉल करता है, तो मंज़ूरी आवश्यक करने वाले अनुरोध confirmation_required त्रुटि कोड के साथ विफल हो जाते हैं और त्रुटि संदेश में मंज़ूरी लिंक शामिल होता है। जिन एप्लिकेशन को उपयोगकर्ता की अनुपस्थिति में ये कार्रवाइयाँ करनी हों (जैसे सर्वर-साइड इंटीग्रेशन या स्वायत्त एजेंट), उनके लिए संगठन के व्यवस्थापक को श्रेणी अनुमति है पर सेट करनी होगी।

संदेश समीक्षा। उपरोक्त से स्वतंत्र रूप से, यदि किसी प्रोजेक्ट की Messaging Settings में Message Review सक्षम है, तो कॉन्फ़िगर की गई सीमाओं से अधिक API के माध्यम से भेजे गए संदेश (MCP के माध्यम से भेजे गए संदेशों सहित) समीक्षक की मंज़ूरी मिलने तक लंबित संदेशों के रूप में रोके जाते हैं। यह वेब ऐप से भेजे गए संदेशों पर लागू प्रक्रिया के समान है।

टूल

MCP सर्वर वर्तमान में निम्नलिखित टूल उपलब्ध कराता है:

• list_api_methods – उपलब्ध API विधियों को उनके नाम, विवरण और पैरामीटर सारांश के साथ सूचीबद्ध करता है। श्रेणी के अनुसार फ़िल्टर करने की सुविधा है।
• get_method_schema – किसी विशिष्ट API विधि के लिए पूरा पैरामीटर स्कीमा और प्रतिक्रिया फ़ील्ड के विवरण लौटाता है।
• read_api – डेटा प्राप्त करने के लिए केवल-पढ़ने वाली API विधि निष्पादित करता है।
• modify_api – डेटा बनाने या अपडेट करने वाली API विधि निष्पादित करता है।
• delete_api – डेटा हटाने वाली API विधि निष्पादित करता है।
• send_api – संदेश भेजने, शेड्यूल करने या प्राप्त करने, स्वचालित सेवाएँ शुरू करने या बैच कार्य करने वाली API विधि निष्पादित करता है।
• run_analysis_script – Telerivet के Cloud Script API सैंडबॉक्स में केवल-पढ़ने वाला JavaScript चलाता है, ताकि प्रोजेक्ट डेटा का विश्लेषण किया जा सके। यह एग्रीगेशन, एंटिटी प्रकारों के बीच जॉइन करने या मॉडल के माध्यम से सभी रिकॉर्ड को पेज करके लाए बिना कई रिकॉर्ड स्कैन करने के लिए उपयोगी है। API का ऐक्सेस केवल-पढ़ने तक सीमित है और आउटबाउंड HTTP अक्षम है।
• run_script – Cloud Script API ऐक्सेस (रीड, राइट, संदेश भेजना, HTTP अनुरोध) के साथ JavaScript चलाता है। यह उन बल्क ऑपरेशनों के लिए है जिनमें अन्यथा कई अलग-अलग API कॉल करने पड़ते। स्क्रिप्ट द्वारा किए गए API अनुरोध OAuth टोकन के स्कोप के अनुसार जाँचे जाते हैं, इसलिए स्क्रिप्ट उस टोकन से अधिक कुछ नहीं कर सकती जिसने उसे चलाया है।
• get_web_app_urls – वेब ऐप की सुविधाओं और URL पैटर्न के बारे में जानकारी लौटाता है। इससे AI एजेंट उन सुविधाओं के लिंक बना सकते हैं जो सीधे API के माध्यम से उपलब्ध नहीं हैं। बिना क्वेरी के, यह सभी पेजों की संक्षिप्त सूची लौटाता है; कीवर्ड या URL पाथ से खोजने पर मेल खाने वाले पेजों का पूरा विवरण मिलता है।
• draft_message – एक या अधिक फ़ोन नंबरों (या संपर्कों के समूह) के लिए एक साधारण टेक्स्ट संदेश का ड्राफ़्ट तैयार करता है और भेजने से पहले उपयोगकर्ता की मंज़ूरी माँगता है (देखें संदेश के ड्राफ़्ट)। यह केवल तभी उपलब्ध है जब MCP क्लाइंट MCP Apps एक्सटेंशन का समर्थन करता हो।
• get_route_options – उपलब्ध मैसेजिंग रूट/चैनल विकल्पों के बारे में जानकारी लौटाता है। देश, चैनल प्रकार या उपयोग के मामले के अनुसार फ़िल्टर करने पर (या किसी विशिष्ट रूट प्रकार को देखने पर) भौगोलिक उपलब्धता, अनुपालन आवश्यकताओं, पंजीकरण प्रक्रिया, बिलिंग मोड (आंतरिक/Telerivet-प्रबंधित बनाम बाहरी/BYOC), सेटअप समय-सीमा और मूल्य निर्धारण सहित पूरा विवरण मिलता है।
• skillbook_search / skillbook_get – किसी इरादे या उपयोग के मामले से मेल खाने वाले सामान्य समाधान पैटर्न, सेवाओं, अभियान प्रकारों, प्लेटफ़ॉर्म सुविधाओं और संदेश टेम्पलेट के बारे में जानकारी लौटाता है।
• search_documentation / get_documentation – Telerivet के दस्तावेज़ संग्रह में खोज करता है और उससे प्रविष्टियाँ प्राप्त करता है। इसमें User Guide के सहायता लेख, कानूनी/नीति पृष्ठ, डेवलपर API दस्तावेज़ और www.telerivet.com पर मार्केटिंग/कंपनी की सामग्री शामिल है।

MCP सर्वर द्वारा उपलब्ध कराए गए टूल और API विधियाँ समय के साथ बदल सकती हैं।

नीचे दिए गए लिंक MCP सर्वर द्वारा लौटाए गए JSON दिखाते हैं, जो उपलब्ध टूल और API विधियों को समझने में मदद कर सकते हैं:

• टूल की परिभाषाएँ
• list_api_methods टूल का आउटपुट
• Project_queryContacts विधि के लिए get_method_schema टूल का आउटपुट (अन्य API विधियों का स्कीमा देखने के लिए URL के अंतिम घटक को बदलें)
• Cloud Script API संदर्भ के लिए get_documentation टूल का आउटपुट (दस्तावेज़ की अन्य प्रविष्टियाँ देखने के लिए URL के अंतिम घटक को बदलें)

आपके OAuth टोकन को दिए गए स्कोप और ऐप के लिए आपके संगठन के नियंत्रण यह निर्धारित करते हैं कि कौन-से टूल और API विधियाँ उपलब्ध हैं। जिन विधियों के लिए ऐसा स्कोप आवश्यक है जो आपके टोकन के पास नहीं है, या जिन्हें आपका संगठन ऐप के लिए अनुमति नहीं देता, उन्हें सूची से बाहर रखा जाएगा।