BroadNet
المجلةهندسة
هندسة

MCP للمراسلة: كيف يمكن لوكلاء الذكاء الاصطناعي إرسال SMS و WhatsApp بأمان

يحول خادم MCP واجهة برمجة تطبيقات المراسلة إلى أدوات يمكن لوكيل ذكاء اصطناعي استدعاؤها. هذا الأمر قوي ومحفوف بالمخاطر؛ فالوكيل المزود بأداة إرسال يمكنه مراسلة العملاء الحقيقيين. إليك كيفية عمل MCP لخدمات SMS و WhatsApp، وكيفية الاتصال بخادم BroadNet، والضوابط التي يجب وضعها أولاً.

BroadNet Engineering
11 دقائق قراءة
هندسة · العدد 47
11 دقائق قراءة

قوم خادم MCP للمراسلة بالكشف عن API مراسلة كأدوات يمكن لوكيل ذكاء اصطناعي اكتشافها واستدعاؤها من خلال Model Context Protocol، بحيث يمكن للمساعد إرسال رسالة SMS أو رسالة WhatsApp بناءً على الطلب. يعمل BroadNet عند https://mcp.broadnet.me/mcp، باستخدام وسيلة نقل Streamable HTTP ورمز وصول (token) Bearer، عبر نفس API التي تخدم WhatsApp، وSMS، وRCS، وTelegram، وPush، وEmail، وMessenger وInstagram. يشرح هذا الدليل كيفية عمل ذلك، والأهم من ذلك، كيفية منع الوكيل من مراسلة الأشخاص الخطأ.

النقاط الرئيسية المستخلصة

  • إن MCP هو بروتوكول مفتوح، مبني على JSON-RPC 2.0، يتيح لتطبيقات الذكاء الاصطناعي اكتشاف الأدوات الخارجية واستدعاءها. يقوم خادم MCP مراسلة بتحويل نقاط نهاية الإرسال والقوالب والتقارير إلى أدوات.
  • تستخدم الخوادم البعيدة وسيلة نقل Streamable HTTP: نقطة نهاية HTTPS واحدة، وكل رسالة عميل هي طلب HTTP POST. عادة ما تستخدم الخوادم المحلية stdio.
  • خادم BroadNet MCP موجود في https://mcp.broadnet.me/mcp ويرفض أي طلب بدون ترويسة Authorization: Bearer.
  • رمز الوصول (token) هو اعتماد إرسال. يعمل الوكيل بصلاحياته، تماماً كما سيفعل الكود الخاص بك.
  • تنص مواصفات MCP على أنه SHOULD (ينبغي) أن يكون هناك دائماً عنصر بشري في الحلقة يمكنه رفض استدعاءات الأدوات، ويجب (MUST) على الخوادم تقييد معدل استدعاءات الأدوات. قم ببناء الموافقة، وساعات عدم الإزعاج، والحدود القصوى، والموافقات حول كل أداة إرسال.

ما هو Model Context Protocol؟

تصف مواصفات MCP الـ MCP بأنها "بروتوكول مفتوح يتيح التكامل السلس بين تطبيقات نماذج اللغات الكبيرة (LLM) ومصادر البيانات والأدوات الخارجية". وهي تستخدم رسائل JSON-RPC 2.0 بين ثلاثة أدوار: المضيفون (تطبيق الذكاء الاصطناعي)، والعملاء (الموصلات داخل المضيف)، والخوادم (الخدمات التي توفر الأدوات والموارد والمطالبات). اعتباراً من 26 سبتمبر 2026، فإن أحدث مراجعة للمواصفات مؤرخة في 2026-07-28.

الأدوات هي الجزء المهم بالنسبة للمراسلة. يقوم العميل بإدراجها باستخدام tools/list، ويختار النموذج أحدها، ويقوم العميل باستدعائها باستخدام tools/call. تصف المواصفات الأدوات بأنها "يتحكم فيها النموذج": حيث يقرر النموذج متى يستخدمها. وهذا هو السبب بالضبط في أن أداة الإرسال تحتاج إلى ضوابط لا يمكن للنموذج تجاوزها بالحديث.

كيف يعمل خادم MCP لـ SMS وWhatsApp؟

يتكون مسار الطلب من خمس قفزات. النقطة التصميمية هي أن خادم MCP لا يضيف أي قوة إرسال جديدة؛ بل يكشف عن API التي تمتلكها بالفعل، تحت نفس رمز الوصول ونفس الضوابط.

  1. يسأل المستخدم المضيف الذي يعمل بالذكاء الاصطناعي، على سبيل المثال: "أرسل تحديث التسليم إلى هذا العميل على WhatsApp".
  2. يختار النموذج أداة من القائمة التي استردها عميل MCP، مثل أداة إرسال WhatsApp، ويقوم بتعبئة وسيطاتها.
  3. يرسل عميل MCP طلب tools/call كطلب POST HTTP إلى https://mcp.broadnet.me/mcp مع رمز الوصول (token) Bearer.
  4. يقوم خادم MCP BroadNet بالتحقق من صحة رمز الوصول (token) ويستدعي نقطة نهاية BroadNet API المقابلة.
  5. يقوم 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: أي وسيلة نقل؟

تحدد المواصفات وسيلتي نقل قياسيتين. تعتمد الوسيلة التي تستخدمها على مكان تشغيل الخادم، وهي التي تحدد كيفية قيامك بالمصادقة.

stdioStreamable HTTP
أين يعمل الخادمكعملية فرعية يتم إطلاقها بواسطة العميل، على نفس الجهازبصفتها خدمة مستقلة وصلت إلى أكثر من HTTPS
كيفية انتقال الرسائلJSON-RPC مفصولة بأسطر عبر المدخلات والمخرجات القياسيةكل رسالة عميل هي طلب HTTP POST إلى نقطة نهاية MCP واحدة؛ وتعود الردود كـ JSON أو كتدفق أحداث مرسلة من الخادم (server-sent-events)
كيفية عمل بيانات الاعتمادتنص المواصفات على أنه يجب على خوادم stdio قراءة بيانات الاعتماد من البيئةرأس Authorization: Bearer في كل طلب؛ يجب ألا توضع رموز الوصول (tokens) مطلقًا في سلسلة الاستعلام
الاستخدام النموذجيأدوات المطورين المحليةخدمات مستضافة مشتركة بين العديد من العملاء، مثل API مراسلة
BroadNetغير متوفرhttps://mcp.broadnet.me/mcp

بالنسبة لخوادم HTTP، تتطلب مراجعة المواصفات بتاريخ 2025-06-18 أيضًا من الخوادم التحقق من ترويسة Origin وتوصي بأن تقوم بالمصادقة على كل اتصال. وتجعل المراجعة الأخيرة (2026-07-28) كل طلب مكتفياً ذاتياً، حيث يحمل إصدار البروتوكول وقدرات العميل في بياناته الوصفية الخاصة؛ بينما كانت المراجعات السابقة تفتح جلسة عبر مصافحة تهيئة، ويقوم العملاء باكتشاف الإصدار الذي يتحدث به الخادم والرجوع إلى الإصدار السابق.

كيف يمكنك ربط وكيل ذكاء اصطناعي بخادم MCP الخاص بـ BroadNet؟

  1. احصل على رمز الوصول (token) من حساب BroadNet الخاص بك. في بوابة BroadAdmin، انتقل إلى التكاملات (Integrations)، ثم MCP التكامل (Integration)، حيث يتم إصدار مفتاح مؤقت؛ أما المفتاح الدائم فيتم الحصول عليه من مسؤول حسابك أو الحساب الرئيسي.
  2. أضف الخادم إلى عميل MCP الخاص بك. تتطلب معظم العملاء تهيئة JSON مثل تلك الموضحة أدناه. تختلف أسماء الحقول قليلاً بين العملاء، لذا تحقق من وثائق العميل الخاص بك.
  3. حافظ على رمز الوصول (token) خارج الملفات التي تودعها في المستودع (commit). استخدم دعم متغيرات البيئة الخاص بالعميل، كما هو موضح في الإعدادات أدناه.
  4. افتح قائمة الأدوات وأوقف تشغيل كل أداة لا يحتاجها الوكيل.
  5. اختبر باستخدام رسالة واحدة إلى رقم تملكه قبل أن تسمح للوكيل بالاقتراب من بيانات العملاء.
snippet
{
"mcpServers": {
"broadnet": {
"type": "http",
"url": "https://mcp.broadnet.me/mcp",
"headers": {
"Authorization": "Bearer ${BROADNET_TOKEN}"
}
}
}
}

لاختبار الاتصال بدون عميل، أرسل طلب التهيئة بنفسك:

snippet
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:

snippet
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."}}

هل من الآمن منح وكيل ذكاء اصطناعي (AI agent) مفتاح API للمراسلة؟

فقط مع وجود قيود حوله. الـ token هو اعتماد إرسال: أي شخص، أو أي وكيل، يحمله يمكنه إرسال رسائل من حسابك، وكل عملية إرسال تكلف مالاً وتصل إلى شخص حقيقي. كما تعمل الوكلاء بناءً على تعليمات باللغة الطبيعية، ويأتي جزء من هذا النص من الخارج: فقد تحتوي رسالة عميل واردة أو صفحة ويب على تعليمات قد يحاول النموذج اتباعها. مواصفة MCP صريحة بشأن هذا الأمر. فهي تنص على أنه يجب على المضيفين الحصول على موافقة صريحة من المستخدم قبل استدعاء أي أداة، وأنه ينبغي (SHOULD) أن يكون هناك دائماً عنصر بشري في الحلقة مع القدرة على رفض استدعاءات الأدوات، ويجب على العملاء التعامل مع توضيحات الأدوات على أنها غير موثوقة ما لم تكن قادمة من خادم موثوق.

ما هي الضوابط التي تمنع الوكيل من إرسال رسائل مزعجة للعملاء؟

ضع الضوابط في مكان لا يمكن للنموذج تجاوزه: في إعدادات العميل، أو في البرمجيات الوسيطة الخاصة بك، أو في إعدادات الحساب، وليس في المطالبة.

المخاطرةالضابطمكان وجوده
مراسلة شخص لم يقم بالموافقة المسبقة على تلقي الرسائلالتحقق من حالة الموافقة وإلغاء الاشتراك قبل تشغيل أي أداة إرسالالبرمجيات الوسيطة الخاصة بك أو نظام إدارة علاقات العملاء (CRM)
الإرسال في الليل أو في اليوم غير المناسبساعات عدم الإزعاج حسب المنطقة الزمنية للمستلم وقواعد السوقالبرمجيات الوسيطة الخاصة بك
استخدام أدوات لا تحتاجها المهمةتفعيل الأدوات المطلوبة فقط؛ تعطيل أدوات القالب، والإعداد الأولي (onboarding)، والحسابإعدادات أداة العميل MCP
الحلقات التكرارية غير المنضبطة والإرسال الجماعيحدود الإرسال لكل وكيل وحدود المعدل؛ تتطلب المواصفات من الخوادم وضع حد لمعدل استدعاءات الأدواتالبرمجيات الوسيطة الخاصة بك والخادم
رسائل مكررة بعد إعادة المحاولةالاحتفاظ بمعرّف الرسالة الذي تُرجعه API والتحقق من حالته قبل إعادة الإرسالمنطق الوكيل الخاص بك (راجع دليل منع الإرسال المكرر (idempotency))
إرسال رسائل تسويقية دون مراجعةالموافقة البشرية لأي إرسال تسويقي أو إرسال متعدد المستلمينمطالبات تأكيد العميل MCP
التعليمات المخفية في الرسائل الواردةعامل النصوص الواردة كبيانات؛ لا تسمح أبدًا بأن تؤدي إلى إرسال دون طلب من المستخدمتصميم المطالبة وقواعد الموافقة في مستضيف الذكاء الاصطناعي
رمز الوصول (token) مسربمفاتيح مؤقتة للتجارب، متغيرات البيئة، الإلغاء وإعادة الإصدار عند التعرض للاختراقمسؤول حساب BroadNet
لا يوجد سجل تدقيقسجل كل استدعاء للأداة مع الوسيطات والنتائجعميل MCP؛ تنص المواصفات على أنه ينبغي للعملاء تسجيل استخدام الأدوات

لا يحتوي BroadNet API على ترويسة تكرار العمليات (idempotency)، لذا فإن إعادة المحاولة بعد انتهاء المهلة قد تؤدي إلى الإرسال مرتين. النمط الآمن هو تخزين معرف الرسالة الذي ترجعه API والتحقق من حالة التسليم قبل إعادة الإرسال؛ توضح أدلة تكرار العمليات وإعادة المحاولة الخاصة بنا كيفية القيام بذلك.

أي إجراءات المراسلة يجب أن تتطلب موافقة بشرية؟

الإجراءالافتراضي المقترحلماذا
قراءة إيصالات التسليم، قائمة القوالبتلقائيللقراءة فقط؛ لا شيء يصل إلى العميل
رسالة معاملة واحدة إلى عميل واحد معروف طلبهاتلقائي ضمن سقف الإرسال، أو تأكيد بنقرة واحدةمخاطر منخفضة، قيمة عالية، سهولة التدقيق
أي رسالة تسويقيةموافقة بشرية دائمًامخاطر الموافقة والمحتوى والتكلفة
أي إرسال إلى أكثر من مستلم واحدموافقة بشرية دائمًاالخطأ يتضاعف
إنشاء أو تقديم قوالب WhatsAppالموافقة البشريةيتم مراجعة القوالب بواسطة Meta وهي تمثل علامتك التجارية
أدوات الحساب أو الفوترة أو الإعداد الأولي (onboarding)معطللا ينبغي للوكيل أن يغير الحساب الذي يعمل عليه

MCP أو REST API بسيط: أيهما ينبغي للوكيل استخدامه؟

كلاهما يصل إلى نفس المنصة. الفرق هو من يقرر أي استدعاء يتم إجراؤه.

خادم BroadNet MCPBroadNet REST API
من يختار الاستدعاءالنموذج، من قائمة الأدواتالرمز الخاص بك
نقطة النهايةhttps://mcp.broadnet.me/mcphttps://api.broadnet.me، على سبيل المثال POST /sms/sendSms
المصادقةAuthorization: Bearer <token>Authorization: Bearer <token>
مكتبة العميلأي عميل MCP يدعم الخوادم البعيدة وترويسة Authorization مخصصةSDK رسمي واحد، @broadnet/cpaas-sdk (TypeScript/Node.js)؛ قم بتوليد عملاء آخرين من مواصفات OpenAPI
الأفضل لـالمساعدون، ومساعدو العمليات، والمهام المخصصة بلغة طبيعيةتدفقات الإنتاج ذات المنطق الثابت: OTP، والتنبيهات، والحملات

تقسيم منطقي: استخدم MCP عندما يقوم شخص بتوجيه وكيل الذكاء الاصطناعي ويكون طلب التأكيد مقبولاً، واستخدم REST API، مع الدليل السريع ومولد curl، للتدفقات التي يجب أن تعمل بنفس الطريقة في كل مرة. توثق مرجع API الخاص بنا نقاط النهاية وراء أدوات MCP.

الأسئلة الشائعة

ما هو خادم MCP للرسائل؟

خادم يكشف عن API للرسائل، مثل إرسال SMS، أو إرسال رسالة WhatsApp، أو الحصول على إيصال التسليم، كأدوات يمكن لوكيل ذكاء اصطناعي اكتشافها واستدعاؤها من خلال Model Context Protocol.

ما هو رابط URL لخادم BroadNet MCP؟

https://mcp.broadnet.me/mcp. يستخدم وسيلة نقل MCP Streamable HTTP ويتطلب ترويسة Authorization: Bearer مع رمز الوصول (token) الخاص بك BroadNet في كل طلب.

أي عملاء الذكاء الاصطناعي يمكنهم الاتصال به؟

أي عميل MCP يمكنه الاتصال بخادم بعيد عبر Streamable HTTP وإرسال ترويسة Authorization مخصصة. يستخدم تسجيل العرض التوضيحي BroadNet تقنية Cursor.

هل يمكن للوكيل إرسال رسائل حقيقية؟

نعم. تعمل الأدوات بصلاحيات رمز الوصول (token) الخاص بك، تماماً كما ستفعل استدعاءات API الخاصة بك. تعامل مع كل عملية إرسال على أنها حقيقية: قم بتمكين الأدوات التي يحتاجها الوكيل فقط واطلب التأكيد قبل عمليات الإرسال.

كيف تعمل مصادقة Bearer مع MCP؟

بالنسبة لـ HTTP، يرسل العميل Authorization: Bearer متبوعاً برمز الوصول (token) في كل طلب، حتى ضمن نفس الجلسة، ولا يتم إرساله أبداً في سلسلة استعلام عنوان URL. يرفض خادم BroadNet الطلبات التي لا تحتوي عليه.

ما الفرق بين stdio و Streamable HTTP؟

يقوم stdio بتشغيل الخادم كعملية فرعية محلية ويتبادل JSON-RPC المفصولة بأسطر جديدة عبر المدخلات والمخرجات القياسية. بينما يقوم Streamable HTTP بتشغيل الخادم كخدمة ويب حيث تكون كل رسالة عميل عبارة عن طلب POST من نوع HTTP إلى نقطة نهاية واحدة.

كيف يمكنني منع وكيل ذكاء اصطناعي من إرسال رسائل مزعجة للعملاء؟

قم بفرض فحوصات الموافقة المسبقة على تلقي الرسائل، وساعات عدم الإزعاج، وحدود الإرسال خارج النموذج، وقم بتمكين الأدوات التي تحتاجها فقط، وتطلب موافقة بشرية للرسائل التسويقية والإرسال لمتعددي المستلمين، وقم بتسجيل كل استدعاء للأداة.

هل يجب أن أستخدم MCP أم REST API؟

استخدم MCP عندما يوجه شخص ما وكيلاً بلغة طبيعية. استخدم REST API أو TypeScript SDK لتدفقات الإنتاج الثابتة مثل OTP والتنبيهات، حيث يقرر الكود الخاص بك، وليس النموذج، ما يجب إرساله.

المصادر

قراءات ذات صلة: وكلاء الذكاء الاصطناعي في رسائل خدمة العملاء واختيار منصة ذكاء اصطناعي وكيلية للمؤسسات.

هل كان هذا مفيداً؟

كيف نكتب المحتوى ونراجعه

بقلم

BroadNet Engineering

يُشغّل قسم الهندسة الشبكة: روابط SMPP، ومجموعات SS7، ومحركات التوجيه، والبنية التحتية الأساسية التي تجعل معالجة مليار رسالة شهريًا أمرًا ممكنًا. يكتبون هنا عندما يكون هناك ما يستحق التدوين.

تابع القراءة

ثلاثة أخرى من المجلة.

اطلع على جميع المقالات
و
منتج

وكلاء الذكاء الاصطناعي في مراسلة العملاء: دليل 2026 لمنصة الاتصالات السحابية القائمة على الوكلاء.

تنقل منصة CPaaS القائمة على الوكلاء المراسلة من روبوتات الدردشة ذات السيناريوهات المُعدّة مسبقًا إلى وكلاء الذكاء الاصطناعي الذين يفهمون السياق ويتخذون القرارات ويتصرفون عبر أنظمتك من خلال رسائل SMS وWhatsApp وRCS.

فريق التحرير في BroadNet
11m
خ
منتج

خدمة RCS الآلية: ربط خدمة RCS للمراسلة التجارية بوكلاء الذكاء الاصطناعي.

يقوم نظام Agentic RCS بربط خدمة RCS Business Messaging - المرسل الموثق، والبطاقات الغنية، والإجراءات المقترحة - مع وكلاء الذكاء الاصطناعي الذين يفسرون النية، ويتصلون بأنظمتك، ويتصرفون.

فريق التحرير في BroadNet
10m
ك
هندسة

كيفية إرسال SMS عبر الكود: Python، PHP، Node.js، Java، Go و C# باستخدام استدعاء REST واحد

يعد إرسال SMS عبر الكود عبارة عن طلب HTTPS POST موثق واحد: يتضمن رمز Bearer، وجسم طلب JSON يحتوي على معرّف المُرسِل، ورقم الوجهة، والرسالة، ونوع الرسالة، بالإضافة إلى معرف الرسالة في الرد. إليك نفس الطلب بلغات Python، PHP، Node.js، Java، Go و C#، بالإضافة إلى معالجة الأخطاء ونصائح للإنتاج.

فريق التحرير في BroadNet
9m
المجلة، عبر البريد الإلكتروني

مقال واحد شهرياً. لا شيء آخر.

اشترك وسنرسل لك المقال التالي - سواءً كان هندسيًا أو تنظيميًا أو صناعيًا - في يوم شحنه. لا حملات تسويقية عشوائية، ولا عروض منتجات، ولا مشاركة مع جهات خارجية. يمكنك إلغاء الاشتراك بنقرة واحدة.

نرسل رسالة واحدة شهريًا. يمكنك إلغاء الاشتراك في أي وقت. اطّلع على سياسة الخصوصية.

ما ستحصل عليه
  • مقال مطوّل، وليس مجرد رابط لجذب الانتباه.
    من ست إلى إحدى عشرة دقيقة من الكتابة المركزة حول موضوع واحد.
  • كتبه مشغّلون
    مهندسون، ومسؤولون عن الشؤون التنظيمية، وكتابة المنتجات داخل الشركة.
  • مدرك للمنطقة
    نظرة متعمقة من منطقة الشرق الأوسط وشمال أفريقيا حول الجهات التنظيمية والمشغّلين ومزيج القنوات.
  • مرة واحدة في الشهر
    لا حملة ترويجية بالتنقيط. مقال واحد فقط عندما يكون هناك مقال واحد للمشاركة.
توقف عن القراءة. ابدأ الشحن.

معظم ما نكتبه تعلمناه أثناء الإنتاج.

إذا لاقت هذه المعلومات استحسانك، فلنتحدث. أخبرنا عن حالة الاستخدام، والأحجام، والأسواق - وسنعود إليك بمعلومات عن التوجيه والتسعير، وعميل مرجعي يمكنك الاتصال به.

$ curl -X POST https://api.broadnet.me/sms/sendSms