Aqara MCP Server의 개요
Aqara MCP Server는 스마트홈 제조사 Aqara의 AI 계층인 Aqara Agent가 운영하는 원격 서비스로, https://agent.aqara.com/open/mcp에 Streamable HTTP로 연결합니다. Aqara 계정으로 로그인한 뒤 로그인 페이지의 API 키를 복사해 bearer 토큰으로 넘깁니다. 도구 20개가 집과 방, 기기 상태와 제어, 방과 유형별 일괄 제어, 기기 로그, 장면, 자동화(읽기 전용), 전력 사용량과 요금, 조명 효과, 펌웨어 확인과 업데이트를 다룹니다.
Aqara는 2026년 5월 22일 원래의 로컬 stdio 서버를 이 호스팅 서버로 대체하고 이전 버전의 업데이트를 중단했습니다. MIT 라이선스의 GitHub 저장소(별 약 49개)에는 이제 서버 코드 대신 8개 언어로 된 문서가 있으며, 2026년 9월 17일의 마지막 커밋에서 원격 통합용으로 다시 작성되었습니다.
Aqara MCP Server 설치 방법
https://agent.aqara.com/open/mcpAqara MCP Server, 쓸 만한 가치가 있습니까?
설정은 원격 MCP 가운데 가장 짧은 편입니다. agent.aqara.com에 로그인해 aqara_api_key를 복사하고, Cursor나 Codex 같은 Streamable HTTP 클라이언트에 URL 하나와 Authorization 헤더를 추가한 뒤 재시작하면 됩니다. 도구 20개는 자연스러운 요청에 맞게 설계되었습니다. fuzzy_device_batch_control은 방과 기기 유형을 받아 해당하는 모든 기기에 작용하므로, 거실 전부 끄기나 에어컨 전부 26도로 맞추기가 호출 한 번이면 됩니다. energy_consumption_inquiry_for_device는 사용량이나 요금을 30분부터 한 달까지의 단위로 돌려주어 월별 요금 점검에 알맞습니다.
위험도 같은 도구에 있습니다. 방 목록을 비운 일괄 제어는 집 전체를 뜻할 수 있고, scene_run은 장면에 담긴 동작을 그대로 실행하며, device_firmware_upgrade는 조건에 맞는 기기에서 업데이트를 시작합니다. README도 무엇이든 제어하기 전에 먼저 조회 도구로 ID를 확인하라고 권합니다. 기기 유형에는 Camera가 포함되고, 문서화된 속성은 전원, 온도, 커튼, 음량에 이릅니다. README는 권한 범위를 설명하지 않으므로 키는 계정 전체에 대한 제어권으로 다뤄야 합니다.
호스팅 서비스로의 전환은 로컬 제어를 내주고 유지 관리의 편의를 얻는 선택입니다. 이제 명령은 클라이언트에서 Aqara Agent를 거쳐 Aqara 클라우드로 가고 로컬 선택지는 없으므로, 장애나 만료된 키 하나로 모든 것이 멈춥니다. Aqara 로그인 페이지에는 요금, 개인정보 처리방침, 키 만료 정보가 없고 포럼 공지도 이를 보태지 않습니다. 자동화는 목록과 실행 기록을 볼 수는 있지만 만들거나 편집할 수는 없습니다. Aqara는 skills를 지원하는 클라이언트에는 MCP보다 Agent Skills 패키지를 권장합니다.
여러 브랜드가 섞인 집이라면 Home Assistant 서버가 훨씬 많은 기기에 닿고 제어도 로컬에 둘 수 있습니다. 이 서버는 집의 대부분이 Aqara이고 클라우드 경로를 받아들일 수 있을 때 의미가 있습니다.
제 역할을 하는 곳
두 층에 Aqara 기기 30대를 둔 집주인
지난달 전기 요금을 끌어올린 방 찾기
energy_consumption_inquiry_for_position을 월 단위로 요금까지 포함해 조회한 뒤 가장 비싼 방을 기기별로 살펴봅니다. 사용은 무료이며 수치는 전력을 보고하는 기기에 따라 달라집니다.
단기 임대 숙소를 관리하는 임대인
손님이 바뀌는 사이 모든 기기가 온라인이고 펌웨어가 최신인지 확인
집 전체에 대해 device_firmware_inquiry를 호출해 온라인 상태와 사용 가능한 버전을 확인하고, 기기 목록을 확인한 뒤에만 업데이트를 시작합니다. 손님이 머무는 동안에는 업데이트를 피합니다.
도입 전 확인할 점
- 설정
- agent.aqara.com/login에 로그인해 aqara_api_key를 복사하고 https://agent.aqara.com/open/mcp를 Authorization: Bearer 헤더가 있는 Streamable HTTP 서버로 추가합니다. Codex에서는 토큰을 붙여 넣지 말고 환경 변수 이름을 지정합니다.
- 연동
- 도구 20개: 집과 방, 기기 조회와 제어, 일괄 제어, 기기 로그, 장면, 자동화 기록, 방 또는 기기별 전력, 조명 효과, 펌웨어. skills를 지원하는 클라이언트용으로 같은 범위의 Aqara Agent Skills가 있습니다.
- 데이터와 개인정보
- 모든 명령과 집 데이터는 Lumi United Technology가 운영하는 Aqara Agent와 Aqara 클라우드를 거칩니다. 보관 기간, 학습 이용, 지역별 처리는 Aqara Agent 페이지에 공개되어 있지 않습니다.
- 제한
- 읽기 전용 모드나 도구별 범위는 설명되어 있지 않고, 자동화는 만들거나 편집할 수 없습니다. 키 만료는 문서화되지 않았지만 README는 연결 실패 시 확인할 항목으로 만료된 자격 증명을 꼽습니다.
좋은 점
- 공식 호스팅 서버로 URL과 키 하나면 끝
- 방과 기기 유형별 일괄 제어
- 30분 단위까지의 전력 사용량과 요금
- 채팅에서 펌웨어 상태 확인과 업데이트
아쉬운 점
- 2026년 5월부터 클라우드 전용, 로컬 모드 없음
- 권한 범위 설명이 없어 키를 전권으로 다뤄야 함
- 개인정보, 요금, 키 만료 조건 비공개
- 자동화는 읽기 전용
추천 대상
집의 대부분이 Aqara이고 Cursor나 Codex에서 상태 확인, 장면 실행, 전력 점검을 하고 싶으며 Aqara 클라우드를 거쳐 명령을 보내는 것을 받아들일 수 있는 사람.
Aqara MCP Server 대안
Aqara MCP Server: 자주 묻는 질문
- Aqara MCP Server, 쓸 만한 가치가 있습니까?
- 에이전트에서 Aqara 집으로 가는 문서대로 동작하는 간단한 클라우드 경로이지만, 뒤에 있는 서비스의 개인정보 조건이 공개되지 않은 채 AI에 실제 기기의 일괄 제어를 맡깁니다. 평점은 5점 만점에 3.5점입니다.
- Aqara MCP Server의 가격은 얼마입니까?
- 공개된 요금은 없습니다. Aqara 계정과 Aqara 기기가 필요합니다.
- Aqara MCP Server의 단점은 무엇입니까?
- 2026년 5월부터 클라우드 전용, 로컬 모드 없음; 권한 범위 설명이 없어 키를 전권으로 다뤄야 함; 개인정보, 요금, 키 만료 조건 비공개; 자동화는 읽기 전용.
- Aqara MCP Server에 적합한 사람은 누구입니까?
- 집의 대부분이 Aqara이고 Cursor나 Codex에서 상태 확인, 장면 실행, 전력 점검을 하고 싶으며 Aqara 클라우드를 거쳐 명령을 보내는 것을 받아들일 수 있는 사람.
- Aqara MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 모든 명령과 집 데이터는 Lumi United Technology가 운영하는 Aqara Agent와 Aqara 클라우드를 거칩니다. 보관 기간, 학습 이용, 지역별 처리는 Aqara Agent 페이지에 공개되어 있지 않습니다.
- Aqara MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Home Assistant MCP Server입니다.
답변 확인일: 2026년 11월 6일.