وثائق eWeLinkدليل eWeLink MCP Server: تحكّم بمنزلك الذكي باستخدام الذكاء الاصطناعي
دليل تفصيلي خطوة بخطوة لإعداد eWeLink MCP Server وربطه بعملاء الذكاء الاصطناعي مثل Cursor والتحكم بمنزلك الذكي بأوامر طبيعية.
مع eWeLink MCP Server (V5.22، Prime)، يمكنك ربط عملاء ووكلاء الذكاء الاصطناعي المتوافقين مع MCP بحسابك في eWeLink والتحكم بالأجهزة الذكية المدعومة بأوامر بسيطة بلغة طبيعية. مبني على بروتوكول Model Context Protocol (MCP)، يعمل كجسر بين مساعدات الذكاء الاصطناعي المتقدمة وأجهزة إنترنت الأشياء الخاصة بك — مما يتيح لك الاستعلام عن الأجهزة المشغّلة، والتحقق من حالتها، وتنفيذ الإجراءات من خلال واجهة محادثة.
يغطي هذا الدليل التفصيلي جميع خطوات الإعداد: تفعيل MCP Server في التطبيق، وإنشاء رابط MCP الخاص بك، وربطه في Cursor، وتشغيل بعض الأوامر البسيطة للتأكد من أن كل شيء يعمل بشكل صحيح.
دليل الإعداد خطوة بخطوة
الخطوة الأولى: تفعيل MCP Server في تطبيق eWeLink
- افتح تطبيق eWeLink.
- انتقل إلى: الملف الشخصي → الميزات التجريبية → MCP Server
الخطوة الثانية: إنشاء رابط MCP Server (وإدارة الوصول)
بعد الدخول إلى صفحة MCP Server، ستجد خيارات إدارة الوصول التالية:
- نسخ الرابط — انسخ رابط MCP Server والصقه في إعدادات MCP لعميل الذكاء الاصطناعي.
- تحديث الرمز — أنشئ رابطًا جديدًا إذا انتهت صلاحية الرابط الحالي.
- إلغاء التفويض — يحظر وصول الذكاء الاصطناعي فورًا. استخدمه في أي وقت تريد فيه قطع الاتصال بجميع عملاء الذكاء الاصطناعي لأسباب تتعلق بالخصوصية أو الأمان.
أفضل ممارسة: إذا شككت في أن الرابط قد تم مشاركته أو كشفه، استخدم "إلغاء التفويض" فورًا، ثم أنشئ رابطًا جديدًا.
الخطوة الثالثة: إعداد عميل الذكاء الاصطناعي (مثال: Cursor)
احصل على Cursor: حمّل Cursor وسجّل حسابًا أو سجّل الدخول.
الوصول إلى الإعدادات: افتح Cursor وانتقل إلى Settings → Tools & MCP → Add Custom MCP
إضافة الخادم: أنشئ إدخالًا جديدًا بصيغة JSON التالية:
{
"mcpServers": {
"ewelink": {
"type": "http",
"url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
}
}
}
الحفظ وإعادة التشغيل: احفظ الإعدادات وافتح جلسة محادثة أو وكيل جديدة.
يُنصح بـ: تفعيل خيار Auto في شريط الأدوات. يختلف دعم MCP بين أوضاع الوكيل المختلفة، ويساعد وضع Auto في اختيار الأنسب تلقائيًا.
اختبار الإعداد
بعد الانتهاء من الإعداد، جرّب هذه الأوامر مع مساعد الذكاء الاصطناعي:
- "كم عدد الأجهزة لديّ؟"
- "أرني الأجهزة المشغّلة حاليًا."
- "شغّل مفاتيح غرفة المعيشة."
ملاحظات التوافق والقيود الحالية
هذا إصدار أولي، لذا توقع بعض القيود:
- تظهر فقط الأجهزة المدعومة في نتائج الاستعلام.
- إذا لم يكن الجهاز مدعومًا بعد، فلن يتمكن عميل الذكاء الاصطناعي من عرضه أو التحكم به عبر MCP.
- قد تتصرف أوضاع الوكيل المختلفة بشكل مختلف.
- قد ينجح نفس الأمر في وضع ويفشل في آخر. إذا واجهت مشاكل، جرّب وضع Auto أو بدّل بين الأوضاع.
الأجهزة المدعومة حاليًا
يركز الإصدار الأولي على المفاتيح والمقابس، بما في ذلك النماذج الشائعة التالية:
| نوع الجهاز | طرازات الأجهزة المؤهلة (أمثلة) |
|---|---|
| مقبس أحادي القناة | SONOFF BASIC_R3, SONOFF MINI, SONOFF RF_R2, SONOFF S20R1, SONOFF S26, SONOFF S31 Lite, SONOFF S55R1, SONOFF S30 |
| مقبس أحادي القناة (يدعم 2.4G eWeLink-Remote) | SONOFF BASICR4, SONOFF MINI-D, SONOFF MINIR3, SONOFF MINIR4, SONOFF S40 lite |
| مفتاح ذكي DIY | SONOFF Basic, SONOFF RF, SONOFF SV |
| مفتاح أحادي القناة | SONOFF RF R2, SONOFF T1 1C, SONOFF Touch, SONOFF TX1C |
| مفتاح ثنائي القناة | SONOFF T1 2C, SONOFF TX2C |
| مفتاح ثلاثي القنوات | SONOFF T1 3C, SONOFF TX3C |
| مقبس رباعي القنوات | SONOFF 4CH |
| مقبس كشف الطاقة | SONOFF IW100_US, SONOFF IW101_US, SONOFF Pow R2, SONOFF POWR3, SONOFF S31 |
| مقبس ثنائي القناة | SONOFF DUALR2 |
| مفتاح ذكي لمراقبة الحرارة والرطوبة | SONOFF S22_CN, SONOFF TH10, SONOFF TH16 |
| مقبس مراقبة الطاقة مع تنبيه الحمل الزائد | SONOFF S40, SONOFF S40TPA, SONOFF S40TPB |
| POWR3 بشاشة LCD | SONOFF POWCT, SONOFF POWR316, SONOFF POWR320D, SONOFF S60TPF, SONOFF S60TPG |
| مفتاح مراقبة الحرارة والرطوبة (مع سجل) | SONOFF TH16R3, SONOFF THR316, SONOFF THR320 |
| مقبس أحادي القناة (نسخة متعددة القنوات) | SONOFF Micro |
| مقبس رباعي القنوات (يدعم 2.4G eWeLink-Remote) | BL1-S04-01, CK-BL602-4SW-HS |
استكشاف الأخطاء وإصلاحها ونصائح
- الرابط لا يعمل؟ جرّب إنشاء رمز جديد في تطبيق eWeLink.
- أجهزة مفقودة؟ تحقق مما إذا كان طراز جهازك مدرجًا في قائمة الأجهزة المدعومة أعلاه.
- الأوامر لا تُنفّذ؟ تأكد من أنك تستخدم وضع AI متوافقًا (استخدم "Auto").
- قلق أمني؟ استخدم "إلغاء التفويض" فورًا، ثم أنشئ رابطًا جديدًا.
أنت جاهز الآن. فعّل MCP Server في تطبيق eWeLink، واربطه بعميل الذكاء الاصطناعي، وابدأ بالتحكم في أجهزتك المدعومة بأوامر بسيطة بلغة طبيعية.
ابقَ على تواصل مع eWeLink
للبقاء على اطلاع بآخر تطورات eWeLink ونصائح المنزل الذكي، تواصل معنا عبر قنواتنا النشطة:
- المنتدى: eWeLink Forum
- Facebook: ewelink.support
- X: eWeLinkapp
- YouTube: eWeLink Smart Home
- الموقع: ewelink.cc
لا مزيد من التخمين: سجلات العمليات تعرض الآن أسماء المشاهد بدقة
قامت eWeLink بترقية سجلات العمليات لعرض أسماء المشاهد الدقيقة للأجهزة المدعومة، مما يجعل استكشاف الأخطاء والتحقق فوريًا وسهلاً.
V5.22 يرفع الحدود: المزيد من الأجهزة الافتراضية، والمزيد من إضافات التحكم بالحرارة، ومشاركة أسهل
يرفع eWeLink V5.22 حدود Prime للأجهزة الافتراضية وإضافات التحكم بالحرارة ومشاركة الأجهزة، مما يمنحك مرونة أكبر وقيود أقل.