eWeLink 文件eWeLink MCP Server 使用教學：用 AI 控制你的智慧家居
一步步教你設定 eWeLink MCP Server，連接 Cursor 等 AI 客戶端，用自然語言輕鬆控制智慧家居裝置。
透過 eWeLink MCP Server（V5.22，Prime），你可以將支援 MCP 協定的 AI 客戶端和代理連接到你的 eWeLink 帳戶，用簡單的自然語言指令控制支援的智慧裝置。它基於 Model Context Protocol (MCP) 打造，在先進的 AI 助手和你的 IoT 裝置之間搭建橋樑——讓你能透過對話方式查詢裝置狀態、檢查開關情況並觸發各種操作。
本教學將帶你完成完整的設定流程：在 App 中啟用 MCP Server、產生 MCP URL、在 Cursor 中設定連線，以及執行幾個簡單的提示來驗證一切正常。
設定步驟詳解
第一步：在 eWeLink App 中啟用 MCP Server
- 開啟 eWeLink App。
- 依序前往：個人檔案 → 試驗功能 → MCP Server
第二步：產生 MCP Server URL（並管理存取權限）
進入 MCP Server 頁面後，你會看到以下存取管理選項：
- 複製 URL — 複製你的 MCP Server URL，貼到 AI 客戶端的 MCP 設定中。
- 重新整理 Token — 當前 URL 過期時，可以產生新的 URL。
- 撤銷授權 — 立即封鎖 AI 存取。當你需要基於隱私或安全考量切斷所有已連線的 AI 客戶端時使用。
最佳做法： 如果你懷疑 URL 被洩露或分享給他人，請立即使用「撤銷授權」，然後重新產生一個新的 URL。
第三步：設定 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 |
| 帶 LCD 螢幕的 POWR3 | 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 App 中重新產生 Token。
- 找不到裝置？ 檢查你的裝置型號是否在上方支援清單中。
- 指令無法執行？ 確保你使用的是相容的 AI 模式（建議使用「Auto」）。
- 安全疑慮？ 立即使用「撤銷授權」，然後重新產生新的 URL。
一切就緒。在 eWeLink App 中啟用 MCP Server，連接到你的 AI 客戶端，然後用簡單的自然語言指令開始控制你的智慧裝置吧。
關注 eWeLink 動態
想了解 eWeLink 的最新動態和智慧家居使用技巧，歡迎透過以下管道關注我們：
- 論壇：eWeLink Forum
- Facebook：ewelink.support
- X：eWeLinkapp
- YouTube：eWeLink Smart Home
- 官網：ewelink.cc