eWeLink DocsTutorial eWeLink MCP Server: Controlla la tua casa smart con l'IA
Una guida passo passo per configurare eWeLink MCP Server, collegarlo a client IA come Cursor e controllare la tua casa smart con il linguaggio naturale.
Con eWeLink MCP Server (V5.22, Prime), puoi collegare client e agenti IA compatibili con MCP al tuo account eWeLink e controllare i dispositivi smart supportati con semplici comandi in linguaggio naturale. Basato sul Model Context Protocol (MCP), funge da ponte tra assistenti IA avanzati e i tuoi dispositivi IoT — permettendoti di verificare quali dispositivi sono accesi, controllare lo stato e attivare azioni tramite un'interfaccia conversazionale.
Questa guida passo passo copre l'intera configurazione: attivazione del MCP Server nell'app, generazione del tuo URL MCP, collegamento in Cursor ed esecuzione di alcuni semplici comandi per verificare che tutto funzioni.
Guida alla configurazione passo passo
Passo 1: Attiva il MCP Server nell'app eWeLink
- Apri l'app eWeLink.
- Vai su: Profilo → Funzionalità pilota → MCP Server
Passo 2: Genera il tuo URL MCP Server (e gestisci l'accesso)
Dopo aver aperto la pagina MCP Server, vedrai le opzioni di gestione dell'accesso:
- Copia URL — Copia il tuo URL MCP Server e incollalo nella configurazione MCP del tuo client IA.
- Aggiorna token — Crea un nuovo URL se quello attuale è scaduto.
- Revoca autorizzazione — Blocca immediatamente l'accesso IA. Usalo quando vuoi disconnettere tutti i client IA collegati per motivi di privacy/sicurezza.
Buona pratica: Se sospetti che l'URL sia stato condiviso o esposto, usa "Revoca autorizzazione" immediatamente, poi genera un nuovo URL.
Passo 3: Configura il tuo client IA (Esempio: Cursor)
Scarica Cursor: Scarica Cursor e registrati o accedi al tuo account.
Accedi alle impostazioni: Apri Cursor e vai su Settings → Tools & MCP → Add Custom MCP
Aggiungi il server: Crea una nuova voce con questo formato JSON:
{
"mcpServers": {
"ewelink": {
"type": "http",
"url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
}
}
}
Salva e riavvia: Salva la configurazione e apri una nuova sessione di chat/agente.
Consigliato: Attiva l'opzione Auto nella barra degli strumenti. Il supporto MCP può variare tra le modalità agente, e Auto aiuta a selezionare la più adatta.
Testa la tua configurazione
Una volta configurato, prova queste frasi con il tuo assistente IA:
- "Quanti dispositivi ho?"
- "Mostrami quali dispositivi sono accesi in questo momento."
- "Accendi gli interruttori del soggiorno."
Note sulla compatibilità e limitazioni attuali
Questa è una versione iniziale, quindi ci sono alcune limitazioni:
- Solo i dispositivi supportati appaiono nei risultati delle query.
- Se un dispositivo non è ancora supportato, il client IA non potrà elencarlo né controllarlo tramite MCP.
- Le diverse modalità agente IA possono comportarsi in modo diverso.
- Lo stesso comando può funzionare in una modalità e fallire in un'altra. In caso di problemi, prova la modalità Auto o cambia modalità.
Dispositivi attualmente supportati
La versione iniziale si concentra su interruttori e prese, inclusi modelli popolari come:
| Tipo di dispositivo | Modelli compatibili (esempi) |
|---|---|
| Presa monocanale | SONOFF BASIC_R3, SONOFF MINI, SONOFF RF_R2, SONOFF S20R1, SONOFF S26, SONOFF S31 Lite, SONOFF S55R1, SONOFF S30 |
| Presa monocanale (supporta 2.4G eWeLink-Remote) | SONOFF BASICR4, SONOFF MINI-D, SONOFF MINIR3, SONOFF MINIR4, SONOFF S40 lite |
| Interruttore smart DIY | SONOFF Basic, SONOFF RF, SONOFF SV |
| Interruttore monocanale | SONOFF RF R2, SONOFF T1 1C, SONOFF Touch, SONOFF TX1C |
| Interruttore bicanale | SONOFF T1 2C, SONOFF TX2C |
| Interruttore tricanale | SONOFF T1 3C, SONOFF TX3C |
| Presa a quattro canali | SONOFF 4CH |
| Presa con rilevamento potenza | SONOFF IW100_US, SONOFF IW101_US, SONOFF Pow R2, SONOFF POWR3, SONOFF S31 |
| Presa bicanale | SONOFF DUALR2 |
| Interruttore smart con monitoraggio temperatura e umidità | SONOFF S22_CN, SONOFF TH10, SONOFF TH16 |
| Presa con monitoraggio potenza e allarme sovraccarico | SONOFF S40, SONOFF S40TPA, SONOFF S40TPB |
| POWR3 con schermo LCD | SONOFF POWCT, SONOFF POWR316, SONOFF POWR320D, SONOFF S60TPF, SONOFF S60TPG |
| Interruttore con monitoraggio temperatura e umidità (con cronologia) | SONOFF TH16R3, SONOFF THR316, SONOFF THR320 |
| Presa monocanale (versione multicanale) | SONOFF Micro |
| Presa a quattro canali (supporta 2.4G eWeLink-Remote) | BL1-S04-01, CK-BL602-4SW-HS |
Risoluzione dei problemi e suggerimenti
- L'URL non funziona? Prova a generare un nuovo token nell'app eWeLink.
- Dispositivi mancanti? Verifica se il modello del tuo dispositivo è nell'elenco dei dispositivi supportati sopra.
- I comandi non vengono eseguiti? Assicurati di essere in una modalità IA compatibile (usa "Auto").
- Dubbi sulla sicurezza? Usa "Revoca autorizzazione" immediatamente, poi genera un nuovo URL.
Tutto pronto. Attiva il MCP Server nell'app eWeLink, collegalo al tuo client IA e inizia a controllare i dispositivi supportati con semplici comandi in linguaggio naturale.
Resta connesso con eWeLink
Per restare aggiornato sulle ultime novità eWeLink e i consigli per la casa smart, seguici sui nostri canali online:
- Forum: eWeLink Forum
- Facebook: ewelink.support
- X: eWeLinkapp
- YouTube: eWeLink Smart Home
- Sito web: ewelink.cc
Basta ipotesi: i registri delle operazioni ora mostrano il nome esatto della scena
eWeLink ha migliorato i registri delle operazioni per mostrare i nomi esatti delle scene sui dispositivi supportati, rendendo la verifica e la risoluzione dei problemi istantanee.
V5.22 alza i limiti: più dispositivi virtuali, più plugin termostato, condivisione più semplice
eWeLink V5.22 aumenta i limiti Prime per dispositivi virtuali, plugin termostato e condivisione dispositivi, offrendoti più flessibilità e meno compromessi.