자연어로 홈 어시스턴트의 자동화와 대시보드를 만들고 고치는 AI 연결 서버
“현관등 자동화를 만들어줘”라고 말하면, AI가 트리거와 액션을 갖춘 자동화 규칙을 실제로 생성합니다. 홈 어시스턴트 설정 파일을 읽고 수정하며, 대시보드를 다듬고, 오류가 난 자동화의 실행 기록을 분석해 고쳐주는 서버입니다. 복잡한 YAML 문법을 외우지 않아도 자연어로 스마트 홈을 설계하고 관리할 수 있는 환경을 제공합니다.
v7.3.0 변경 사항과 권장 설치 경로
최근 v7.3.0 버전에서 ha_config_set_yaml 도구가 베타 단계로 이동했습니다. 가장 권장되는 설치 방법은 HACS나 홈 어시스턴트 마켓플레이스를 통해 HA-MCP 통합 기능을 설치하는 것입니다. 이 방식은 홈 어시스턴트 OS, Supervised, Container, Core 등 모든 설치 유형에서 동일한 기능을 제공하며, 별도 앱이나 Docker 컨테이너를 실행할 필요가 없습니다. 설치 후 관리자 액세스 토큰을 입력하고 클라이언트 연결 방식을 선택하면 서버가 홈 어시스턴트 내부에서 바로 구동됩니다. 기존에 다른 방법으로 설치했다면, 이 통합 기능으로 전환하여 단일 인스턴스만 유지하는 것이 좋습니다.
내장 MCP 서버와의 역할 구분
홈 어시스턴트에 내장된 MCP 서버는 Assist 파이프라인 기반으로, 이미 노출된 엔티티의 상태 조회와 제어에 초점을 맞춥니다. 반면 이 저장소는 스마트 홈의 구조를 만들고 유지보수하는 데 특화되어 있습니다. 자동화, 스크립트, 씬, 대시보드 생성과 편집이 가능하며, 헬퍼, 영역, 구역, 라벨, 그룹 관리도 지원합니다. 자동화 실행 트레이스를 분석해 문제를 진단하고, 히스토리와 로그를 읽어 디버깅하는 기능도 내장되어 있습니다. 또한 백업, 앱 관리, HACS, 디바이스 및 엔티티 레지스트리 관리까지 커버하여, 단순 제어 도구를 넘어 시스템 전체를 관리하는 도구로 사용할 수 있습니다.
파일 시스템 접근과 YAML 편집 도구
표준 API로는 접근이 어려운 파일 시스템과 YAML 설정 편집을 위한 특권 도구를 제공합니다. ha_config_set_yaml을 사용하면 configuration.yaml의 최상위 키를 안전하게 추가, 교체, 삭제할 수 있으며, 이 과정에서는 자동 백업과 검증이 수행됩니다. 파일 목록 조회, 읽기, 쓰기, 삭제 도구도 포함되어 있어 설정 파일이나 로그를 직접 다룰 수 있습니다. 이 기능들은 기본적으로 꺼져 있으며, 활성화하려면 베타 기능 플래그를 켜야 합니다. 홈 어시스턴트 2026.8.0 이상에서 HACS나 마켓플레이스를 통해 HA-MCP File & YAML Tools 항목을 추가해야 이 도구들이 사용 가능합니다.
에이전트 스킬과 도구 탐색 최적화
AI 에이전트가 홈 어시스턴트 모범 사례를 이해하도록 돕는 도메인 지식인 Agent Skills를 함께 제공합니다. MCP 서버만으로는 자동화 구조나 헬퍼 선택에 대한 판단이 부족할 수 있는데, 이 스킬들은 네이티브 구성 요소를 우선하고 안전한 리팩토링 워크플로우를 안내합니다. 스킬은 skill:// URI를 통해 MCP 리소스로 제공되어, 리소스를 지원하는 클라이언트는 자동으로 발견할 수 있습니다. 도구만 지원하는 클라이언트를 위해서는 ha_get_skill_guide 도구를 통해 스킬 가이드를 읽을 수 있으며, 이 도구는 항상 사용 가능하도록 고정되어 있습니다. 또한 전체 도구 카탈로그가 약 87개에 달해 작은 모델이나 로컬 LLM은 컨텍스트 윈도우를 초과할 수 있으므로, ENABLE_TOOL_SEARCH=true로 설정하면 BM25 검색 기반의 도구 탐색 모드를 통해 필요한 도구만 가져오도록 할 수 있습니다.
사용 전 확인해야 할 보안과 호환성
이 도구는 홈 어시스턴트 2026.8.0 이상을 요구하며, HACS나 마켓플레이스 접근이 가능한 환경에서 가장 쉽게 설치됩니다. 관리자 권한이 있는 액세스 토큰을 사용하므로, 보안이 우려된다면 HA-MCP 전용 계정을 만들어 로컬 접근만 허용하는 방식으로 설정하는 것이 안전합니다. 원격 접근을 활성화하면 웹훅 URL이 생성되므로, 공개 네트워크에 노출되는 것을 원하지 않으면 로컬 네트워크 접근만 사용하도록 설정해야 합니다. stdio 전송 방식은 연결 문제의 가능성이 있어, 실제 사용보다는 데모나 테스트 용도로만 권장됩니다.
