MCP के साथ AI एजेंट्स को BroadNet से कनेक्ट करें।

MCP सर्वर क्या है

Model Context Protocol (MCP) एक ओपन स्टैंडर्ड है जो AI असिस्टेंट्स को बाहरी टूल्स खोजने और उन्हें कॉल करने की अनुमति देता है। BroadNet MCP सर्वर एक रिमोट MCP सर्वर है: आपका क्लाइंट HTTPS के माध्यम से इससे कनेक्ट होता है, यह जो टूल्स ऑफर करता है उनकी लिस्ट देखता है, और आपकी ओर से उन्हें कॉल करता है।

ये टूल्स API रेफरेंस और OpenAPI स्पेक में दस्तावेजीकृत BroadNet API के समान हैं — जैसे मैसेज भेजना, WhatsApp टेम्पलेट्स के साथ काम करना, और डिलीवरी रिपोर्ट पढ़ना। एजेंट आपके द्वारा दिए गए टोकन की अनुमतियों के साथ काम करता है, ठीक वैसे ही जैसे आपका अपना कोड करेगा।

दो MCP सर्वर: नॉलेज और मैसेजिंग

BroadNet दो MCP सर्वर चलाता है। इस पेज पर वर्णित मैसेजिंग सर्वर आपके अकाउंट पर काम करता है। नॉलेज सर्वर पब्लिक है: एक एजेंट बिना लॉगिन के BroadNet के कवरेज, सेंडर ID नियमों, प्रकाशित लिस्ट कीमतों, रेगुलेशंस और कंपनी के तथ्यों के बारे में पूछ सकता है।

एक टर्मिनल से नॉलेज सर्वर का उपयोग करें: पहले initialize handshake, फिर एक tool call।

curl -X POST https://www.broadnet.me/mcp \
  -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"}}}'

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'

एंडपॉइंट और ऑथेंटिकेशन

प्रत्येक अकाउंट के लिए एक एंडपॉइंट है: https://mcp.broadnet.me/mcp। प्रत्येक रिक्वेस्ट में Authorization हेडर में आपका BroadNet टोकन होना चाहिए।

आपको टोकन अपने BroadNet अकाउंट से प्राप्त होता है। डेमो में इसे BroadAdmin पोर्टल में Integrations → MCP Integration के तहत “Get temporary key” के माध्यम से जनरेट किया जाता है; पोर्टल यह नोट करता है कि परमानेंट की आपके अकाउंट एडमिन या मास्टर अकाउंट द्वारा जारी की जाती है।

बिना हेडर के किए गए अनुरोध को प्रोटोकॉल स्तर पर ही अस्वीकार कर दिया जाता है — अन-ऑथेंटिकेटेड इनिशियलाइज़ कॉल के लिए सर्वर का वास्तविक उत्तर यह है:

event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' header."}}

एक MCP क्लाइंट कनेक्ट करें

अधिकांश MCP क्लाइंट्स सर्वर URL और रिक्वेस्ट हेडर के साथ JSON कॉन्फ़िगरेशन का उपयोग करते हैं। एक सामान्य एंट्री इस तरह दिखती है:

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

क्लाइंट के बिना कनेक्शन टेस्ट करने के लिए, स्वयं MCP इनिशियलाइज़ रिक्वेस्ट भेजें:

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"}}}'

डेमो क्या दिखाता है

प्रोडक्ट टीम की रिकॉर्डिंग MCP क्लाइंट के रूप में Cursor का उपयोग करते हुए, पूरे फ्लो को पाँच चरणों में समझाती है:

1. 1
   साइन इन करें

   अपने BroadNet अकाउंट के साथ BroadAdmin पोर्टल में लॉग इन करें।

2. 2
   एक key और कॉन्फ़िगरेशन प्राप्त करें

   ओपन इंटीग्रेशन → MCP इंटीग्रेशन, एक टेम्परेरी की जनरेट करें और रेडी-मेड क्लाइंट कॉन्फ़िगरेशन कॉपी करें।

3. 3
   क्लाइंट में सर्वर जोड़ें

   MCP क्लाइंट में, एक नया MCP सर्वर जोड़ें और कॉन्फ़िगरेशन को mcp.json में पेस्ट करें — Bearer हेडर के साथ URL https://mcp.broadnet.me/mcp।

4. 4
   टूल्स की समीक्षा करें

   क्लाइंट कनेक्ट होता है और BroadNet टूल्स की लिस्ट दिखाता है, जिनमें से प्रत्येक को ऑन या ऑफ किया जा सकता है।

5. 5
   साधारण भाषा में पूछें

   यूज़र एजेंट से एक नंबर पर WhatsApp मैसेज भेजने के लिए कहता है। एजेंट WhatsApp सेंड टूल चुनता है, API मैसेज स्वीकार होने के साथ HTTP 200 का उत्तर देता है, और मैसेज बिजनेस अकाउंट से WhatsApp में पहुँच जाता है।

रिकॉर्डिंग में क्लाइंट 380 BroadNet टूल्स की रिपोर्ट करता है, जिनमें send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send और get_report_delivery शामिल हैं। सटीक सूची सर्वर संस्करण और आपके अकाउंट पर निर्भर करती है।

उसी रिकॉर्डिंग के एक नरेटेड वर्जन से एक ओवरव्यू कार्ड जुड़ जाता है: एक MCP एंडपॉइंट, और हर एजेंट के लिए वही कॉपी-एंड-पेस्ट स्टेप्स।

सुरक्षा संबंधी नोट्स

• टोकन एक सेंड क्रेडेंशियल है

  जिसके पास भी यह है, वह आपके अकाउंट से मैसेज भेज सकता है। इसे पासवर्ड की तरह स्टोर करें, कभी भी किसी साझा या कमिटेड फ़ाइल में न रखें।

• प्रयोगों के लिए टेम्परेरी कीज़ को प्राथमिकता दें

  जब आप चीज़ें आज़मा रहे हों तो एक टेम्परेरी key का उपयोग करें, और परमानेंट key केवल प्रोडक्शन एजेंट के लिए अपने अकाउंट एडमिन से मांगें।

• केवल उन्हीं टूल्स को सक्षम करें जिनकी आपको आवश्यकता है

  MCP क्लाइंट्स आपको व्यक्तिगत टूल्स को बंद करने की सुविधा देते हैं। एक एजेंट जो केवल SMS भेजता है, उसे टेम्पलेट, ऑनबोर्डिंग या अकाउंट टूल्स की आवश्यकता नहीं होती है।

• ह्यूमन इन द लूप बनाए रखें

  एजेंट्स नेचुरल-लैंग्वेज निर्देशों पर काम करते हैं। मैसेज भेजने वाले टूल्स, विशेष रूप से कई प्राप्तकर्ताओं को, इस्तेमाल करने से पहले क्लाइंट से कन्फर्मेशन मांगें।

• लीक हुए टोकन को रद्द करें

  यदि कोई टोकन एक्सपोज़ होता है, तो उसे रद्द करने और नया जारी करने के लिए अपने अकाउंट एडमिन या BroadNet सपोर्ट से संपर्क करें।

संबंधित

प्रश्न