باختصار
يتصل VS Code بمنصة OmniChannels.ai بإضافة خادم MCP البعيد لدينا، https://mcp.broadnet.me/mcp، إلى الملف .vscode/mcp.json بوصفه خادمًا من نوع http. ويطلب مُدخل من نوع promptString مع ضبط password رمز الوصول (Token) ويحفظه بأمان، فلا يُرفع أي مفتاح إلى المستودع. بعدها يستطيع وضع الوكيل في GitHub Copilot إرسال رسائل تجريبية، وعرض قوالب واتساب، والاطلاع على تقارير التسليم أثناء مساعدتك في كتابة شيفرة التكامل.
ما الذي يمكنك فعله
شيفرة مطابقة لقوالبك
يعرض Copilot قوالب واتساب المعتمدة لديك عبر MCP، ويكتب دالة إرسال تتضمن المتغيرات التي يحتاجها كل قالب بالضبط.
جرّب أن تطلب
“اعرض قوالب واتساب المعتمدة لديّ، ثم اكتب دالة C# ترسل القالب order_update مع رقم الطلب وتاريخ التسليم.”
بناء نقطة Webhook واختبارها
يكتب Copilot نقطة استقبال لحالات التسليم والرسائل الواردة، ثم تُطلق إرسالًا تجريبيًا لترى الحمولات الحقيقية وهي تصل.
جرّب أن تطلب
“اكتب نقطة Webhook باستخدام FastAPI تحفظ حالات التسليم حسب معرّف الرسالة وتقبل الحقول التي تختلف من قناة لأخرى، ثم أرسل رسالة SMS تجريبية إلى 447700900123 لأتابع وصولها.”
التحقق من التسليم قبل الإطلاق
بعد أن ترسل شيفرتك رسالة تجريبية، يقرأ Copilot تقرير التسليم لتتأكد من الحالة التي سجّلها معالجك.
جرّب أن تطلب
“تحقق من تقرير تسليم آخر رسالة أُرسلت إلى 971500000000، وقارن حالتها بما سجّلته قاعدة بياناتنا.”
اعتمد على المواصفات لا على الذاكرة
عندما تكون مواصفات OpenAPI لدينا في مساحة العمل، يستخدم Copilot المسارات والحقول الصحيحة، بما في ذلك عمليات الإرسال التي تتطلب multipart/form-data.
جرّب أن تطلب
“اعتمادًا على docs/omnichannels-openapi.yaml، اكتب دالة مساعدة لإرسال رسائل واتساب جماعية، وحدّد الحقول التي تُرسل بصيغة multipart/form-data.”
صياغة النصوص بالعربية والإنجليزية
يصوغ Copilot نص الرسالة باللغتين ويعرضه عليك قبل استدعاء أي أداة إرسال.
جرّب أن تطلب
“اكتب رسالة SMS للتذكير بموعد بالعربية والإنجليزية، بحيث لا تتجاوز كل منهما مقطعًا واحدًا، واعرضها عليّ قبل إرسال رسالة تجريبية إلى 966500000000.”
كيف يتم الربط
يقرأ VS Code خوادم MCP من الملف .vscode/mcp.json في مساحة العمل. يُضاف خادمنا بوصفه خادمًا من نوع http مع ترويسة Authorization، ويأتي رمز الوصول من مُدخل من نوع promptString مع ضبط password على true، فيطلبه VS Code مرة واحدة ويبقيه خارج الملف الذي ترفعه إلى المستودع.
في وضع الوكيل في GitHub Copilot، تظهر أدوات خوادم MCP المفعّلة في قائمة الأدوات، حيث يمكنك تشغيل كل أداة أو إيقافها، ويمكن أن يطلب VS Code تأكيدك قبل استدعاء الأدوات. أبقِ التأكيد مفعّلًا لكل ما يرسل رسائل، لأن كل إرسال رسالة حقيقية تُحتسب عليها رسوم. وتتغير حقول الإعدادات بين إصدارات VS Code، لذا راجع وثائق MCP الخاصة به إذا لم يتعرّف على أحد الحقول.
- الملف: .vscode/mcp.json، نوع الخادم http، والعنوان https://mcp.broadnet.me/mcp
- الترويسة: Authorization: Bearer ${input:omnichannels-token}
- مُدخل الرمز: promptString مع password: true
- فعّل من قائمة الأدوات فقط ما تحتاجه مساحة العمل هذه
خطوات الإعداد
- 1
اطلب الوصول إلى API
اطلب وصولًا تجريبيًا واحصل على رمز وصول لواجهة API. تُرسل الرسائل التجريبية إلى أرقامك الموثّقة فقط.
- 2
احصل على مفتاح مؤقت
في بوابة الإدارة افتح Integrations ثم MCP Integration، واختر Get temporary key (الحصول على مفتاح مؤقت).
الدليل: MCP server for AI agents - 3
أنشئ .vscode/mcp.json
أضف خادمًا باسم omnichannels من نوع http بعنواننا، مع ترويسة Authorization تستخدم ${input:omnichannels-token}، ومُدخل promptString مع ضبط password على true.
الدليل: MCP server for AI agents - 4
شغّل الخادم وأدخل المفتاح
شغّل الخادم من VS Code، والصق مفتاحك عند الطلب، وتأكد من ظهور الأدوات في وضع الوكيل في Copilot.
- 5
قيّد الأدوات
من قائمة الأدوات، أوقف الأدوات التي لا تحتاجها مساحة العمل هذه، وأبقِ التأكيد مفعّلًا لكل أداة إرسال.
- 6
اختبر على رقمك
اطلب من Copilot إرسال رسالة تجريبية إلى رقمك الموثّق، ثم اطّلع على تقرير التسليم.
توثيق الجهة المطوّرة
VS Code علامة تجارية مملوكة لأصحابها. لا ترتبط OmniChannels.ai بـ VS Code ولا تحظى بتأييدها؛ تصف هذه الصفحة ربطاً يتم عبر ميزات MCP أو HTTP أو Webhooks المتوفرة في VS Code نفسها.
