Документация eWeLinkРуководство по eWeLink MCP Server: Управляйте умным домом с помощью ИИ
Пошаговое руководство по настройке eWeLink MCP Server, подключению к ИИ-клиентам вроде Cursor и управлению умным домом с помощью естественного языка.
С eWeLink MCP Server (V5.22, Prime) вы можете подключать совместимые с MCP ИИ-клиенты и агенты к вашей учетной записи eWeLink и управлять поддерживаемыми умными устройствами простыми командами на естественном языке. Построенный на основе Model Context Protocol (MCP), он связывает продвинутых ИИ-ассистентов с вашими IoT-устройствами — позволяя узнавать, что включено, проверять статус устройств и запускать действия через разговорный интерфейс.
Это пошаговое руководство охватывает полную настройку: включение MCP Server в приложении, генерацию URL MCP, подключение в Cursor и выполнение нескольких простых запросов для проверки работоспособности.
Пошаговое руководство по настройке
Шаг 1: Включите MCP Server в eWeLink App
- Откройте eWeLink app.
- Перейдите: Профиль → Пилотные функции → MCP Server
Шаг 2: Сгенерируйте URL MCP Server (и управляйте доступом)
На странице MCP Server вы увидите опции управления доступом:
- Копировать URL — Скопируйте URL MCP server и вставьте его в настройки MCP вашего ИИ-клиента.
- Обновить токен — Создайте новый URL, если текущий истёк.
- Отозвать авторизацию — Немедленно заблокируйте доступ ИИ. Используйте в любой момент, когда хотите отключить все подключённые ИИ-клиенты для обеспечения конфиденциальности/безопасности.
Рекомендация: Если вы подозреваете, что URL был передан или раскрыт, используйте «Отозвать авторизацию», затем сгенерируйте новый URL.
Шаг 3: Настройте ваш ИИ-клиент (Пример: 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 помогает выбрать наиболее подходящий.
Проверка настройки
После настройки попробуйте эти фразы для общения с вашим ИИ-ассистентом:
- «Сколько у меня устройств?»
- «Покажи, какие устройства сейчас включены.»
- «Включи выключатели в гостиной.»
Заметки о совместимости и текущие ограничения
Это начальный выпуск, поэтому ожидайте некоторые ограничения:
- Только поддерживаемые устройства отображаются в результатах запросов.
- Если устройство ещё не поддерживается, ИИ-клиент не отобразит его и не сможет управлять им через MCP.
- Разные режимы ИИ-агентов могут вести себя по-разному.
- Один и тот же запрос может работать в одном режиме и не работать в другом. При возникновении проблем попробуйте режим 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 |
| POWR3 с LCD-экраном | 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.
- Устройства отсутствуют? Проверьте, есть ли модель вашего устройства в списке поддерживаемых выше.
- Команды не выполняются? Убедитесь, что вы используете совместимый режим ИИ (используйте «Auto»).
- Беспокоитесь о безопасности? Немедленно используйте «Отозвать авторизацию», затем сгенерируйте новый URL.
Всё готово. Включите MCP Server в eWeLink app, подключите его к вашему ИИ-клиенту и начните управлять поддерживаемыми устройствами простыми командами на естественном языке.
Оставайтесь на связи с eWeLink
Чтобы быть в курсе последних новостей eWeLink и советов по умному дому, присоединяйтесь к нам через наши онлайн-каналы:
- Форум: eWeLink Forum
- Facebook: ewelink.support
- X: eWeLinkapp
- YouTube: eWeLink Smart Home
- Сайт: ewelink.cc
Больше никаких догадок: журналы операций теперь показывают точные названия сцен
eWeLink обновил журналы операций — для поддерживаемых устройств теперь отображаются точные названия сцен, что делает проверку и устранение неполадок мгновенными.
V5.22 повышает лимиты: Больше виртуальных устройств, больше плагинов термостата, удобнее совместный доступ
eWeLink V5.22 повышает лимиты Prime для виртуальных устройств, плагинов термостата и совместного доступа к устройствам, предоставляя больше гибкости и меньше ограничений.