HA-MCP
홈어시스턴트를 에이전트에 붙이는 비공식 MCP 서버
pip install ha-mcp말로 집 안의 기기를 켜고 끄고, 상태를 물어보고, 자동화를 관리합니다. 권장 설치는 홈어시스턴트 안에서 도는 맞춤 구성 요소입니다. HACS 로 깔면 서버가 프로세스 안에서 돌고, 운영체제와 감독형, 컨테이너, 코어 어느 설치 형태에서도 같은 기능이 나옵니다. 접근 토큰을 따로 관리할 필요가 없다는 것이 이 방식의 장점입니다. 설정 화면이 연결 주소를 알려 주므로 그 주소만 클라이언트에 붙여 넣으면 끝납니다. 원격 클라이언트는 웹훅 주소를, 같은 망 안에서는 직접 주소를 씁니다. 파이썬으로 만들어졌고 별도 실행 경로도 있습니다.
판단
이럴 때 씁니다
- 말로 집 안 기기를 제어하고 싶을 때
- 자동화 설정을 에이전트에게 맡기고 싶을 때
- 기기 상태를 대화로 확인하고 싶을 때
이럴 땐 쓰지 마세요
- 홈어시스턴트를 쓰지 않으면 쓸 데가 없습니다
- 비공식 프로젝트라 공식 지원이 없습니다
- 외부 클라이언트를 붙이면 노출 범위를 직접 관리해야 합니다
차별점
- 홈어시스턴트 안에서 프로세스 그대로 돌아 설치 형태를 가리지 않습니다.
- 접근 토큰 관리 없이 연결 주소만으로 붙습니다.
- 기기 제어와 상태 조회, 서비스 실행, 자동화 관리를 모두 덮습니다.
- 같은 망과 원격 접속을 위한 주소를 각각 제공합니다.
워크플로
- 01HACS 에서 맞춤 구성 요소를 깝니다.
- 02홈어시스턴트를 다시 켭니다.
- 03통합을 추가해 서버를 시작합니다.
- 04설정 화면에서 연결 주소를 복사합니다.
- 05그 주소를 클라이언트에 붙여 넣습니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install ha-mcp | 별도 실행 경로로 설치합니다. |
HACS → Integrations → Custom repositories | 권장 경로입니다. 저장소를 통합 범주로 추가합니다. |
함정
설치 전에 확인하세요
- 권장 설치는 홈어시스턴트 안에서 도는 구성 요소입니다. 이 경로는 접근 토큰을 따로 관리하지 않습니다.
- 7.3.0 에서 설정 파일을 직접 쓰는 기능이 베타로 옮겨졌습니다. 기존 사용법이 깨질 수 있습니다.
- 원격 접속은 웹훅 주소를 씁니다. 역방향 프록시나 클라우드 연결이 앞에 있어야 합니다.
- 비공식 프로젝트입니다. 홈어시스턴트 판이 오르면 대응이 늦을 수 있습니다.
비교
홈어시스턴트를 에이전트에 붙이는 방법은 보통 API 토큰을 만들어 외부 서버를 세우는 것입니다. 이쪽은 안에서 도는 구성 요소라 토큰 관리가 사라지고 설치 형태를 가리지 않습니다. 대신 비공식이라는 위험은 그대로입니다.
최근 변경
홈어시스턴트 2026년 9월 판의 하위 기기와 실제 적용 영역을 지원하도록 고쳤습니다. 홈어시스턴트 안에서 언어 모델 API 스키마 변환이 제대로 되는지 검증하는 작업도 마무리됐습니다.