מסמכי eWeLinkמדריך eWeLink MCP Server: שלטו בבית החכם שלכם עם AI
מדריך צעד אחר צעד להגדרת eWeLink MCP Server, חיבור ללקוחות AI כמו Cursor ושליטה בבית החכם שלכם בשפה טבעית.
עם eWeLink MCP Server (V5.22, Prime), תוכלו לחבר לקוחות וסוכני AI תואמי MCP לחשבון eWeLink שלכם ולשלוט במכשירים חכמים נתמכים באמצעות פקודות פשוטות בשפה טבעית. מבוסס על פרוטוקול Model Context Protocol (MCP), הוא מגשר בין עוזרי AI מתקדמים למכשירי ה-IoT שלכם — כך שתוכלו לבדוק מה דלוק, לבדוק סטטוס מכשירים ולהפעיל פעולות דרך ממשק שיחה.
מדריך זה מכסה את כל תהליך ההגדרה: הפעלת MCP Server באפליקציה, יצירת כתובת MCP URL, חיבור ב-Cursor והרצת כמה פקודות פשוטות כדי לוודא שהכל עובד.
מדריך הגדרה צעד אחר צעד
שלב 1: הפעלת MCP Server באפליקציית eWeLink
- פתחו את אפליקציית eWeLink.
- נווטו אל: פרופיל → תכונות ניסיוניות → MCP Server
שלב 2: יצירת כתובת MCP Server URL (וניהול גישה)
לאחר כניסה לעמוד MCP Server, תראו אפשרויות ניהול גישה:
- העתקת URL — העתיקו את כתובת MCP Server URL שלכם והדביקו אותה בהגדרות MCP של לקוח ה-AI.
- רענון טוקן — צרו כתובת URL חדשה אם הנוכחית פגה.
- ביטול הרשאה — חוסם מיידית גישת AI. השתמשו בכך בכל עת שתרצו לנתק את כל לקוחות ה-AI המחוברים מטעמי פרטיות/אבטחה.
שיטה מומלצת: אם אתם חושדים שה-URL שותף או נחשף, השתמשו ב"ביטול הרשאה" מיד, ואז צרו URL חדש.
שלב 3: הגדרת לקוח ה-AI שלכם (דוגמה: 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 עוזר לבחור את המתאים ביותר.
בדיקת ההגדרה
לאחר ההגדרה, נסו את הפקודות הבאות עם עוזר ה-AI שלכם:
- "כמה מכשירים יש לי?"
- "הראה לי אילו מכשירים דלוקים כרגע."
- "הדלק את המתגים בסלון."
הערות תאימות ומגבלות נוכחיות
זוהי גרסה ראשונית, לכן צפו למספר מגבלות:
- רק מכשירים נתמכים מופיעים בתוצאות השאילתות.
- אם מכשיר עדיין לא נתמך, לקוח ה-AI לא יוכל להציג אותו או לשלוט בו דרך MCP.
- מצבי סוכן AI שונים עשויים להתנהג אחרת.
- אותה פקודה עשויה להצליח במצב אחד ולהיכשל באחר. אם נתקלתם בבעיות, נסו מצב 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 |
פתרון בעיות וטיפים
- ה-URL לא עובד? נסו ליצור טוקן חדש באפליקציית eWeLink.
- מכשירים חסרים? בדקו אם דגם המכשיר שלכם נמצא ברשימת המכשירים הנתמכים למעלה.
- פקודות לא מתבצעות? ודאו שאתם במצב AI תואם (השתמשו ב-"Auto").
- חשש אבטחתי? השתמשו ב"ביטול הרשאה" מיד, ואז צרו URL חדש.
אתם מוכנים. הפעילו את MCP Server באפליקציית eWeLink, חברו אותו ללקוח ה-AI שלכם והתחילו לשלוט במכשירים נתמכים עם פקודות פשוטות בשפה טבעית.
הישארו מחוברים עם eWeLink
כדי להישאר מעודכנים בחידושים האחרונים של eWeLink וטיפים לבית חכם, עקבו אחרינו בערוצים המקוונים שלנו:
- פורום: eWeLink Forum
- Facebook: ewelink.support
- X: eWeLinkapp
- YouTube: eWeLink Smart Home
- אתר: ewelink.cc
בלי ניחושים: יומני הפעולות מציגים כעת את שמות התרחישים המדויקים
eWeLink שדרגה את יומני הפעולות כך שיציגו את שמות התרחישים המדויקים עבור מכשירים נתמכים, והפכה את פתרון הבעיות והאימות למיידיים.
V5.22 מרחיב את הגבולות: יותר מכשירים וירטואליים, יותר תוספי תרמוסטט, שיתוף קל יותר
eWeLink V5.22 מעלה את מגבלות Prime למכשירים וירטואליים, תוספי תרמוסטט ושיתוף מכשירים, ומעניק לכם יותר גמישות ופחות פשרות.