eWeLink DocsTutorial do eWeLink MCP Server: Controle sua Casa Inteligente com IA
Um guia passo a passo para configurar o eWeLink MCP Server, conecta-lo a clientes de IA como o Cursor e controlar sua casa inteligente com linguagem natural.
Com o eWeLink MCP Server (V5.22, Prime), voce pode conectar clientes e agentes de IA compativeis com MCP a sua conta eWeLink e controlar dispositivos inteligentes suportados com comandos simples em linguagem natural. Construido sobre o Model Context Protocol (MCP), ele conecta assistentes de IA avancados aos seus dispositivos IoT — permitindo que voce consulte o que esta ligado, verifique o status dos dispositivos e acione acoes atraves de uma interface conversacional.
Este guia passo a passo cobre toda a configuracao: ativar o MCP Server no aplicativo, gerar sua URL MCP, conecta-lo no Cursor e executar alguns comandos simples para confirmar que esta funcionando.
Guia de Configuracao Passo a Passo
Passo 1: Ative o MCP Server no eWeLink App
- Abra o eWeLink app.
- Va para: Perfil → Recursos Piloto → MCP Server
Passo 2: Gere sua URL do MCP Server (e Controle o Acesso)
Ao entrar na pagina do MCP Server, voce vera opcoes de gerenciamento de acesso:
- Copiar URL — Copie a URL do MCP server e cole na configuracao MCP do seu cliente de IA.
- Atualizar Token — Crie uma nova URL se a atual expirar.
- Revogar Autorizacao — Bloqueie imediatamente o acesso da IA. Use sempre que quiser desconectar todos os clientes de IA por questoes de privacidade/seguranca.
Boa pratica: Se suspeitar que a URL foi compartilhada ou exposta, use Revogar Autorizacao e gere uma nova URL.
Passo 3: Configure seu Cliente de IA (Exemplo: Cursor)
Obtenha o Cursor: Baixe o Cursor e cadastre-se/faca login na sua conta.
Acesse as Configuracoes: Abra o Cursor e va para Settings → Tools & MCP → Add Custom MCP
Adicione o Servidor: Crie uma nova entrada com este formato JSON:
{
"mcpServers": {
"ewelink": {
"type": "http",
"url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
}
}
}
Salve e Reinicie: Salve sua configuracao e abra uma nova sessao de chat/agente.
Recomendado: Ative a opcao Auto na barra de ferramentas. O suporte MCP pode variar entre os modos de agente, e o Auto ajuda a selecionar o mais adequado.
Testando sua Configuracao
Apos a configuracao, experimente estas frases iniciais com seu assistente de IA:
- "Quantos dispositivos eu tenho?"
- "Mostre quais dispositivos estao ligados no momento."
- "Ligue os interruptores da sala de estar."
Notas de Compatibilidade e Limitacoes Atuais
Este e um lancamento inicial, entao espere algumas restricoes:
- Apenas dispositivos suportados aparecem nos resultados de consulta.
- Se um dispositivo ainda nao for suportado, o cliente de IA nao o listara nem o controlara via MCP.
- Diferentes modos de agente de IA podem se comportar de maneiras diferentes.
- O mesmo comando pode funcionar em um modo e falhar em outro. Se tiver problemas, tente o modo Auto ou troque de modo.
Dispositivos Suportados Atualmente
O lancamento inicial foca em interruptores e tomadas, incluindo modelos populares como:
| Tipo de Dispositivo | Modelos de Dispositivos Elegiveis (Exemplos) |
|---|---|
| Tomada de Canal Unico | SONOFF BASIC_R3, SONOFF MINI, SONOFF RF_R2, SONOFF S20R1, SONOFF S26, SONOFF S31 Lite, SONOFF S55R1, SONOFF S30 |
| Tomada de Canal Unico (Suporte 2.4G eWeLink-Remote) | SONOFF BASICR4, SONOFF MINI-D, SONOFF MINIR3, SONOFF MINIR4, SONOFF S40 lite |
| Interruptor Smart DIY | SONOFF Basic, SONOFF RF, SONOFF SV |
| Interruptor de Canal Unico | SONOFF RF R2, SONOFF T1 1C, SONOFF Touch, SONOFF TX1C |
| Interruptor de Dois Canais | SONOFF T1 2C, SONOFF TX2C |
| Interruptor de Tres Canais | SONOFF T1 3C, SONOFF TX3C |
| Tomada de Quatro Canais | SONOFF 4CH |
| Tomada com Deteccao de Energia | SONOFF IW100_US, SONOFF IW101_US, SONOFF Pow R2, SONOFF POWR3, SONOFF S31 |
| Tomada de Dois Canais | SONOFF DUALR2 |
| Interruptor Smart com Monitoramento de Temp. e Umidade | SONOFF S22_CN, SONOFF TH10, SONOFF TH16 |
| Tomada com Monitoramento de Energia e Alerta de Sobrecarga | SONOFF S40, SONOFF S40TPA, SONOFF S40TPB |
| POWR3 com Tela LCD | SONOFF POWCT, SONOFF POWR316, SONOFF POWR320D, SONOFF S60TPF, SONOFF S60TPG |
| Interruptor de Monitoramento de Temperatura e Umidade (com Historico) | SONOFF TH16R3, SONOFF THR316, SONOFF THR320 |
| Tomada de Canal Unico (versao multicanal) | SONOFF Micro |
| Tomada de Quatro Canais (Suporte 2.4G eWeLink-Remote) | BL1-S04-01, CK-BL602-4SW-HS |
Solucao de Problemas e Dicas
- URL nao funciona? Tente gerar um novo token no eWeLink app.
- Dispositivos ausentes? Verifique se o modelo do seu dispositivo esta na lista de suportados acima.
- Comandos nao executam? Certifique-se de estar em um modo de IA compativel (use "Auto").
- Preocupacao com seguranca? Use "Revogar Autorizacao" imediatamente e gere uma nova URL.
Tudo pronto. Ative o MCP Server no eWeLink app, conecte-o ao seu cliente de IA e comece a controlar dispositivos suportados com comandos simples em linguagem natural.
Fique Conectado com o eWeLink
Para se manter atualizado sobre os ultimos desenvolvimentos do eWeLink e dicas de casa inteligente, conecte-se conosco atraves dos nossos canais online:
- Forum: eWeLink Forum
- Facebook: ewelink.support
- X: eWeLinkapp
- YouTube: eWeLink Smart Home
- Site: ewelink.cc
Chega de suposições: os registros de operações agora mostram o nome exato da cena
A eWeLink aprimorou os registros de operações para exibir os nomes exatos das cenas em dispositivos compatíveis, tornando a verificação e a solução de problemas instantâneas.
V5.22 Eleva os Limites: Mais Dispositivos Virtuais, Mais Plugins de Termostato, Compartilhamento mais Facil
eWeLink V5.22 eleva os limites Prime para Dispositivos Virtuais, Plugins de Termostato e Compartilhamento de Dispositivos, proporcionando mais flexibilidade e menos compromissos.