클로드 코드로 홈 어시스턴트를 다루는 ha-mcp 연결법

ha-mcp는 홈 어시스턴트를 MCP 서버로 열어 주는 오픈소스다. 클로드 코드에 붙여 두면 기기 상태를 묻고 자동화를 만들거나 고치는 일까지 말로 시킬 수 있다. 9.1.2는 11월 8일에 나왔다.

1. 데모 환경으로 먼저 써 본다. 맥이나 리눅스에서 아래 한 줄을 돌리면 uv를 깔고 클로드 코드에 home-assistant 서버를 사용자 범위로 등록한다. 클로드 유료 요금제가 필요하다.

curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install.sh | sh -s -- --claude-code

claude를 띄워 /mcp로 연결을 확인하고 "Can you see my Home Assistant?"라고 물어본다.

1. 내 홈 어시스턴트에 붙일 때 권장하는 방식은 HA-MCP 통합 구성요소다. 홈 어시스턴트 2026.11 이상은 설정 → Marketplace에서, 2026.8~2026.10은 HACS에서 HA-MCP를 찾아 설치한 뒤 재시작한다.

2. 설정 → 기기 및 서비스 → 통합 추가에서 HA-MCP Server를 고르고 관리자 토큰을 넣는다. 내 계정 토큰을 쓰기보다 HA-MCP 전용 관리자 계정(로컬 접속만 허용)을 따로 만들어 두는 편이 안전하다. 연결 방식은 원격(Secret URL)과 로컬 네트워크 가운데 하나 이상 켜고 저장한다. 연결 주소는 항목의 구성 화면에 있다.

3. 데모 항목은 지우고 내 주소로 다시 등록한다. 같은 서버가 두 항목으로 잡혀 있으면 연결이 멈출 수 있다.

claude mcp remove home-assistant --scope user
claude mcp add --transport http home-assistant <복사한 연결 주소>

도구가 87개쯤 되지만 클로드 코드는 필요한 도구만 그때그때 불러온다. 그래서 ha-mcp 쪽 ENABLE_TOOL_SEARCH는 켜지 않고 쓴다.