스마트홈을 운영하면서 AI와의 연동이 점점 중요해지고 있습니다. 이번 글에서는 Home Assistant에 MCP(Model Context Protocol) 서버를 연동하는 방법을 정리해 보았습니다.
HA에 MCP 서버를 설치하고 클로드 데스크탑에서 채팅을 통해 노출된 기기나 스크립트 등을 제어할 수 있습니다.
1. MCP 서버란?
MCP(Model Context Protocol) 서버는 AI 기반 컨텍스트 관리와 명령 전달을 위한 프로토콜 서버입니다. 이를 Home Assistant와 연동하면 더 정교한 자동화와 지능형 서비스가 가능해집니다.
공식 문서 참고: Home Assistant MCP Server 통합 가이드
Model Context Protocol Server
Instructions on how to add a Model Context Protocol Server to Home Assistant.
www.home-assistant.io
2. Home Assistant에 MCP 서버 통합하기
2-1. 통합구성요소 생성
Home Assistant에서 MCP 서버를 인식하고 데이터를 주고받기 위해 통합구성요소를 등록합니다. UI를 통해 설정하거나 수동으로 등록할 수 있습니다.
또는 수동으로 등록
2-2. MCP 용 장기 엑세스 토큰 생성
서버와 안전하게 통신하기 위해 장기 엑세스 토큰(Long-lived Access Token) 을 생성해야 합니다.
이 토큰은 클라이언트에서(Claude, Cursor 등) MCP 서버 설정 시 인증 수단으로 사용합니다.
3. 클로드 데스크탑(Claude Desktop) 연동
MCP 서버를 통해 클로드 테스크탑에서 Home Assistant를 연동하는 경우, 약간의 세팅이 필요합니다.
공식 문서 참고 : https://www.home-assistant.io/integrations/mcp_server/#example-claude-for-desktop
Model Context Protocol Server
Instructions on how to add a Model Context Protocol Server to Home Assistant.
www.home-assistant.io
클로드 데스크탑 설정에서 개발자 탭의 설정 편집을 통해 연결할 MCP 서버를 설정해줍니다.
mcp-proxy 설치가 필요하며 자세한 내용은 공식 문서를 참고해주세요.
{
"mcpServers": {
"Home Assistant": {
"command": "mcp-proxy",
"env": {
"SSE_URL": "http://localhost:8123/mcp_server/sse",
"API_ACCESS_TOKEN": "<your_access_token_here>"
}
}
}
}
4. AI 기능 활용
다양한 MCP 클라이언트에서 HA의 장치들을 제어할 수 있게 됩니다. 여기서는 클로드 데스크탑으로 진행하겠습니다.
3번 설정을 마치면 클로드 테스크탑에서 MCP 도구에 HA 목록이 뜨는 것을 확인할 수 있습니다.
접근 권한을 매번 확인할 수도 있고, 신뢰할 수 있는 경우 항상 허용을 할 수 있습니다.
처음에 간접조명을 제대로 못찾았지만 알아서 확인하고 다시 기기를 제어하는 모습도 볼 수 있었습니다.
장치를 제어할 때 응답 결과도 확인 가능합니다.
마무리
MCP 서버를 통해 Home Assistant와 AI를 연결하면, 더욱 똑똑한 스마트홈 환경을 만들 수 있습니다. 단순한 자동화를 넘어, 상황에 맞는 맞춤형 응답과 제어가 가능해지는 만큼, MCP 연동은 강력한 도구가 될 것입니다.
지금은 클로드 테스크탑을 통해 채팅으로 테스트 해보았지만 음성 장치들을 통해서 손쉽게 활용할 수 있는 날이 곧 올거라 예상합니다. 지금도 불가능한 것은 아닙니다만 일반 사용자가 쉽게 설정할 수 있느냐 아니냐가 중요한 변곡적이 될 것 같습니다.
구글은 2025년 하반기부터 기존 구글 어시스턴트(Assistant)를 AI 기반의 차세대 비서인 제미나이(Gemini)로 전면 대체할 계획을 공식 발표했습니다. 아쉽게도 구글 홈 미니(1세대)는 제외된 상태입니다.
구글 어시스턴트의 부족한 음성 인식 부분은 많이 개선이 될 것 같고, HA와 연동하는 부분도 많이 쉬워질 거라 기대하고 있습니다.
감사합니다.
번외
Home Assistant MCP vs MCP Server Integration 차이
Home Assistant에서 제공하는 `mcp`와 `mcp_server` 두 컴포넌트는 모두 Model Context Protocol(MCP)을 활용하지만, 역할과 사용 목적이 완전히 다릅니다.
주요 차이점
| 구분 | mcp (Model Context Protocol) | mcp_server (Model Context Protocol Server) |
| Home Assistant 역할 | 클라이언트 (Client) | 서버 (Server) |
| 연결 대상 | 외부 MCP 서버 (예: 웹검색, 메모리 등) | 외부 MCP 클라이언트(예: Claude, Cursor 등) |
| 목적 | 외부 MCP 서버의 기능을 Home Assistant에 추가 | Home Assistant의 기능을 외부 LLM 앱에 제공 |
| 주요 사용 예시 | Home Assistant가 외부 MCP 서버의 툴 사용 | Claude Desktop에서 Home Assistant 제어 |
| 지원 기능 | Tools(도구) | Tools(도구), Prompts(프롬프트) |
| 한계 | Prompts 미지원 등 | 일부 MCP 기능 미지원 |
| 접근 방식 | Home Assistant가 MCP 서버에 접속 | 외부 앱이 Home Assistant에 접속 |
외부 MCP 서버의 기능을 Home Assistant에서 쓰고 싶으면 → `mcp` 사용
Home Assistant의 기능을 외부 LLM 앱(Claude, Cursor 등)에서 쓰고 싶으면 → `mcp_server` 사용