eWeLink MCP Serverチュートリアル:AIでスマートホームを制御
eWeLink MCP Serverのセットアップ、CursorなどのAIクライアントへの接続、自然言語によるスマートホーム制御の手順ガイドです。
eWeLink MCP Server(V5.22、Prime)により、MCP対応のAIクライアントとエージェントをeWeLinkアカウントに接続し、シンプルな自然言語コマンドで対応スマートデバイスを制御できます。Model Context Protocol(MCP)を基盤として、高度なAIアシスタントとIoTデバイスを橋渡しし — 何がオンかを確認し、デバイスステータスをチェックし、会話型インターフェースでアクションをトリガーできます。
このステップバイステップガイドでは、完全なセットアップをカバーします:アプリでのMCP Server有効化、MCP URL生成、Cursorでの接続、簡単なプロンプトでの動作確認。

ステップバイステップセットアップガイド
ステップ1:eWeLinkアプリでMCP Serverを有効化
- eWeLinkアプリを開きます。
- 移動先:プロフィール → パイロット機能 → MCP Server
ステップ2:MCP Server URLを生成(アクセス制御)
MCP Serverページに入ると、アクセス管理オプションが表示されます:
- URLをコピー — MCP Server URLをコピーしてAIクライアントのMCP設定に貼り付けます。
- トークンを更新 — 現在のURLが期限切れの場合、新しいURLを生成します。
- 権限を取り消し — すべてのAIアクセスを即座にブロックします。プライバシー/セキュリティのためにすべての接続済みAIクライアントをシャットオフしたい場合に使用してください。
ベストプラクティス: URLが共有または露出した疑いがある場合、権限を取り消してから新しいURLを生成してください。
ステップ3:AIクライアントを設定(例:Cursor)
Cursorを入手: Cursorをダウンロードし、アカウントにサインアップ/ログインします。

設定にアクセス: Cursorを開き、設定 → Tools & MCP → Add Custom MCPに移動します。

サーバーを追加: 次のJSON形式で新しいエントリーを作成します:
{
"mcpServers": {
"ewelink": {
"type": "http",
"url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
}
}
}
保存して再起動: 設定を保存し、新しいチャット/エージェントセッションを開きます。

推奨: ツールバーでAutoオプションをオンにしてください。MCPサポートはエージェントモードによって異なる場合があり、Autoが最適なモードの選択を支援します。
セットアップのテスト
設定が完了したら、AIアシスタントと次の会話を試してみてください:
- 「デバイスはいくつありますか?」
- 「現在オンになっているデバイスを教えてください。」
- 「リビングのスイッチをオンにしてください。」
互換性に関する注意と現在の制限
初期リリースのため、いくつかの制限があります:
- 対応デバイスのみがデバイスクエリ結果に表示されます。
- まだ対応していないデバイスは、AIクライアントがMCPを通じてリストや制御をしません。
- AIエージェントモードによって動作が異なる場合があります。
- 同じプロンプトがあるモードで成功し、別のモードで失敗することがあります。問題がある場合はAutoモードを試すか、モードを切り替えてください。
現在対応しているデバイス
初期展開はスイッチとプラグに焦点を当てています:
| デバイスタイプ | 対応デバイスモデル(例) |
|---|---|
| Single-Channel Plug | SONOFF BASIC_R3, SONOFF MINI, SONOFF RF_R2, SONOFF S20R1, SONOFF S26, SONOFF S31 Lite, SONOFF S55R1, SONOFF S30 |
| Single-Channel Plug (Support 2.4G eWeLink-Remote) | SONOFF BASICR4, SONOFF MINI-D, SONOFF MINIR3, SONOFF MINIR4, SONOFF S40 lite |
| DIY Smart Switch | SONOFF Basic, SONOFF RF, SONOFF SV |
| Single-Channel Switch | SONOFF RF R2, SONOFF T1 1C, SONOFF Touch, SONOFF TX1C |
| Dual-Channel Switch | SONOFF T1 2C, SONOFF TX2C |
| Three-Channel Switch | SONOFF T1 3C, SONOFF TX3C |
| Four-Channel Plug | SONOFF 4CH |
| Power Detection Plug | SONOFF IW100_US, SONOFF IW101_US, SONOFF Pow R2, SONOFF POWR3, SONOFF S31 |
| Dual-Channel Plug | SONOFF DUALR2 |
| Temp & Humi Monitoring Smart Switch | SONOFF S22_CN, SONOFF TH10, SONOFF TH16 |
| Power Monitoring Plug Overload Alert | SONOFF S40, SONOFF S40TPA, SONOFF S40TPB |
| POWR3 with LCD Screen | SONOFF POWCT, SONOFF POWR316, SONOFF POWR320D, SONOFF S60TPF, SONOFF S60TPG |
| Temperature & Humidity Monitoring Switch (with History) | SONOFF TH16R3, SONOFF THR316, SONOFF THR320 |
| Single-Channel Plug (Multi-channel version) | SONOFF Micro |
| Four-Channel Plug (Support 2.4G eWeLink-Remote) | BL1-S04-01, CK-BL602-4SW-HS |
トラブルシューティングとヒント
- URLが機能しない? eWeLinkアプリで新しいトークンを生成してみてください。
- デバイスが表示されない? デバイスモデルが上記の対応リストにあるか確認してください。
- コマンドが実行されない? 互換性のあるAIモードか確認してください(「Auto」を使用)。
- セキュリティ上の懸念? 即座に「権限を取り消し」を使用してから、新しいURLを生成してください。
準備完了です。eWeLinkアプリでMCP Serverを有効にし、AIクライアントに接続して、シンプルな自然言語コマンドで対応デバイスの制御を始めましょう。
eWeLinkとつながろう
最新のeWeLink情報やスマートホームのヒントは、以下のチャンネルでチェックしてください:
- Forum: eWeLink Forum
- Facebook: ewelink.support
- X: eWeLinkapp
- YouTube: eWeLink Smart Home
- Website: ewelink.cc
eWeLink ドキュメント