Documentación de eWeLinkTutorial de eWeLink MCP Server: Controla tu hogar inteligente con IA
Una guía paso a paso para configurar eWeLink MCP Server, conectarlo a clientes de IA como Cursor y controlar tu hogar inteligente con lenguaje natural.
Con eWeLink MCP Server (V5.22, Prime), puedes conectar clientes y agentes de IA compatibles con MCP a tu cuenta de eWeLink y controlar dispositivos inteligentes compatibles con comandos simples en lenguaje natural. Construido sobre el Model Context Protocol (MCP), sirve como puente entre asistentes de IA avanzados y tus dispositivos IoT — permitiéndote consultar qué dispositivos están encendidos, verificar su estado y ejecutar acciones a través de una interfaz conversacional.
Esta guía paso a paso cubre la configuración completa: activar el MCP Server en la aplicación, generar tu URL de MCP, conectarlo en Cursor y ejecutar algunos comandos simples para confirmar que todo funciona.
Guía de configuración paso a paso
Paso 1: Activar MCP Server en la aplicación eWeLink
- Abre la aplicación eWeLink.
- Ve a: Perfil → Funciones piloto → MCP Server
Paso 2: Genera tu URL de MCP Server (y gestiona el acceso)
Al entrar en la página de MCP Server, verás las opciones de gestión de acceso:
- Copiar URL — Copia tu URL de MCP Server y pégalo en la configuración MCP de tu cliente de IA.
- Actualizar token — Genera una nueva URL si la actual ha expirado.
- Revocar autorización — Bloquea inmediatamente el acceso de la IA. Úsalo cuando quieras desconectar todos los clientes de IA por motivos de privacidad/seguridad.
Buena práctica: Si sospechas que la URL fue compartida o expuesta, usa "Revocar autorización" de inmediato y luego genera una nueva URL.
Paso 3: Configura tu cliente de IA (Ejemplo: Cursor)
Obtén Cursor: Descarga Cursor y regístrate o inicia sesión.
Accede a la configuración: Abre Cursor y ve a Settings → Tools & MCP → Add Custom MCP
Añade el servidor: Crea una nueva entrada con este formato JSON:
{
"mcpServers": {
"ewelink": {
"type": "http",
"url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
}
}
}
Guarda y reinicia: Guarda la configuración y abre una nueva sesión de chat/agente.
Recomendado: Activa la opción Auto en la barra de herramientas. La compatibilidad con MCP puede variar entre los modos de agente, y Auto ayuda a seleccionar el más adecuado.
Prueba tu configuración
Una vez configurado, prueba estas frases con tu asistente de IA:
- "¿Cuántos dispositivos tengo?"
- "Muéstrame qué dispositivos están encendidos."
- "Enciende los interruptores de la sala."
Notas de compatibilidad y limitaciones actuales
Esta es una versión inicial, así que hay algunas limitaciones:
- Solo los dispositivos compatibles aparecen en los resultados de consulta.
- Si un dispositivo aún no es compatible, el cliente de IA no podrá listarlo ni controlarlo a través de MCP.
- Los diferentes modos de agente de IA pueden comportarse de forma distinta.
- El mismo comando puede funcionar en un modo y fallar en otro. Si tienes problemas, prueba el modo Auto o cambia de modo.
Dispositivos compatibles actualmente
La versión inicial se centra en interruptores y enchufes, incluyendo modelos populares como:
| Tipo de dispositivo | Modelos compatibles (ejemplos) |
|---|---|
| Enchufe de un canal | SONOFF BASIC_R3, SONOFF MINI, SONOFF RF_R2, SONOFF S20R1, SONOFF S26, SONOFF S31 Lite, SONOFF S55R1, SONOFF S30 |
| Enchufe de un canal (compatible con 2.4G eWeLink-Remote) | SONOFF BASICR4, SONOFF MINI-D, SONOFF MINIR3, SONOFF MINIR4, SONOFF S40 lite |
| Interruptor inteligente DIY | SONOFF Basic, SONOFF RF, SONOFF SV |
| Interruptor de un canal | SONOFF RF R2, SONOFF T1 1C, SONOFF Touch, SONOFF TX1C |
| Interruptor de dos canales | SONOFF T1 2C, SONOFF TX2C |
| Interruptor de tres canales | SONOFF T1 3C, SONOFF TX3C |
| Enchufe de cuatro canales | SONOFF 4CH |
| Enchufe con medición de potencia | SONOFF IW100_US, SONOFF IW101_US, SONOFF Pow R2, SONOFF POWR3, SONOFF S31 |
| Enchufe de dos canales | SONOFF DUALR2 |
| Interruptor inteligente con monitoreo de temperatura y humedad | SONOFF S22_CN, SONOFF TH10, SONOFF TH16 |
| Enchufe con monitoreo de potencia y alerta de sobrecarga | SONOFF S40, SONOFF S40TPA, SONOFF S40TPB |
| POWR3 con pantalla LCD | SONOFF POWCT, SONOFF POWR316, SONOFF POWR320D, SONOFF S60TPF, SONOFF S60TPG |
| Interruptor con monitoreo de temperatura y humedad (con historial) | SONOFF TH16R3, SONOFF THR316, SONOFF THR320 |
| Enchufe de un canal (versión multicanal) | SONOFF Micro |
| Enchufe de cuatro canales (compatible con 2.4G eWeLink-Remote) | BL1-S04-01, CK-BL602-4SW-HS |
Solución de problemas y consejos
- ¿La URL no funciona? Intenta generar un nuevo token en la aplicación eWeLink.
- ¿Faltan dispositivos? Verifica si el modelo de tu dispositivo está en la lista de compatibles arriba.
- ¿Los comandos no se ejecutan? Asegúrate de estar en un modo de IA compatible (usa "Auto").
- ¿Preocupación de seguridad? Usa "Revocar autorización" de inmediato y luego genera una nueva URL.
Todo listo. Activa el MCP Server en la aplicación eWeLink, conéctalo a tu cliente de IA y comienza a controlar tus dispositivos compatibles con comandos simples en lenguaje natural.
Mantente conectado con eWeLink
Para estar al día con las últimas novedades de eWeLink y consejos para el hogar inteligente, síguenos en nuestros canales activos:
- Foro: eWeLink Forum
- Facebook: ewelink.support
- X: eWeLinkapp
- YouTube: eWeLink Smart Home
- Web: ewelink.cc
Adiós a las suposiciones: los registros de operaciones ahora muestran el nombre exacto de la escena
eWeLink ha mejorado los registros de operaciones para mostrar los nombres exactos de las escenas en dispositivos compatibles, haciendo que la verificación y la resolución de problemas sean instantáneas.
V5.22 amplía los límites: más dispositivos virtuales, más plugins de termostato, uso compartido más fácil
eWeLink V5.22 amplía los límites Prime para dispositivos virtuales, plugins de termostato y uso compartido de dispositivos, ofreciéndote más flexibilidad y menos restricciones.