Documentation eWeLinkTutoriel eWeLink MCP Server : Contrôlez votre maison connectée avec l'IA
Un guide étape par étape pour configurer eWeLink MCP Server, le connecter à des clients IA comme Cursor et contrôler votre maison connectée en langage naturel.
Avec eWeLink MCP Server (V5.22, Prime), vous pouvez connecter des clients et agents IA compatibles MCP à votre compte eWeLink et contrôler vos appareils connectés compatibles avec de simples commandes en langage naturel. Basé sur le Model Context Protocol (MCP), il fait le lien entre les assistants IA avancés et vos appareils IoT — vous permettant de vérifier quels appareils sont allumés, consulter leur état et déclencher des actions via une interface conversationnelle.
Ce guide étape par étape couvre l'intégralité de la configuration : activation du MCP Server dans l'application, génération de votre URL MCP, connexion dans Cursor et exécution de quelques commandes simples pour vérifier que tout fonctionne.
Guide de configuration étape par étape
Étape 1 : Activer le MCP Server dans l'application eWeLink
- Ouvrez l'application eWeLink.
- Accédez à : Profil → Fonctionnalités pilotes → MCP Server
Étape 2 : Générer votre URL MCP Server (et gérer l'accès)
Après avoir accédé à la page MCP Server, vous verrez les options de gestion d'accès :
- Copier l'URL — Copiez votre URL MCP Server et collez-la dans la configuration MCP de votre client IA.
- Actualiser le token — Créez une nouvelle URL si l'actuelle a expiré.
- Révoquer l'autorisation — Bloque immédiatement l'accès IA. Utilisez cette option à tout moment pour couper l'accès de tous les clients IA connectés pour des raisons de confidentialité/sécurité.
Bonne pratique : Si vous suspectez que l'URL a été partagée ou exposée, utilisez « Révoquer l'autorisation », puis générez une nouvelle URL.
Étape 3 : Configurer votre client IA (Exemple : Cursor)
Obtenir Cursor : Téléchargez Cursor et inscrivez-vous ou connectez-vous.
Accéder aux paramètres : Ouvrez Cursor et allez dans Settings → Tools & MCP → Add Custom MCP
Ajouter le serveur : Créez une nouvelle entrée au format JSON suivant :
{
"mcpServers": {
"ewelink": {
"type": "http",
"url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
}
}
}
Enregistrer et redémarrer : Enregistrez la configuration et ouvrez une nouvelle session de chat/agent.
Recommandé : Activez l'option Auto dans la barre d'outils. La prise en charge du MCP peut varier selon les modes d'agent, et Auto aide à sélectionner le plus adapté.
Tester votre configuration
Une fois configuré, essayez ces phrases avec votre assistant IA :
- « Combien d'appareils ai-je ? »
- « Montre-moi quels appareils sont actuellement allumés. »
- « Allume les interrupteurs du salon. »
Notes de compatibilité et limitations actuelles
Il s'agit d'une version initiale, quelques limitations sont donc à prévoir :
- Seuls les appareils compatibles apparaissent dans les résultats de requête.
- Si un appareil n'est pas encore pris en charge, le client IA ne pourra ni le lister ni le contrôler via MCP.
- Les différents modes d'agent IA peuvent se comporter différemment.
- La même commande peut réussir dans un mode et échouer dans un autre. En cas de problème, essayez le mode Auto ou changez de mode.
Appareils actuellement compatibles
La version initiale se concentre sur les interrupteurs et prises, notamment les modèles populaires suivants :
| Type d'appareil | Modèles compatibles (exemples) |
|---|---|
| Prise monocanal | SONOFF BASIC_R3, SONOFF MINI, SONOFF RF_R2, SONOFF S20R1, SONOFF S26, SONOFF S31 Lite, SONOFF S55R1, SONOFF S30 |
| Prise monocanal (compatible 2.4G eWeLink-Remote) | SONOFF BASICR4, SONOFF MINI-D, SONOFF MINIR3, SONOFF MINIR4, SONOFF S40 lite |
| Interrupteur connecté DIY | SONOFF Basic, SONOFF RF, SONOFF SV |
| Interrupteur monocanal | SONOFF RF R2, SONOFF T1 1C, SONOFF Touch, SONOFF TX1C |
| Interrupteur bicanal | SONOFF T1 2C, SONOFF TX2C |
| Interrupteur tricanal | SONOFF T1 3C, SONOFF TX3C |
| Prise quatre canaux | SONOFF 4CH |
| Prise avec mesure de puissance | SONOFF IW100_US, SONOFF IW101_US, SONOFF Pow R2, SONOFF POWR3, SONOFF S31 |
| Prise bicanal | SONOFF DUALR2 |
| Interrupteur connecté avec surveillance température et humidité | SONOFF S22_CN, SONOFF TH10, SONOFF TH16 |
| Prise avec surveillance de puissance et alerte de surcharge | SONOFF S40, SONOFF S40TPA, SONOFF S40TPB |
| POWR3 avec écran LCD | SONOFF POWCT, SONOFF POWR316, SONOFF POWR320D, SONOFF S60TPF, SONOFF S60TPG |
| Interrupteur avec surveillance température et humidité (avec historique) | SONOFF TH16R3, SONOFF THR316, SONOFF THR320 |
| Prise monocanal (version multicanal) | SONOFF Micro |
| Prise quatre canaux (compatible 2.4G eWeLink-Remote) | BL1-S04-01, CK-BL602-4SW-HS |
Dépannage et conseils
- L'URL ne fonctionne pas ? Essayez de générer un nouveau token dans l'application eWeLink.
- Appareils manquants ? Vérifiez si le modèle de votre appareil figure dans la liste des appareils compatibles ci-dessus.
- Les commandes ne s'exécutent pas ? Assurez-vous d'être dans un mode IA compatible (utilisez « Auto »).
- Préoccupation de sécurité ? Utilisez « Révoquer l'autorisation » immédiatement, puis générez une nouvelle URL.
Vous êtes prêt. Activez le MCP Server dans l'application eWeLink, connectez-le à votre client IA et commencez à contrôler vos appareils compatibles avec de simples commandes en langage naturel.
Restez connecté avec eWeLink
Pour suivre les dernières actualités eWeLink et les conseils pour la maison connectée, rejoignez-nous sur nos canaux en ligne :
- Forum : eWeLink Forum
- Facebook : ewelink.support
- X : eWeLinkapp
- YouTube : eWeLink Smart Home
- Site web : ewelink.cc
Fini les devinettes : vos journaux affichent désormais le nom exact des scènes
eWeLink a amélioré les journaux d'opérations pour afficher les noms exacts des scènes sur les appareils compatibles, rendant le dépannage et la vérification instantanés.
V5.22 repousse les limites : plus d'appareils virtuels, plus de plugins thermostat, un partage simplifié
eWeLink V5.22 augmente les limites Prime pour les appareils virtuels, les plugins thermostat et le partage d'appareils, vous offrant plus de flexibilité et moins de compromis.