خادم MCP
يتيح @smsfabric/mcp-server لمساعد ذكي مثل Claude أو Cursor أو GitHub Copilot إرسال الرسائل النصية والتحقق من أرقام الهواتف والبحث في جهات الاتصال وتشغيل الحملات عبر حسابك في SMSFabric. تطلب ما تريد بلغة عادية، فيستدعي المساعد أدوات الخادم، ويستدعي الخادم واجهة SMSFabric البرمجية بمفتاح API الخاص بك.
ما هو MCP
Section titled “ما هو MCP”بروتوكول سياق النموذج (Model Context Protocol) معيار مفتوح لربط المساعدين الأذكياء بالأدوات والبيانات. يصف خادم MCP مجموعة أدوات (لكل أداة اسم ووصف ومخطط للمدخلات)، ويقرر عميل MCP، أي تطبيق المساعد، متى يستدعيها.
يعمل خادم SMSFabric على جهازك كعملية محلية. يشغّله العميل ويتواصل معه عبر الدخل والخرج القياسيين (stdio). يحتاج إلى Node.js 20 أو أحدث، ولا يرسل طلبات HTTPS إلا إلى https://api.smsfabric.com.
ما يستطيع المساعد فعله
Section titled “ما يستطيع المساعد فعله”للخادم 16 أداة. المدخلات الكاملة والأمثلة في صفحة الأدوات.
| المجال | الأدوات | مثال على الطلب |
|---|---|---|
| الرسائل | send_sms وlist_messages وget_message |
«أرسل إلى +201001234567 أن الطلب شحن، ثم أخبرني عندما تسلّم الرسالة.» |
| التحقق | send_verification وcheck_verification |
«أرسل رمز تحقق إلى +201001234567.» |
| الهواتف | list_devices |
«أي هواتف البوابة غير متصلة أو بطاريتها منخفضة؟» |
| جهات الاتصال | find_contacts وadd_contact |
«ابحث عن رقم منى، وأضف زميلتها سارة بالوسم vip.» |
| الحملات | list_campaigns وget_campaign وcreate_campaign وestimate_campaign وstart_campaign وpause_campaign وresume_campaign وcancel_campaign |
«جهّز حملة لأصحاب الوسم vip بخصم 20% هذا الأسبوع، وأخبرني كم ستستغرق.» |
لا يستطيع الخادم إدارة مفاتيح API أو خطافات الويب أو أعضاء الفريق أو الإعدادات أو القائمة السوداء. هذه تبقى في البوابة وفي الواجهة البرمجية.
نموذج الأمان
Section titled “نموذج الأمان”المساعد يتصرف نيابة عنك، لذا يحد الخادم مما يستطيع فعله على أربع طبقات:
- نطاقات مفتاح API. لا يفعل الخادم إلا ما يسمح به مفتاحه. مفتاح بالنطاقين
messages:readوdevices:readيستطيع الاطلاع ولا يستطيع الإرسال أبدًا. راجع الأمان لمعرفة المفتاح المناسب لكل استخدام. - مفاتيح الاختبار. مع مفتاح
sf_test_تذهب الرسائل والحملات إلى الجهاز الافتراضي المدمج ولا تصل أبدًا إلى هاتف حقيقي. ابدأ بها. - وسوم الأدوات. الأدوات التي تقرأ فقط موسومة بـ
readOnlyHint. والأداتانstart_campaignوcancel_campaignموسومتان بـdestructiveHint، ويطلب وصفهما من المساعد أن يؤكد معك أولًا. تستخدم العملاء هذه الوسوم لتقرر متى تطلب موافقتك. - نافذة الموافقة في العميل. يسأل Claude Desktop وClaude Code وCursor وVS Code قبل تشغيل أي أداة ما لم تسمح بها دائمًا. أبق الموافقة مفعّلة لكل أداة ترسل.
لا يرى الخادم رموز التحقق أبدًا: تولدها SMSFabric ولا يستلمها إلا المستلم. على المساعد أن يطلب من الشخص قراءة الرمز.