SMS و OTP و webhooks لـ Claude Code و Cursor و Windsurf
اربط رقمك مباشرة بمساعد البرمجة الذكي. يرسل SMS بلا حدود، يولّد ويتحقق من رموز OTP، ويستقبل ردود العملاء عبر webhooks — كل ذلك من شريحتك في هاتف Android. نفس مفتاح SMS8، أدوات JSON-RPC جاهزة، بلا Twilio وبلا A2P 10DLC وبلا فواتير لكل رسالة.
ما الذي يستطيع مساعدك الذكي فعله
كل أداة تمر عبر نفس مسار الإرسال الذي تستخدمه لوحة SMS8. الأرصدة وإعادة المحاولة والتوجيه بين أجهزتك وتوقيع webhooks — كل شيء يعمل كأنك تنادي الـ API مباشرة.
setup_sms8
المصافحة الأولى. تتحقق من مفتاح الـ API وترجع لك قائمة الأجهزة وخطتك وسياق الدمج.
send_sms
أرسل رسالة واحدة عبر هاتف Android مقترن. توجيه حسب الجهاز أو الشريحة.
send_otp
يولّد رمز تحقق ويرسله. اضبط الطول والمدة وعدد المحاولات كما يناسبك.
verify_otp
مقارنة بزمن ثابت مع آخر رمز صادر. ترجع لك المحاولات المتبقية عند عدم التطابق.
wait_for_otp جديد
يوقف الوكيل حتى يصل SMS فيه رمز إلى هاتفك، ويستخرج الرمز تلقائيًا. الحل المثالي للوكلاء المستقلين.
get_messages
يجلب آخر الرسائل الواردة أو الصادرة. صفِّ حسب الاتجاه أو حسب الرقم.
list_devices
يعرض الأجهزة المقترنة. اختر مرسلًا بعينه أو وزّع الحمل بين شرائحك.
get_balance جديد
فحص رصيد سريع. الرسائل المتبقية، الأيام حتى التجديد، وملخص في سطر واحد.
create_webhook
سجّل عنوان استدعاء يستقبل الرسائل الواردة. HTTPS فقط، محمي من SSRF، موقّع بـ HMAC.
اقرأ التوثيق كاملًا
مرجع شامل للـ API و OTP مع أمثلة curl وحدود الاستخدام ونموذج الأمان.
ثلاث طرق للتثبيت، اختر الأنسب لك
SMS8 يصلك بثلاث صور: خادم MCP مستضاف عبر HTTP، إضافة Claude Code مع Skill جاهزة، ومُشغّل npx لعملاء stdio.
- HTTP المستضاف — يعمل داخل Claude Code و Cursor و Windsurf برمز Bearer واحد
- إضافة Claude — عبر
/plugin marketplace add 1fancy/sms8-sms-gateway - npx — جسر stdio بأمر واحد:
npx -y @sms8/mcp
{
"mcpServers": {
"sms8": {
"url": "https://mcp.sms8.io",
"transport": "http",
"headers": {
"Authorization":
"Bearer YOUR_SMS8_API_KEY"
}
}
}
}
التثبيت عبر npm
تسع حزم npm تغطّي كل سيناريو: وكيل ذكاء اصطناعي عبر MCP، سكربتات الطرفية، تدفّقات OTP، hooks React + إضافات Capacitor وCordova لتطبيقات Ionic. مفتاح API واحد، هاتف أندرويد مقترن.
مشغّل MCP لـ Claude Code وCursor وWindsurf وOpenCode. الصقه في إعداد MCP لديك وسيحصل مساعدك الذكي على 9 أدوات SMS.
$ npx -y sms8-mcp
واجهة سطر أوامر للطرفية. أرسل SMS، أرسل / تحقّق / انتظر رموز OTP، اقرأ الصندوق، اعرض الأجهزة. مثالية للسكربتات وcron وCI.
$ npx sms8-cli send +14155550100 "Hi"
Hook useSms8Otp() لـ React + مكوّن <OtpInput /> جاهز للاستخدام مع فواصل وRTL وقناع وrender props.
$ npm i react-sms-otp
نفس الكود لـ react-sms-otp، محسّن لمحرّكات البحث لكلمتي «sms otp verify» و«OTP input».
$ npm i sms-otp-verify
إضافة Capacitor لتطبيقات Ionic: جسور أصلية iOS Swift + Android Kotlin مع fallback ويب.
$ npm i capacitor-sms-otp-send-verify
إضافة Cordova لتطبيقات Ionic: جسور أصلية iOS Swift + Android Kotlin لإرسال OTP والتحقّق منه.
$ cordova plugin add cordova-plugin-sms-otp-send
إصدار خاص بالـ OTP من الـ CLI. أرسل وتحقّق من رموز OTP عبر هاتفك الخاص، دون Twilio ودون رسوم لكل رمز.
$ npx sms-otp-using-myphone send +1234
إصدار «الهاتف كبوّابة» من الـ CLI. نفس الواجهة الخلفية، محسّن للفرق التي تبحث عن بوّابة SMS عبر الهاتف.
$ npx phone-sms-gateway send +1234 "Hi"
إصدار Android-first من الـ CLI. نفس الكود، محسّن للمطوّرين الباحثين عن «إرسال SMS من أندرويد».
$ npx send-sms-from-android send +1234 "Hi"
أو تصفّح الكود على GitHub ↗
اطلب من مساعدك مباشرة، انسخ وألصق
التحقق من رقم الجوال
"اربط التحقق برقم الجوال في هذا التطبيق عبر sms8 MCP. استخدم send_otp في /signup و verify_otp في /verify-phone، وأظهر المحاولات المتبقية عند الخطأ."
تنبيهات الطلبات
"عند شحن طلب جديد، أرسل للعميل رسالة SMS فيها رابط التتبع عبر sms8 MCP."
صندوق دعم ثنائي الاتجاه
"سجّل webhook على sms8 MCP لرابط https://app.com/sms-in. اكتب لي المعالج الذي يتحقق من توقيع HMAC ويحوّل الرسائل الواردة إلى طابور الدعم."
دخول بدون كلمة مرور
"استبدل تسجيل الدخول برابط البريد بـ OTP عبر sms8 MCP. رمز من 6 خانات وصلاحيته 5 دقائق."
تذكيرات المواعيد
"اقرأ مواعيد الغد من قاعدة البيانات، وأرسل لكل موعد رسالة تذكير قبله بـ 24 ساعة باستخدام send_sms."
تحقق ثنائي لصفحة الإدارة
"أضف 2FA عبر SMS لصفحة /admin من خلال sms8 MCP. اقفل الحساب بعد 5 محاولات فاشلة على verify_otp."
SMS8 MCP أمام Twilio و MessageBird
| الميزة | SMS8 MCP | Twilio | MessageBird |
|---|---|---|---|
| خادم MCP جاهز | نعم | لا | لا |
| تكلفة الرسالة الواحدة | صفر | $0.0079+ | $0.05+ |
| اشتراط A2P 10DLC | لا | نعم | نعم |
| تخصيص رقم | غير مطلوب | $1+ شهريًا | $2+ شهريًا |
| زمن الإعداد | 60 ثانية | أيام إلى أسابيع | أيام |
| التحقق بـ OTP | جاهز ومجاني | خدمة إضافية | خدمة إضافية |
| كود MCP مفتوح المصدر | رخصة MIT | لا | لا |
الأمان من الإعدادات الافتراضية، بلا فخاخ
سقف صارم لكل رقم
5 رموز OTP كحد أقصى لكل رقم خلال 24 ساعة. غير قابل للتعديل.
حماية من سباق الطلبات
فحص الفترة بين الإرسال والسقف اليومي يجري داخل معاملة قاعدة بيانات مع قفل صفوف.
نقاط OTP بطلبات POST فقط
طلبات GET ترجع 405. الكوكيز يتم تجاهلها.
إخفاء مفتاح الـ API
setup_sms8 لا يُظهر إلا آخر 4 خانات من مفتاحك.
webhooks محمية من SSRF
تُحجب عناوين loopback و RFC1918 و CGNAT و link-local و IPv4 المعكوسة في IPv6.
توقيع HMAC على كل تسليم
الرسائل الواردة وأحداث التسليم تأتيك موقّعة بـ HMAC-SHA256، فلا أحد ينتحل بياناتها.
أسئلة يطرحها المطورون كثيرًا
ما هو خادم SMS8 MCP؟
خادم Model Context Protocol على mcp.sms8.io يربط أدوات البرمجة الذكية (Claude Code و Cursor و Windsurf و Codex و Devin) بحساب SMS8. يستطيع المساعد إرسال SMS وتوليد رموز التحقق وتسجيل webhooks. كل رسالة تخرج من شريحتك في هاتف Android عبر بوابة SMS8.
هل أحتاج A2P 10DLC؟
لا. SMS8 يستخدم هاتف Android والشريحة التي بحوزتك. بلا تسجيل A2P 10DLC، بلا رسوم لكل رسالة، بلا أرقام مستأجرة.
كيف أضيف SMS إلى مشروع Claude Code؟
أضف خادم MCP إلى ~/.config/claude/mcp-servers.json بنقل HTTP على https://mcp.sms8.io ومفتاح SMS8 كـ Bearer token. أو شغّل /plugin marketplace add 1fancy/sms8-sms-gateway ثم /plugin install sms8-sms-gateway.
هل يعمل مع Cursor و Windsurf؟
نعم، كلاهما يدعمان MCP عبر HTTP. أضف https://mcp.sms8.io ومفتاح SMS8 في ترويسة Bearer إلى ~/.cursor/mcp.json أو ~/.codeium/windsurf/mcp_config.json.
هل هو بديل لـ Twilio؟
نعم. SMS8 يعتمد على هاتف Android وشريحة عاملة لديك. لا رسوم لكل رسالة، لا A2P 10DLC، لا رقم تستأجره. الاشتراك يبدأ من $29 شهريًا مع رسائل بلا حدود.
هل الكود مفتوح المصدر؟
نعم، برخصة MIT على github.com/1fancy/sms8-sms-gateway.