أمان MCP
يقرر المساعد بنفسه أي أداة يستدعي، وقد يسيء فهم طلب أو يتأثر بنص يقرؤه في مكان آخر، مثل بريد إلكتروني أو صفحة ويب. اضبط الخادم بحيث يكون ثمن الاستدعاء الخاطئ قليلًا.
مفتاح لكل استخدام
Section titled “مفتاح لكل استخدام”لا يفعل الخادم إلا ما يسمح به مفتاح API الخاص به. أنشئ مفتاحًا منفصلًا لكل إعداد مساعد، بالنطاقات المذكورة في صفه فقط:
| الاستخدام | النطاقات | ما لا يستطيعه المساعد |
|---|---|---|
| متابعة الرسائل والهواتف | messages:read وdevices:read |
إرسال أي شيء |
| الدعم الفني: البحث عن عميل ومراسلته | messages:send وmessages:read وcontacts:read |
تعديل جهات الاتصال وتشغيل الحملات |
| التحقق من رقم هاتف | verify:send وverify:check |
إرسال أي نص آخر وقراءة الرسائل |
| صيانة دفتر العناوين | contacts:read وcontacts:manage |
إرسال أي شيء |
| تجهيز الحملات ومراجعتها | contacts:read وcampaigns:read وcampaigns:manage |
بدء حملة (يحتاج ذلك إلى messages:send أيضًا) |
| تشغيل الحملات من البداية إلى النهاية | contacts:read وcampaigns:read وcampaigns:manage وmessages:send |
إدارة المفاتيح أو خطافات الويب أو الأعضاء أو الإعدادات |
أضف تاريخ انتهاء، وقائمة عناوين IP مسموح بها إذا كان المساعد يعمل من شبكة ثابتة. راجع المصادقة.
ابدأ في بيئة الاختبار
Section titled “ابدأ في بيئة الاختبار”استخدم مفتاح sf_test_ حتى تثق بالإعداد. رسائل الاختبار وحملاته تذهب إلى الجهاز الافتراضي المدمج، وتمر بالحالتين sent وdelivered كالرسائل الحقيقية، ولا تصل أبدًا إلى هاتف ولا تكلف رسالة. انتقل إلى مفتاح حقيقي فقط عندما تتصرف طلباتك كما تتوقع. راجع بيئة الاختبار.
التأكيد قبل أي إرسال
Section titled “التأكيد قبل أي إرسال”أربع أدوات تصل إلى أشخاص حقيقيين مع مفتاح حقيقي: send_sms وsend_verification وstart_campaign وcancel_campaign (التي توقف رسائل قد ينتظرها الناس).
- أبق نافذة الموافقة في العميل مفعّلة لهذه الأدوات، ولا تختر «السماح دائمًا» لها.
- اقرأ الوسائط في نافذة الموافقة قبل أن توافق: الرقم والنص ومعرف الحملة.
- الأدوات
send_smsوstart_campaignوcancel_campaignموسومة بـdestructiveHint: true. ويطلب وصف أداتي الحملات من المساعد أن يؤكد معك وأن يشغّلestimate_campaignأولًا. ومع ذلك قد يشغلها العميل دون سؤال إذا سمحت بكل الأدوات. - تقبل
send_smsالمعاملidempotencyKey. المساعد الذي يعيد استخدام المفتاح عند إعادة المحاولة بعد تجاوز المهلة لا يستطيع إرسال النص نفسه مرتين. - الأدوات التي تقرأ فقط (
list_*وget_*وfind_contactsوestimate_campaign) آمنة للسماح الدائم.
السجلات وstderr
Section titled “السجلات وstderr”يكتب الخادم رسائل بروتوكول MCP في stdout وتشخيصاته الخاصة في stderr: سطرًا واحدًا عند الاتصال (smsfabric-mcp: connected (https://api.smsfabric.com)) وسطرًا عند فشل البدء. لا يسجل الطلبات ولا أرقام الهواتف ولا نصوص الرسائل ولا المفتاح.
قد يحتفظ العميل بسجلاته الخاصة لاستدعاءات الأدوات، مع وسائطها ونتائجها، وفيها أرقام هواتف ونصوص رسائل. تعامل مع هذه السجلات كبيانات شخصية. يكتب Claude Desktop مثلًا سجلات الخوادم في مجلد logs الخاص به.
لا تلصق المفتاح أبدًا في محادثة مع المساعد. ضعه فقط في إعدادات العميل، أو الأفضل في متغير بيئة أو نافذة طلب أسرار (راجع العملاء).
تدوير المفاتيح وإبطالها
Section titled “تدوير المفاتيح وإبطالها”- دوّر المفتاح بانتظام، وفورًا إذا شاركت ملف إعدادات يحتويه أو رفعته إلى المستودع. في البوابة افتح المطورون ← مفاتيح API ودوّره، أو استخدم
apiKeys.rotate. - ضع السر الجديد في إعدادات العميل وأعد تشغيله. يبقى السر القديم صالحًا 24 ساعة، فلا يحدث انقطاع.
- إذا اشتبهت في سوء استخدام، أبطل المفتاح بدل تدويره. الطلبات التي تستخدمه تفشل فورًا.
- راجع سجل التدقيق وسجل الرسائل بحثًا عن أي شيء فعله المفتاح ولم تتوقعه.
مفتاح لكل شخص ولكل عميل يجعل هذا بسيطًا: تبطل إعدادًا واحدًا دون أن تعطل الباقي.