ैसेजिंग के लिए एक MCP सर्वर मैसेजिंग API को ऐसे टूल्स के रूप में प्रदर्शित करता है जिन्हें एक AI एजेंट Model Context Protocol के माध्यम से खोज सकता है और कॉल कर सकता है, ताकि एक असिस्टेंट अनुरोध पर SMS या WhatsApp मैसेज भेज सके। BroadNet उसी API का उपयोग करके https://mcp.broadnet.me/mcp, पर Streamable HTTP ट्रांसपोर्ट और एक Bearer टोकन के साथ एक सर्वर चलाता है, जो WhatsApp, SMS, RCS, Telegram, Push, Email, Messenger और Instagram को सेवा प्रदान करता है। यह गाइड समझाती है कि यह कैसे काम करता है और, इससे भी महत्वपूर्ण बात यह है कि किसी एजेंट को गलत लोगों को मैसेज भेजने से कैसे रोका जाए।
मुख्य बातें
- MCP एक ओपन प्रोटोकॉल है, जो JSON-RPC 2.0 पर बना है, जो AI एप्लिकेशन को बाहरी टूल्स खोजने और कॉल करने की अनुमति देता है। एक मैसेजिंग MCP सर्वर, send, template और report एंडपॉइंट्स को टूल्स में बदल देता है।
- रिमोट सर्वर Streamable HTTP ट्रांसपोर्ट का उपयोग करते हैं: एक HTTPS एंडपॉइंट, और हर क्लाइंट मैसेज एक HTTP POST है। लोकल सर्वर आमतौर पर stdio का उपयोग करते हैं।
- BroadNet MCP सर्वर https://mcp.broadnet.me/mcp पर है और Authorization: Bearer हेडर के बिना किसी भी अनुरोध को अस्वीकार कर देता है।
- एक टोकन एक 'सेंड क्रेडेंशियल' है। एजेंट अपनी अनुमतियों (permissions) के साथ कार्य करता है, ठीक वैसे ही जैसे आपका अपना कोड करेगा।
- MCP स्पेसिफिकेशन कहता है कि हमेशा एक 'ह्यूमन इन द लूप' होना चाहिए जो टूल कॉल्स को अस्वीकार कर सके, और सर्वर को टूल इनवोकेशन पर रेट-लिमिट लगाना अनिवार्य है। हर सेंड टूल के आसपास सहमति, शांत समय (quiet hours), सीमाएं और अनुमोदन (approvals) बनाएँ।
Model Context Protocol क्या है?
MCP स्पेसिफिकेशन MCP को "एक खुला प्रोटोकॉल जो LLM एप्लिकेशन और बाहरी डेटा स्रोतों और टूल्स के बीच निर्बाध एकीकरण सक्षम बनाता है" के रूप में वर्णित करता है। यह तीन भूमिकाओं के बीच JSON-RPC 2.0 संदेशों का उपयोग करता है: होस्ट (AI एप्लिकेशन), क्लाइंट (होस्ट के भीतर कनेक्टर) और सर्वर (वे सेवाएँ जो टूल्स, रिसोर्स और प्रॉम्प्ट प्रदान करती हैं)। 26 सितंबर 2026 तक, स्पेसिफिकेशन का नवीनतम संशोधन 2026-07-28 का है।
मैसेजिंग के लिए टूल्स ही सबसे महत्वपूर्ण हिस्सा हैं। एक क्लाइंट उन्हें tools/list के साथ सूचीबद्ध करता है, मॉडल उनमें से एक को चुनता है, और क्लाइंट tools/call के साथ उसे इनवोक करता है। स्पेसिफिकेशन टूल्स को "मॉडल-नियंत्रित" कहता है: मॉडल तय करता है कि उनका उपयोग कब करना है। यही कारण है कि एक सेंड टूल को ऐसे गार्डरेल्स की आवश्यकता होती है जिनसे मॉडल अपनी बातों से बच न सके।
SMS और WhatsApp के लिए MCP सर्वर कैसे काम करता है?
अनुरोध पथ (request path) में पांच हॉप्स होते हैं। डिज़ाइन का मुख्य बिंदु यह है कि MCP सर्वर कोई नई भेजने की शक्ति नहीं जोड़ता है; यह आपके पास पहले से मौजूद API को उसी टोकन और उसी नियंत्रण के तहत प्रदर्शित करता है।
- एक उपयोगकर्ता AI होस्ट से पूछता है, उदाहरण के लिए: "WhatsApp पर इस ग्राहक को डिलीवरी अपडेट भेजें।"
- मॉडल MCP क्लाइंट द्वारा प्राप्त की गई सूची में से एक टूल चुनता है, जैसे कि एक WhatsApp सेंड टूल, और उसके आर्गुमेंट्स भरता है।
- MCP क्लाइंट Bearer टोकन के साथ https://mcp.broadnet.me/mcp को HTTP POST के रूप में tools/call रिक्वेस्ट भेजता है।
- BroadNet MCP सर्वर टोकन को वैलिडेट करता है और संबंधित BroadNet API एंडपॉइंट को कॉल करता है।
- API मैसेज को WhatsApp या मोबाइल नेटवर्क पर रूट करता है और एक परिणाम वापस भेजता है, जो टूल परिणाम के रूप में मॉडल के पास वापस जाता है।
प्रोडक्ट टीम की डेमो रिकॉर्डिंग में, क्लाइंट 380 BroadNet टूल्स की सूची देता है, जिनमें send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send और get_report_delivery शामिल हैं। सटीक सूची सर्वर वर्ज़न और आपके अकाउंट पर निर्भर करती है; MCP सर्वर डॉक्यूमेंटेशन देखें।
Streamable HTTP या stdio: कौन सा ट्रांसपोर्ट इस्तेमाल करें?
स्पेसिफिकेशन दो स्टैंडर्ड ट्रांसपोर्ट को परिभाषित करता है। आप किसका उपयोग करते हैं यह इस पर निर्भर करता है कि सर्वर कहाँ चल रहा है, और यही तय करता है कि आप ऑथेंटिकेट कैसे करते हैं।
| stdio | Streamable HTTP | |
|---|---|---|
| सर्वर कहाँ चलता है | क्लाइंट द्वारा लॉन्च किए गए एक सबप्रोसेस के रूप में, उसी मशीन पर | HTTPS के माध्यम से पहुँचा जाने वाली एक स्वतंत्र सर्विस के रूप में |
| मैसेज कैसे ट्रैवल करते हैं | स्टैंडर्ड इनपुट और आउटपुट पर न्यूलाइन-डेलिमिटेड JSON-RPC | प्रत्येक क्लाइंट मैसेज एक सिंगल MCP एंडपॉइंट पर HTTP POST है; जवाब JSON या सर्वर-सेंट-इवेंट्स स्ट्रीम के रूप में वापस आते हैं |
| क्रेडेंशियल्स कैसे काम करते हैं | स्पेसिफिकेशन कहता है कि stdio सर्वर को एनवायरनमेंट से क्रेडेंशियल्स पढ़ने चाहिए | प्रत्येक अनुरोध पर एक Authorization: Bearer हेडर; टोकन को कभी भी क्वेरी स्ट्रिंग में नहीं भेजा जाना चाहिए |
| सामान्य उपयोग | लोकल डेवलपर टूल्स | होस्टेड सेवाएँ जो कई क्लाइंट्स द्वारा साझा की जाती हैं, जैसे कि एक मैसेजिंग API |
| BroadNet | उपलब्ध नहीं है | https://mcp.broadnet.me/mcp |
HTTP सर्वर के लिए, स्पेसिफिकेशन के 2025-06-18 रिवीज़न में सर्वर के लिए Origin हेडर को वैलिडेट करना भी आवश्यक है और यह अनुशंसा की जाती है कि वे प्रत्येक कनेक्शन को ऑथेंटिकेट करें। नवीनतम रिवीज़न (2026-07-28) प्रत्येक अनुरोध को सेल्फ-कंटेन्ड बनाता है, जिसमें प्रोटोकॉल वर्ज़न और क्लाइंट क्षमताएं उसके अपने मेटाडेटा में होती हैं; पिछले रिवीज़न एक इनिशियलाइज़ हैंडशेक के साथ सेशन खोलते थे, और क्लाइंट यह पता लगा लेते थे कि सर्वर कौन सा रिवीज़न सपोर्ट करता है और फिर उसी के अनुसार काम करते थे।
आप AI एजेंट को BroadNet के MCP सर्वर से कैसे कनेक्ट करते हैं?
- अपने BroadNet अकाउंट से एक टोकन प्राप्त करें। BroadAdmin पोर्टल में, Integrations, फिर MCP Integration, एक अस्थायी की (temporary key) जारी करता है; एक स्थायी की (permanent key) आपके अकाउंट एडमिन या मास्टर अकाउंट से प्राप्त होती है।
- सर्वर को अपने MCP क्लाइंट में जोड़ें। अधिकांश क्लाइंट नीचे दिए गए उदाहरण की तरह JSON कॉन्फ़िगरेशन का उपयोग करते हैं। फ़ील्ड के नाम अलग-अलग क्लाइंट्स के बीच थोड़े भिन्न हो सकते हैं, इसलिए अपने क्लाइंट के डॉक्यूमेंटेशन की जाँच करें।
- टोकन को उन फ़ाइलों में न रखें जिन्हें आप कमिट (commit) करते हैं। अपने क्लाइंट के एनवायरनमेंट-वेरिएबल सपोर्ट का उपयोग करें, जैसा कि नीचे दिए गए कॉन्फ़िगरेशन में किया गया है।
- टूल लिस्ट खोलें और उन सभी टूल्स को बंद कर दें जिनकी एजेंट को आवश्यकता नहीं है।
- एजेंट को कस्टमर डेटा के पास ले जाने से पहले, अपने स्वयं के नंबर पर एक मैसेज भेजकर टेस्ट करें।
{ "mcpServers": { "broadnet": { "type": "http", "url": "https://mcp.broadnet.me/mcp", "headers": { "Authorization": "Bearer ${BROADNET_TOKEN}" } } }}क्लाइंट के बिना कनेक्शन का परीक्षण करने के लिए, स्वयं initialize रिक्वेस्ट भेजें:
curl -X POST https://mcp.broadnet.me/mcp \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{}, "clientInfo":{"name":"curl","version":"1.0"}}}'हेडर के बिना, सर्वर प्रोटोकॉल स्तर पर कॉल को अस्वीकार कर देता है। 26 सितंबर 2026 को जाँच के अनुसार, एक अन-ऑथेंटिकेटेड initialize रिक्वेस्ट के लिए यह सर्वर का वास्तविक जवाब है:
event: messagedata: {"jsonrpc":"2.0","id":1,"error":{"code":-32001, "message":"Authorization bearer token is required. Connect with an 'Authorization: Bearer <BroadNet token>' header."}}क्या AI एजेंट को मैसेजिंग API key देना सुरक्षित है?
केवल कुछ सीमाओं के साथ। यह टोकन एक सेंड क्रेडेंशियल है: जिसके पास भी यह होगा, चाहे वह कोई व्यक्ति हो या कोई एजेंट, वह आपके अकाउंट से मैसेज भेज सकता है, और हर मैसेज भेजने की लागत आती है और वह एक वास्तविक व्यक्ति तक पहुँचता है। एजेंट प्राकृतिक भाषा के निर्देशों पर भी काम करते हैं, और उस टेक्स्ट का कुछ हिस्सा बाहर से आता है: एक इनबाउंड ग्राहक मैसेज या वेब पेज में ऐसे निर्देश हो सकते हैं जिनका मॉडल पालन करने की कोशिश कर सकता है। MCP स्पेसिफिकेशन इस बारे में स्पष्ट है। यह कहता है कि होस्ट को किसी भी टूल को सक्रिय करने से पहले उपयोगकर्ता की स्पष्ट सहमति प्राप्त करना अनिवार्य है, कि टूल के उपयोग को अस्वीकार करने की क्षमता के साथ हमेशा एक इंसान (human in the loop) होना चाहिए (SHOULD), और क्लाइंट्स को टूल एनोटेशन को तब तक अविश्वसनीय मानना अनिवार्य है जब तक कि वे किसी भरोसेमंद सर्वर से न आएं।
कौन से गार्डरेल्स (guardrails) एजेंट को ग्राहकों को स्पैम करने से रोकते हैं?
कंट्रोल्स को वहां रखें जहां मॉडल उन्हें बायपास न कर सके: क्लाइंट कॉन्फ़िगरेशन में, अपने स्वयं के मिडलवेयर में, या अकाउंट सेटिंग्स में, प्रॉम्प्ट में नहीं।
| जोखिम | कंट्रोल | यह कहां स्थित है |
|---|---|---|
| किसी ऐसे व्यक्ति को मैसेज भेजना जिसने ऑप्ट-इन नहीं किया है | किसी भी सेंड टूल को चलाने से पहले सहमति और ऑप्ट-आउट स्टेटस की जाँच करें | आपका मिडलवेयर या CRM |
| रात में या गलत दिन पर भेजना | प्राप्तकर्ता के टाइम ज़ोन और मार्केट नियमों के अनुसार शांत समय (Quiet hours) | आपका मिडलवेयर |
| उन टूल्स का उपयोग करना जिनकी कार्य में आवश्यकता नहीं है | केवल आवश्यक टूल्स को सक्षम करें; टेम्पलेट, ऑनबोर्डिंग और अकाउंट टूल्स को अक्षम करें | MCP क्लाइंट टूल सेटिंग्स |
| अनियंत्रित लूप और बल्क सेंडिंग | प्रति-एजेंट भेजने की सीमा और रेट लिमिट; स्पेसिफिकेशन के अनुसार सर्वर के लिए टूल इनवोकेशन पर रेट-लिमिट लगाना आवश्यक है | आपका मिडलवेयर और सर्वर |
| रीट्राई के बाद डुप्लिकेट मैसेज | रिटर्न किए गए मैसेज ID को सुरक्षित रखें और दोबारा भेजने से पहले उसकी स्थिति की जाँच करें | आपका एजेंट लॉजिक (idempotency गाइड देखें) |
| बिना समीक्षा के भेजा गया मार्केटिंग मैसेज | किसी भी मार्केटिंग या मल्टी-रेसिपिएंट मैसेज भेजने के लिए मानवीय अनुमोदन | MCP क्लाइंट कन्फर्मेशन प्रॉम्प्ट्स |
| इनबाउंड मैसेज में छिपे हुए निर्देश | इनबाउंड टेक्स्ट को डेटा की तरह मानें; इसे कभी भी यूजर के अनुरोध के बिना भेजने के लिए ट्रिगर न होने दें | AI होस्ट में प्रॉम्प्ट डिज़ाइन और अप्रूवल नियम |
| लीक हुआ टोकन | प्रयोगों के लिए अस्थायी कुंजियाँ (temporary keys), एनवायरनमेंट वेरिएबल्स, एक्सपोज़र होने पर रिवोक और रीइश्यू करें | BroadNet अकाउंट एडमिन |
| कोई ऑडिट ट्रेल नहीं | इनपुट और परिणामों के साथ हर टूल कॉल को लॉग करें | MCP क्लाइंट; स्पेसिफिकेशन कहता है कि क्लाइंट्स को टूल के उपयोग को लॉग करना चाहिए |
BroadNet API में कोई idempotency हेडर नहीं है, इसलिए टाइमआउट के बाद रिट्राय करने से संदेश दो बार भेजा जा सकता है। सुरक्षित तरीका यह है कि API द्वारा लौटाए गए मैसेज ID को स्टोर करें और दोबारा भेजने से पहले डिलीवरी स्टेटस की जांच करें; हमारे idempotency और retries गाइड बताते हैं कि यह कैसे किया जाए।
किन मैसेजिंग कार्यों के लिए मानवीय अनुमोदन (human approval) की आवश्यकता होनी चाहिए?
| एक्शन | सुझाया गया डिफॉल्ट | क्यों |
|---|---|---|
| डिलीवरी रिपोर्ट पढ़ें, टेम्पलेट्स की सूची देखें | ऑटोमैटिक | रीड-ओनली; कुछ भी ग्राहक तक नहीं पहुँचता |
| एक ज्ञात ग्राहक को भेजा गया एक ट्रांजैक्शनल SMS जिसने इसकी मांग की थी | सेंड कैप के भीतर ऑटोमैटिक, या वन-क्लिक कन्फर्म | कम जोखिम, उच्च मूल्य, ऑडिट करने में आसान |
| कोई भी मार्केटिंग मैसेज | हमेशा मानवीय अनुमोदन | सहमति, कंटेंट और लागत का जोखिम |
| एक से अधिक प्राप्तकर्ताओं को भेजना | हमेशा मानवीय अनुमोदन की आवश्यकता | एक गलती कई गुना बढ़ जाती है |
| WhatsApp टेम्पलेट्स बनाना या सबमिट करना | मानवीय अनुमोदन | टेम्पलेट्स की समीक्षा Meta द्वारा की जाती है और वे आपके ब्रांड का प्रतिनिधित्व करते हैं |
| अकाउंट, बिलिंग या ऑनबोर्डिंग टूल्स | डिसेबल किया गया | एक एजेंट को उस अकाउंट को नहीं बदलना चाहिए जिस पर वह चलता है |
MCP या एक साधारण REST API: एजेंट को किसका उपयोग करना चाहिए?
दोनों एक ही प्लेटफ़ॉर्म तक पहुँचते हैं। अंतर यह है कि कौन तय करता है कि कौन सी कॉल करनी है।
| BroadNet MCP सर्वर | BroadNet REST API | |
|---|---|---|
| कॉल का चुनाव कौन करता है | टूल लिस्ट में से मॉडल | आपका कोड |
| एंडपॉइंट | https://mcp.broadnet.me/mcp | https://api.broadnet.me, उदाहरण के लिए POST /sms/sendSms |
| ऑथेंटिकेशन | Authorization: Bearer token | Authorization: Bearer token |
| क्लाइंट लाइब्रेरी | कोई भी MCP क्लाइंट जो रिमोट सर्वर और कस्टम Authorization हेडर को सपोर्ट करता है | एक आधिकारिक SDK, @broadnet/cpaas-sdk (TypeScript/Node.js); OpenAPI spec से अन्य क्लाइंट्स जेनरेट करें |
| इनके लिए सर्वश्रेष्ठ | नेचुरल लैंग्वेज में असिस्टेंट्स, ऑपरेशन्स कोपायलट और एड-हॉक टास्क | फिक्स्ड लॉजिक वाले प्रोडक्शन फ्लो: OTP, अलर्ट्स, कैंपेन |
एक समझदारी भरा विभाजन: MCP का उपयोग वहां करें जहां कोई व्यक्ति एजेंट को निर्देशित कर रहा हो और कन्फर्मेशन प्रॉम्प्ट स्वीकार्य हो, और REST API का उपयोग उन फ्लो के लिए करें जिन्हें हर बार एक ही तरह से चलना चाहिए, जिसमें quickstart और curl generator शामिल हैं। हमारा API रेफरेंस MCP टूल्स के पीछे के एंडपॉइंट्स को डॉक्यूमेंट करता है।
अक्सर पूछे जाने वाले प्रश्न
मैसेजिंग के लिए MCP सर्वर क्या है?
एक ऐसा सर्वर जो मैसेजिंग API को एक्सपोज़ करता है, जैसे कि SMS भेजना, WhatsApp मैसेज भेजना या डिलीवरी रिपोर्ट प्राप्त करना, जिन्हें एक AI एजेंट Model Context Protocol के माध्यम से खोज सकता है और कॉल कर सकता है।
BroadNet MCP सर्वर URL क्या है?
https://mcp.broadnet.me/mcp. यह MCP Streamable HTTP ट्रांसपोर्ट का उपयोग करता है और प्रत्येक रिक्वेस्ट पर आपके BroadNet टोकन के साथ Authorization: Bearer हेडर की आवश्यकता होती है।
कौन से AI क्लाइंट इससे जुड़ सकते हैं?
कोई भी MCP क्लाइंट जो Streamable HTTP के माध्यम से रिमोट सर्वर से जुड़ सकता है और कस्टम Authorization हेडर भेज सकता है। BroadNet डेमो रिकॉर्डिंग में Cursor का उपयोग किया गया है।
क्या एजेंट वास्तविक मैसेज भेज सकता है?
हाँ। टूल्स आपके टोकन की अनुमतियों के साथ काम करते हैं, ठीक वैसे ही जैसे आपके अपने API कॉल्स करेंगे। प्रत्येक सेंड को वास्तविक मानें: केवल उन्हीं टूल्स को सक्षम करें जिनकी एजेंट को आवश्यकता है और भेजने से पहले पुष्टि अनिवार्य करें।
MCP के साथ Bearer ऑथेंटिकेशन कैसे काम करता है?
HTTP ट्रांसपोर्ट के लिए क्लाइंट प्रत्येक रिक्वेस्ट पर Authorization: Bearer के बाद टोकन भेजता है, यहाँ तक कि एक ही सेशन के भीतर भी, और इसे कभी भी URL क्वेरी स्ट्रिंग में नहीं भेजा जाता है। BroadNet का सर्वर इसके बिना रिक्वेस्ट को रिजेक्ट कर देता है।
stdio और Streamable HTTP के बीच क्या अंतर है?
stdio सर्वर को एक लोकल सबप्रोसेस के रूप में चलाता है और स्टैंडर्ड इनपुट और आउटपुट के माध्यम से न्यूलाइन-डेलिमिटेड JSON-RPC का आदान-प्रदान करता है। Streamable HTTP सर्वर को एक वेब सर्विस के रूप में चलाता है जहाँ प्रत्येक क्लाइंट मैसेज एक एंडपॉइंट पर HTTP POST होता है।
मैं AI एजेंट को ग्राहकों को स्पैम करने से कैसे रोकूँ?
मॉडल के बाहर कंसेंट चेक, क्वाइट आवर्स (quiet hours) और सेंड कैप्स (send caps) लागू करें, केवल उन्हीं टूल्स को सक्षम करें जिनकी आपको आवश्यकता है, मार्केटिंग और मल्टी-रेसिपिएंट संदेशों के लिए मानवीय अनुमोदन आवश्यक बनाएं, और प्रत्येक टूल कॉल को लॉग करें।
क्या मुझे MCP या REST API का उपयोग करना चाहिए?
MCP का उपयोग तब करें जब कोई व्यक्ति प्राकृतिक भाषा में एजेंट को निर्देशित करता है। REST API या TypeScript SDK का उपयोग OTP और अलर्ट जैसे निश्चित प्रोडक्शन फ्लो के लिए करें, जहाँ आपका कोड तय करता है कि क्या भेजना है, न कि कोई मॉडल।
स्रोत
- Model Context Protocol, स्पेसिफिकेशन ओवरव्यू (रिवीजन 2026-07-28), 26 सितंबर 2026 को एक्सेस किया गया।
- Model Context Protocol, Transports (2025-06-18) और Transports (2026-07-28), जिसे 26 सितंबर 2026 को एक्सेस किया गया था।
- Model Context Protocol, Authorization (2025-06-18), जिसे 26 सितंबर 2026 को एक्सेस किया गया था।
- Model Context Protocol, Tools (2026-07-28), जिसे 26 सितंबर 2026 को एक्सेस किया गया था।
- BroadNet, MCP सर्वर डॉक्यूमेंटेशन, और 26 सितंबर 2026 को https://mcp.broadnet.me/mcp का एक लाइव प्रोब।
संबंधित लेख: कस्टमर मैसेजिंग में AI एजेंट और एक एंटरप्राइज एजेंटिक AI प्लेटफ़ॉर्म चुनना।
