اربط وكلاء الذكاء الاصطناعي بـ BroadNet عبر MCP.

ما هو خادم MCP

بروتوكول Model Context Protocol (MCP) معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي اكتشاف أدوات خارجية واستدعاءها. خادم MCP من BroadNet خادم بعيد: يتصل به عميلك عبر HTTPS، ويعرض الأدوات المتاحة، ثم يستدعيها نيابةً عنك.

تقابل هذه الأدوات واجهة BroadNet البرمجية نفسها الموثّقة في مرجع الواجهة وفي مواصفة OpenAPI — إرسال الرسائل، والعمل مع قوالب WhatsApp، وقراءة إيصالات التسليم. يعمل الوكيل بصلاحيات الرمز الذي تمنحه إياه، تمامًا كما تعمل شيفرتك.

خادما MCP: المعرفة والمراسلة

تشغّل BroadNet خادمَي MCP. خادم المراسلة الموصوف في هذه الصفحة يعمل على حسابك. أما خادم المعرفة فهو عام: يمكن للوكيل أن يسأله عن تغطية BroadNet وقواعد معرّف المُرسِل وأسعار القائمة المنشورة واللوائح وحقائق الشركة دون تسجيل دخول.

جرّب خادم المعرفة من الطرفية: مصافحة initialize ثم استدعاء أداة.

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. يجب أن يحمل كل طلب رمز BroadNet الخاص بك في ترويسة Authorization.

تحصل على الرمز من حسابك في BroadNet. في العرض التوضيحي يُنشأ الرمز في بوابة BroadAdmin ضمن Integrations → MCP Integration عبر «Get temporary key»؛ وتوضح البوابة أن المفتاح الدائم يصدره مسؤول حسابك أو الحساب الرئيسي.

يُرفض أي طلب بلا هذه الترويسة على مستوى البروتوكول — هذا هو الرد الفعلي للخادم على طلب initialize دون مصادقة:

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 إعدادًا بصيغة JSON يتضمن عنوان الخادم وترويسات الطلب. يبدو الإدخال المعتاد هكذا:

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

لاختبار الاتصال دون عميل، أرسل طلب MCP 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"}}}'

ما يعرضه الفيديو التوضيحي

يستعرض تسجيل فريق المنتج المسار كاملًا في خمس خطوات، باستخدام Cursor عميلًا لـ MCP:

1. 1
   تسجيل الدخول

   سجّل الدخول إلى بوابة BroadAdmin بحسابك في BroadNet.

2. 2
   الحصول على مفتاح وعلى الإعداد

   افتح Integrations → MCP Integration، وأنشئ مفتاحًا مؤقتًا، وانسخ إعداد العميل الجاهز.

3. 3
   إضافة الخادم إلى العميل

   في عميل MCP، أضف خادم MCP جديدًا والصق الإعداد في mcp.json — العنوان https://mcp.broadnet.me/mcp مع ترويسة Bearer.

4. 4
   مراجعة الأدوات

   يتصل العميل ويعرض أدوات BroadNet، ويمكن تفعيل كل أداة أو تعطيلها.

5. 5
   الطلب بلغة طبيعية

   يطلب المستخدم من الوكيل إرسال رسالة WhatsApp إلى رقم. يختار الوكيل أداة إرسال WhatsApp، فتردّ الواجهة بـ 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 واحدة، وخطوات النسخ واللصق نفسها لكل وكيل.

ملاحظات الأمان

• الرمز بيانات اعتماد للإرسال

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

• فضّل المفاتيح المؤقتة للتجارب

  استخدم مفتاحًا مؤقتًا أثناء التجربة، واطلب من مسؤول حسابك مفتاحًا دائمًا لوكيل الإنتاج فقط.

• فعّل الأدوات التي تحتاجها فقط

  تتيح عملاء MCP تعطيل أدوات بعينها. الوكيل الذي يرسل SMS فقط لا يحتاج أدوات القوالب أو الإعداد أو الحساب.

• أبقِ إنسانًا في الحلقة

  ينفّذ الوكلاء تعليمات بلغة طبيعية. اجعل العميل يطلب التأكيد قبل الأدوات التي ترسل رسائل، خصوصًا إلى عدد كبير من المستلمين.

• ألغِ الرمز المسرَّب

  إذا انكشف الرمز، تواصل مع مسؤول حسابك أو مع دعم BroadNet لإلغائه وإصدار رمز جديد.

روابط ذات صلة

أسئلة