eWeLink MCP Server 튜토리얼: 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 클라이언트를 차단하고 싶을 때 사용하세요.

3단계: AI 클라이언트 구성 (예: Cursor)

Cursor 다운로드: Cursor를 다운로드하고 계정에 가입/로그인합니다.

설정 접근: Cursor를 열고 설정 → Tools & MCP → Add Custom MCP로 이동합니다.

서버 추가: 다음 JSON 형식으로 새 항목을 생성합니다:

{
  "mcpServers": {
    "ewelink": {
      "type": "http",
      "url": "PASTE_YOUR_eWeLink_MCP_SERVER_URL_HERE"
    }
  }
}

저장 및 재시작: 구성을 저장하고 새 채팅/에이전트 세션을 엽니다.

설정 테스트

구성이 완료되면, AI 어시스턴트와 다음 대화를 시도해 보세요:

• "기기가 몇 개 있나요?"
• "현재 켜져 있는 기기를 보여주세요."
• "거실 스위치를 켜 주세요."

호환성 참고사항 및 현재 제한사항

초기 릴리스이므로 몇 가지 제한이 있습니다:

• 지원 기기만 기기 조회 결과에 표시됩니다.
• 아직 지원되지 않는 기기는 AI 클라이언트가 MCP를 통해 목록에 표시하거나 제어하지 않습니다.
• AI 에이전트 모드에 따라 동작이 다를 수 있습니다.
• 같은 프롬프트가 한 모드에서는 성공하고 다른 모드에서는 실패할 수 있습니다. 문제가 있으면 Auto 모드를 시도하거나 모드를 전환하세요.

현재 지원 기기

초기 배포는 스위치와 플러그에 집중합니다:

문제 해결 및 팁

• 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