میسجنگ کے لیے MCP: AI ایجنٹس کس طرح محفوظ طریقے سے SMS اور WhatsApp بھیج سکتے ہیں

میسجنگ کے لیے ایک MCP سرور میسجنگ API کو ایسے ٹولز کے طور پر ظاہر کرتا ہے جنہیں ایک AI ایجنٹ Model Context Protocol کے ذریعے تلاش کر سکتا ہے اور کال کر سکتا ہے، تاکہ ایک اسسٹنٹ درخواست پر SMS یا WhatsApp میسج بھیج سکے۔ BroadNet اسی API پر https://mcp.broadnet.me/mcp, پر ایک سرور چلاتا ہے جو WhatsApp، SMS، RCS، Telegram، Push، Email، Messenger اور Instagram کے لیے استعمال ہوتا ہے، اور اس میں Streamable HTTP ٹرانسپورٹ اور Bearer ٹوکن کا استعمال کیا جاتا ہے۔ یہ گائیڈ وضاحت کرتی ہے کہ یہ کیسے کام کرتا ہے اور، اس سے بھی اہم بات یہ کہ، کسی ایجنٹ کو غلط لوگوں کو میسج بھیجنے سے کیسے روکا جائے۔

اہم نکات

• 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 ہیڈر کے بغیر کسی بھی درخواست کو مسترد کر دیتا ہے۔
• ٹوکن ایک سینڈ کریڈنشل (send credential) ہے۔ ایجنٹ اپنی اجازتوں کے ساتھ کام کرتا ہے، بالکل اسی طرح جیسے آپ کا اپنا کوڈ کام کرے گا۔
• MCP کی تفصیلات کے مطابق، ہمیشہ ایک انسان کا عمل میں ہونا چاہیے (SHOULD) جو ٹول کالز کو مسترد کر سکے، اور سرورز کے لیے ٹول کے استعمال کی شرح (rate-limit) مقرر کرنا لازمی (MUST) ہے۔ ہر سینڈ ٹول (send tool) کے گرد رضامندی، خاموش اوقات، حد (caps) اور منظوری کے نظام بنائیں۔

Model Context Protocol کیا ہے؟

MCP کی تفصیلات MCP کو "ایک ایسا اوپن پروٹوکول کے طور پر بیان کرتی ہیں جو LLM ایپلی کیشنز اور بیرونی ڈیٹا ذرائع اور ٹولز کے درمیان ہموار انٹیگریشن کو ممکن بناتا ہے"۔ یہ تین کرداروں کے درمیان JSON-RPC 2.0 پیغامات کا استعمال کرتا ہے: ہوسٹس (AI ایپلی کیشن)، کلائنٹس (ہوسٹ کے اندر کنیکٹرز) اور سرورز (وہ سروسز جو ٹولز، وسائل اور پرامپٹس فراہم کرتی ہیں)۔ 26 ستمبر 2026 کی تاریخ تک، اس تفصیلات کا تازہ ترین ورژن 2026-07-28 کا ہے۔

میسجنگ کے لیے ٹولز وہ حصہ ہیں جو اہمیت رکھتے ہیں۔ ایک کلائنٹ انہیں tools/list کے ذریعے فہرست میں شامل کرتا ہے، ماڈل ان میں سے ایک کا انتخاب کرتا ہے، اور کلائنٹ tools/call کے ذریعے اسے استعمال کرتا ہے۔ تفصیلات ٹولز کو "ماڈل کے زیرِ کنٹرول" قرار دیتی ہیں: یعنی ماڈل فیصلہ کرتا ہے کہ انہیں کب استعمال کرنا ہے۔ یہی وجہ ہے کہ ایک سینڈ ٹول (send tool) کو ایسے حفاظتی ضوابط (guardrails) کی ضرورت ہوتی ہے جن سے ماڈل اپنی باتوں سے بچ نہ سکے۔

SMS اور WhatsApp کے لیے MCP سرور کیسے کام کرتا ہے؟

درخواست کے راستے (request path) میں پانچ ہاپس (hops) ہوتے ہیں۔ ڈیزائن کا مقصد یہ ہے کہ MCP سرور بھیجنے کی کوئی نئی طاقت شامل نہیں کرتا؛ بلکہ یہ آپ کے پاس موجود API کو اسی ٹوکن اور انہی کنٹرولز کے تحت ظاہر کرتا ہے۔

1. 1مثال کے طور پر، ایک صارف AI ہوسٹ سے پوچھتا ہے: "WhatsApp پر اس کسٹمر کو ڈیلیوری اپ ڈیٹ بھیج دیں"۔
2. 2ماڈل MCP کلائنٹ کے ذریعے حاصل کردہ فہرست میں سے ایک ٹول کا انتخاب کرتا ہے، جیسے کہ WhatsApp سینڈ ٹول، اور اس کے آرگومنٹ (arguments) مکمل کرتا ہے۔
3. 3MCP کلائنٹ Bearer ٹوکن کے ساتھ https://mcp.broadnet.me/mcp کو HTTP POST کے طور پر tools/call کی درخواست بھیجتا ہے۔
4. 4BroadNet MCP سرور ٹوکن کی تصدیق کرتا ہے اور متعلقہ BroadNet API اینڈ پوائنٹ کو کال کرتا ہے۔
5. 5API میسج کو 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: کون سا ٹرانسپورٹ استعمال کریں؟

اسپیسیفیکیشن دو معیاری ٹرانسپورٹس کی وضاحت کرتی ہے۔ آپ کون سا استعمال کریں گے اس کا انحصار اس بات پر ہے کہ سرور کہاں چل رہا ہے، اور یہی فیصلہ کرتا ہے کہ آپ تصدیق (authenticate) کیسے کریں گے۔

HTTP سرورز کے لیے، سپیسیفیکیشن کے 2025-06-18 کے ریویژن میں سرورز کے لیے Origin ہیڈر کی تصدیق کرنا بھی ضروری ہے اور یہ سفارش کی جاتی ہے کہ وہ ہر کنکشن کو مستند (authenticate) کریں۔ تازہ ترین ریویژن (2026-07-28) ہر درخواست کو خود مختار بناتا ہے، جو اپنے میٹا ڈیٹا میں پروٹوکول ورژن اور کلائنٹ کی صلاحیتوں کو شامل رکھتا ہے؛ پچھلے ریویژنز میں ایک انیشلائز ہینڈ شیک (initialize handshake) کے ذریعے سیشن کھولا جاتا تھا، اور کلائنٹس یہ پہچان لیتے ہیں کہ سرور کون سا ریویژن استعمال کر رہا ہے اور اسی کے مطابق کام کرتے ہیں۔

آپ BroadNet کے MCP سرور کو AI ایجنٹ کے ساتھ کیسے منسلک کرتے ہیں؟

1. 1اپنے BroadNet اکاؤنٹ سے ایک ٹوکن حاصل کریں۔ BroadAdmin پورٹل میں، Integrations، پھر MCP Integration، ایک عارضی کی (key) جاری کرتا ہے؛ مستقل کی (key) آپ کے اکاؤنٹ ایڈمن یا ماسٹر اکاؤنٹ سے حاصل ہوتی ہے۔
2. 2سرور کو اپنے MCP کلائنٹ میں شامل کریں۔ زیادہ تر کلائنٹس JSON کنفیگریشن استعمال کرتے ہیں جیسا کہ نیچے دی گئی ہے ۔ فیلڈ کے نام مختلف کلائنٹس کے درمیان تھوڑے مختلف ہو سکتے ہیں، اس لیے اپنے کلائنٹ کی دستاویزات (documentation) چیک کریں۔
3. 3ٹوکن کو ان فائلوں میں نہ رکھیں جنہیں آپ کمٹ (commit) کرتے ہیں۔ اپنے کلائنٹ کی انوائرمنٹ ویری ایبل (environment-variable) سپورٹ استعمال کریں، جیسا کہ نیچے دی گئی کنفیگریشن میں کیا گیا ہے۔
4. 4ٹول لسٹ کھولیں اور ہر اس ٹول کو بند کر دیں جس کی ایجنٹ کو ضرورت نہیں ہے۔
5. 5ایجنٹ کو کسٹمر ڈیٹا کے قریب کرنے سے پہلے، اپنے کسی نمبر پر ایک میسج بھیج کر ٹیسٹ کریں۔

1{
2  "mcpServers": {
3    "broadnet": {
4      "type": "http",
5      "url": "https://mcp.broadnet.me/mcp",
6      "headers": {
7        "Authorization": "Bearer ${BROADNET_TOKEN}"
8      }
9    }
10  }
11}

کلائنٹ کے بغیر کنکشن کو ٹیسٹ کرنے کے لیے، خود انیشلائز (initialize) کی درخواست بھیجیں:

1curl -X POST https://mcp.broadnet.me/mcp \
2  -H "Authorization: Bearer $BROADNET_TOKEN" \
3  -H "Content-Type: application/json" \
4  -H "Accept: application/json, text/event-stream" \
5  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
6       "params":{"protocolVersion":"2025-06-18","capabilities":{},
7                 "clientInfo":{"name":"curl","version":"1.0"}}}'

ہیڈر کے بغیر، سرور پروٹوکول کی سطح پر کال مسترد کر دیتا ہے۔ غیر تصدیق شدہ انیشلائز کی درخواست پر یہ اس کا اصل جواب ہے، جسے 26 ستمبر 2026 کو چیک کیا گیا ہے:

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

کیا کسی AI ایجنٹ کو میسجنگ API کی (key) دینا محفوظ ہے؟

صرف مخصوص حدود کے ساتھ۔ یہ ٹوکن ایک بھیجنے کی سند (credential) ہے: اس پر قابض کوئی بھی شخص، یا کوئی بھی ایجنٹ، آپ کے اکاؤنٹ سے پیغامات بھیج سکتا ہے، اور ہر پیغام بھیجنے پر رقم خرچ ہوتی ہے اور وہ ایک حقیقی شخص تک پہنچتا ہے۔ ایجنٹس قدرتی زبان کی ہدایات پر بھی عمل کرتے ہیں، اور اس متن کا کچھ حصہ باہر سے آتا ہے: ایک آنے والا کسٹمر میسج یا ویب پیج ایسی ہدایات پر مشتمل ہو سکتا ہے جن پر ماڈل عمل کرنے کی کوشش کر سکتا ہے۔ MCP کی تفصیلات اس بارے میں بالکل واضح ہیں۔ یہ کہتی ہے کہ ہوسٹس کے لیے کسی بھی ٹول کو استعمال کرنے سے پہلے صارف کی واضح رضامندی حاصل کرنا لازمی ہے، اور ہمیشہ ایک انسان کا عمل میں شامل ہونا (human in the loop) چاہیے جس کے پاس ٹول کے استعمال کو مسترد کرنے کی صلاحیت ہو، اور کلائنٹس کے لیے ٹول کی وضاحتوں (annotations) کو غیر قابل اعتماد سمجھنا لازمی ہے جب تک کہ وہ کسی قابل اعتماد سرور سے نہ آئیں۔

کون سے گارڈ ریلز (guardrails) ایک ایجنٹ کو صارفین کو اسپیم کرنے سے روکتے ہیں؟

کنٹرولز کو وہاں رکھیں جہاں ماڈل انہیں نظر انداز نہ کر سکے: کلائنٹ کنفیگریشن میں، اپنے مڈل ویئر (middleware) میں، یا اکاؤنٹ سیٹنگز میں، پرامپٹ (prompt) میں نہیں۔

BroadNet API میں کوئی idempotency ہیڈر نہیں ہے، اس لیے ٹائم آؤٹ کے بعد دوبارہ کوشش کرنے سے میسج دو بار بھیجا جا سکتا ہے۔ محفوظ طریقہ یہ ہے کہ API سے ملنے والی میسج ID کو محفوظ کیا جائے اور دوبارہ بھیجنے سے پہلے ڈیلیوری اسٹیٹس چیک کیا جائے؛ ہماری idempotency اور retries گائیڈز بتاتی ہیں کہ یہ کیسے کیا جائے۔

میسجنگ کے کن ایکشنز کے لیے انسانی منظوری کی ضرورت ہونی چاہیے؟

MCP یا ایک سادہ REST API: ایجنٹ کو کس کا استعمال کرنا چاہیے؟

دونوں ایک ہی پلیٹ فارم تک پہنچتے ہیں۔ فرق یہ ہے کہ کون فیصلہ کرتا ہے کہ کون سی کال کرنی ہے۔

ایک مناسب تقسیم: 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 سرور کو ایک لوکل سب پروسیس کے طور پر چلاتا ہے اور اسٹینڈرڈ ان پٹ اور آؤٹ پٹ کے ذریعے newline-delimited JSON-RPC کا تبادلہ کرتا ہے۔ Streamable HTTP سرور کو ایک ویب سروس کے طور پر چلاتا ہے جہاں ہر کلائنٹ میسج ایک اینڈ پوائنٹ پر HTTP POST ہوتا ہے۔

میں AI ایجنٹ کو صارفین کو اسپیم کرنے سے کیسے روک سکتا ہوں؟

ماڈل سے باہر رضامندی کی جانچ، خاموش اوقات (quiet hours) اور سینڈ کیپس (send caps) کو نافذ کریں، صرف وہی ٹولز فعال کریں جن کی آپ کو ضرورت ہے، مارکیٹنگ اور کثیر صارفین کو بھیجے جانے والے میسجز کے لیے انسانی منظوری لازمی کریں، اور ہر ٹول کال کا لاگ رکھیں۔

کیا مجھے MCP استعمال کرنا چاہیے یا REST API؟

MCP کا استعمال تب کریں جب کوئی شخص قدرتی زبان میں ایجنٹ کی رہنمائی کر رہا ہو۔ REST API یا TypeScript SDK کا استعمال طے شدہ پروڈکشن فلو (production flows) کے لیے کریں جیسے کہ OTP اور الرٹس، جہاں آپ کا کوڈ، نہ کہ کوئی ماڈل، یہ فیصلہ کرتا ہے کہ کیا بھیجنا ہے۔

ذرائع

• Model Context Protocol، Specification overview (revision 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 server documentation، اور 26 ستمبر 2026 کو https://mcp.broadnet.me/mcp کا ایک لائیو پروب۔

مزید پڑھیں: AI agents in customer messaging اور choosing an enterprise agentic AI platform۔