باختصار
يتصل Claude Code بمنصة OmniChannels.ai بأمر واحد: claude mcp add --transport http موجّهًا إلى https://mcp.broadnet.me/mcp مع ترويسة Authorization: Bearer. بعدها يستطيع إرسال رسائل تجريبية، وعرض قوالب واتساب، والاطلاع على تقارير التسليم، بينما يكتب شيفرة التكامل اعتمادًا على مواصفات OpenAPI 3.1 لدينا. ويتشارك الفريق الخادم عبر الملف .mcp.json، وتحدد قواعد الأذونات الأدوات التي تعمل دون طلب تأكيد.
ما الذي يمكنك فعله
كتابة الشيفرة من القوالب الفعلية
يقرأ Claude Code قوالب واتساب المعتمدة لديك عبر MCP، ويكتب دالة تتضمن المتغيرات التي يحتاجها كل قالب بالضبط.
جرّب أن تطلب
“استخدم أدوات omnichannels لعرض قوالب واتساب المعتمدة لديّ، ثم اكتب دالة TypeScript ترسل القالب order_update بالحقول التي يحتاجها.”
بناء معالج Webhooks
وجّه Claude Code إلى دليل Webhooks، فيكتب نقطة استقبال تحفظ حالات التسليم والرسائل الواردة، وتتعامل مع الحقول التي تختلف من قناة لأخرى.
جرّب أن تطلب
“اكتب معالج Webhook باستخدام Express يسجّل الحالات SUBMITTED وSENT وDELIVERED وREAD وFAILED وREJECTED حسب معرّف الرسالة، ويسجّل الحقول غير المعروفة في السجل بدلًا من أن يفشل.”
توليد عميل برمجي من المواصفات
عندما تكون مواصفات OpenAPI محفوظة في مستودعك، يستخدم Claude Code المسارات والحقول الصحيحة بدلًا من تخمينها.
جرّب أن تطلب
“اعتمادًا على docs/omnichannels-openapi.yaml، اكتب وحدة Python ترسل رسالة SMS عبر POST /sms/sendSms، واذكر كل حقل استخدمته مع نوعه كما ورد في المواصفات.”
اختبار شامل على رقمك
يرسل Claude Code رسالة تجريبية بعد موافقتك على استدعاء الأداة، ثم يتحقق من تقرير التسليم ليؤكد أن مسار شيفرتك يعمل.
جرّب أن تطلب
“أرسل رسالة SMS تجريبية من OmniDemo إلى رقمي 447700900123، ثم تحقق من تقرير تسليمها.”
تتبّع الرسائل الفاشلة
تتيح أدوات القراءة لـ Claude Code مقارنة تقارير التسليم بسجلاتك وتتبّع الفشل حتى الطلب الذي تسبب فيه.
جرّب أن تطلب
“اطّلع على تقرير تسليم حملة أمس، ولخّص أسباب الفشل، وراجع شيفرة إعادة المحاولة لدينا مقارنةً بدليل الأخطاء.”
كيف يتم الربط
يضيف Claude Code خوادم MCP البعيدة بالأمر claude mcp add --transport http مع ترويسة Authorization. وتعوّض الطرفية (Shell) قيمة الرمز من متغير البيئة عند تنفيذ الأمر. أما للفرق، فيتيح ملف .mcp.json على مستوى المشروع لكل مطوّر أن يزوّد رمز الوصول الخاص به عبر ${BROADNET_TOKEN}، ويطلب Claude Code من كل شخص الموافقة على الخادم قبل استخدامه.
يغطي MCP العمليات على حسابك: إرسال رسائل تجريبية، والاطلاع على القوالب وتقارير التسليم. أما لكتابة شيفرة التكامل، فزوّد Claude Code بمواصفات OpenAPI 3.1 لدينا مرجعًا معتمدًا لنقاط الاتصال والحقول، إضافة إلى دليل Webhooks، لأن حمولات Webhooks غير مذكورة في المواصفات. وتتيح قواعد أذونات مثل mcp__omnichannels__get_* تشغيل أدوات القراءة دون طلب تأكيد، بينما تظل أدوات الإرسال تطلبه.
- الأمر: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
- إعداد الفريق: ارفع .mcp.json بقيمة Bearer ${BROADNET_TOKEN}، ولا ترفع مفتاحًا أبدًا
- تُسمّى الأدوات في قواعد الأذونات بالصيغة mcp__omnichannels__<tool>
- مواصفات OpenAPI 3.1 على /developers/openapi.json لمعرفة حقول الطلب بدقة
- إرسال SMS الفردي بصيغة JSON، أما الإرسال الجماعي ومعظم القنوات الأخرى فبصيغة multipart/form-data
خطوات الإعداد
- 1
اطلب الوصول إلى API
اطلب وصولًا تجريبيًا واحصل على رمز وصول لواجهة API. تُرسل الرسائل التجريبية إلى أرقامك الموثّقة فقط.
- 2
احصل على مفتاح مؤقت
في بوابة الإدارة افتح Integrations ثم MCP Integration، واختر Get temporary key (الحصول على مفتاح مؤقت)، ثم صدّره في المتغير BROADNET_TOKEN.
الدليل: MCP server for AI agents - 3
أضف الخادم
نفّذ claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp مع ترويسة Authorization، أو ارفع ملف .mcp.json للمشروع ليستخدمه فريقك، ثم تحقق منه عبر /mcp.
الدليل: Use the MCP server with Claude Code - 4
اضبط قواعد الأذونات
اسمح بأدوات القراءة مثل mcp__omnichannels__get_* إن شئت، وأبقِ كل أدوات الإرسال على طلب التأكيد، وامنع الأدوات التي لا يحتاجها المشروع.
الدليل: Use the MCP server with Claude Code - 5
أضف مواصفات OpenAPI
نزّل openapi.yaml إلى مستودعك، واطلب من Claude Code اعتماده في مسارات نقاط الاتصال والحقول والقيم المسموح بها.
الدليل: OpenAPI 3.1 spec - 6
اختبر على رقمك
اطلب من Claude Code إرسال رسالة تجريبية إلى رقمك الموثّق، ثم اطّلع على تقرير التسليم.
توثيق الجهة المطوّرة
Claude Code علامة تجارية مملوكة لأصحابها. لا ترتبط OmniChannels.ai بـ Claude Code ولا تحظى بتأييدها؛ تصف هذه الصفحة ربطاً يتم عبر ميزات MCP أو HTTP أو Webhooks المتوفرة في Claude Code نفسها.
