Home Assistant MCP Server의 개요
Model Context Protocol Server는 오픈소스 홈 자동화 플랫폼인 Home Assistant에 기본으로 들어 있는 통합입니다. 다음 버전의 문서에서는 반대 방향으로 동작하는 MCP Client 통합과 구분하기 위해 이름을 그냥 Model Context Protocol로 바꿉니다. Home Assistant 2025.2에서 처음 나왔고, Silver 품질 등급을 받았으며, 사용자 인스턴스 안의 /api/mcp 엔드포인트에서 실행됩니다. Home Assistant의 선택형 분석 통계에 따르면, 보고하는 707,952개 설치 중 35,284개, 약 5%에서 쓰입니다.
Assist의 기기 제어 같은 Home Assistant LLM API의 도구를 노출하므로, 모델이 기기를 제어하고 기기 상태에 관한 질문에 답할 수 있습니다. 기본적으로 나중에 추가되는 것을 포함해 모든 LLM API가 노출되며, 관리자 계정이 필요합니다. 기기 제어를 통해 클라이언트는 음성 어시스턴트에 노출된 엔티티만 보고 제어할 수 있습니다. GetLiveContext 도구를 쓸 수 있으면 집의 읽기 전용 스냅샷도 리소스로 제공합니다. 프롬프트, 도구, 리소스는 지원하고 샘플링과 알림은 지원하지 않습니다.
설정하려면 Settings > System > AI에서 MCP를 켜고, 서버 URL을 복사해 클라이언트에 추가한 뒤, OAuth 2.0으로 Home Assistant를 통해 로그인합니다. 문서에는 Claude, ChatGPT, Claude Code, Codex, OpenCode용 절차가 있습니다.
Home Assistant MCP Server 설치 방법
https://<your-home-assistant>/api/mcpHome Assistant MCP Server, 쓸 만한 가치가 있습니까?
Home Assistant 자체의 일부이므로 따로 설치하거나 패치할 것이 없습니다. 이 통합에는 2026년 10월 18일에도 커밋이 있었고, 이때 MCP 라이브러리가 2.3.0으로 올라갔습니다. Home Assistant의 음성 어시스턴트가 쓰는 엔티티 노출 설정을 그대로 쓰기 때문에, Assist가 어떤 기기를 제어해도 되는지에 대한 결정이 Claude나 ChatGPT에 그대로 이어집니다.
로그인은 PKCE와 OAuth 클라이언트 ID 메타데이터 문서를 쓰는 OAuth 2.0이므로, 클라이언트가 스스로 등록하고 클라이언트 시크릿은 필요 없습니다. 기본값은 엇갈립니다. 관리자 계정 요구가 켜져 있어 일반 계정은 들어오지 못하지만, 그 대신 AI가 관리자 권한으로 동작합니다. 나중에 추가되는 API를 포함해 모든 LLM API 노출도 켜져 있습니다. 이 옵션들이 생기기 전에 설치한 경우에는 예전 동작이 유지되어 관리자가 필요하지 않습니다. 10월 12일에 병합되어 다음 릴리스용으로 문서화된 읽기 전용 옵션은 주 엔드포인트를 읽기 전용으로 표시된 도구로 제한합니다. 상태만 확인하는 어시스턴트에 맞는 설정입니다.
진짜 결정은 접근 경로입니다. Claude는 Claude Desktop을 쓸 때도 Anthropic의 클라우드에서 연결하고, 웹의 ChatGPT도 마찬가지이므로, Home Assistant가 인터넷에서 접근 가능해야 합니다. Nabu Casa의 Home Assistant Cloud 구독은 미국 기준 월 $6.50 또는 연 $65이며, 이 문제를 해결하고 문제 해결 섹션의 대부분을 차지하는 리버스 프록시와 issuer URL 문제도 피하게 해 줍니다. Codex나 OpenCode 같은 로컬 클라이언트는 대신 homeassistant.local:8123 같은 LAN 주소를 쓸 수 있지만, Claude Code는 HTTPS를 요구합니다.
범위는 자동화와 설정을 편집할 수 있는 일부 커뮤니티 서버보다 좁습니다. 이 서버는 LLM API가 제공하는 것, 즉 기기 제어, 상태 읽기, 목록 관리를 제공할 뿐 사용자의 설정을 다시 쓰지는 않습니다. RFC 7591 동적 클라이언트 등록을 고집하는 클라이언트는 연결에 실패합니다. Home Assistant는 대신 클라이언트 ID 메타데이터를 쓰기 때문입니다.
제 역할을 하는 곳
이미 Assist에 엔티티 40개를 노출해 쓰는 주택 소유자
자기 전에 차고가 닫혀 있고 난방이 꺼져 있는지 Claude에게 묻기
My MCP URL을 복사해 Claude 맞춤 커넥터로 추가하고 로그인합니다. 월 $6.50의 Home Assistant Cloud로 원격 접속을 제공하면 몇 분이면 됩니다. 읽기 전용 모드가 출시되면 어시스턴트가 아무것도 바꾸지 못하게 할 수 있습니다.
홈 서버에서 Home Assistant를 운영하는 개발자
자동화를 만드는 동안 Codex나 OpenCode가 테스트 기기를 켜고 끄게 하기
codex mcp add로 http://homeassistant.local:8123/api/mcp 를 추가합니다. 트래픽이 LAN 안에 머물러 원격 접속이 필요 없습니다. 잘못된 도구 호출이 현관 도어락에 닿지 않도록 테스트 엔티티 만 노출하십시오.
숙소 3곳을 관리하는 단기 임대 숙소 운영자
손님이 바뀌는 사이에 ChatGPT로 온도 조절기와 도어락 확인하기
숙소마다 Home Assistant에 원격 접속과 별도의 커넥터가 필요합니다. 숙소별로 노출 엔티티를 정리하고 관리자가 아닌 계정도 고려하십시오. 문을 열 수 있는 에이전트는 편의가 아니라 보안의 문제입니다.
도입 전 확인할 점
- 설정
- Settings > System > AI에서 MCP를 켜고, 서버 URL을 복사해(Home Assistant는 My MCP를 권장합니다) 클라이언트에 추가한 뒤 OAuth로 로그인합니다. 클라우드 클라이언트에는 Home Assistant Cloud나 직접 구성한 프록시를 통한 원격 접속도 필요합니다.
- 연동
- 도구는 선택한 LLM API가 제공하는 것이며, 주로 Assist의 기기 제어입니다. 여기에 프롬프트와 homeassistant://assist/context-snapshot 리소스가 더해집니다. /api/mcp 외에 /api/mcp/assist 같은 API별 엔드포인트도 있습니다. 문서화된 클라이언트: Claude, ChatGPT, Claude Code, Codex, OpenCode.
- 데이터와 개인정보
- 클라이언트는 로그인한 사용자의 권한으로 노출된 모 든 엔티티를 읽고 제어할 수 있습니다. 서버는 사용자 인스턴스 안에서 실행되지만, 클라우드 클라이언트를 쓰면 엔티티 이름과 상태가 AI 제공업체를 거칩니다. 할 일 항목처럼 사람이 Home Assistant에 입력한 텍스트는 그대로 모델에 전달됩니다.
- 대규모 사용 시 비용
- Home Assistant와 함께 무료입니다. Nabu Casa를 통한 원격 접속은 미국 기준 월 $6.50 또는 연 $65입니다(영국은 세금 포함 월 £6.50). AI 클라이언트의 구독은 별도입니다.
- 제한
- 샘플링, 알림, RFC 7591 동적 등록이 없습니다. 터널과 프록시 뒤에서 호스트 이름이나 전달 헤더가 맞지 않으면 OAuth 탐색이 깨집니다. 곧 나올 읽기 전용 옵션은 API별 엔드포인트가 아니라 /api/mcp에만 적용됩니다.
좋은 점
- Home Assistant에 포함되어 있어 별도 프로세스가 없습니다
- PKCE를 쓰는 OAuth 2.0이며 클라이언트 시크릿이 없습니다
- Assist 엔티티 노출 설정을 따릅니다
- 다음 릴리스용으로 읽기 전용 토글이 문서화되어 있습니다
아쉬운 점
- Claude Desktop을 포함한 클라우드 클라이언트는 인스턴스가 인터넷에 열려 있어야 합니다
- 기본적으로 관리자 권한으로 모든 LLM API를 노출합니다
- 동적 클라이언트 등록, 샘플링, 알림이 없습니다
추천 대상
Home Assistant 자체 권한 아래에서 Claude나 다른 어시스턴트가 기기를 확인하고 제어하기를 원하는 Home Assistant 사용자입니다.
Home Assistant MCP Server 대안
Home Assistant MCP Server: 자주 묻는 질문
- Home Assistant MCP Server, 쓸 만한 가치가 있습니까?
- Home Assistant에 내장되어 있고 자체 노출 설정을 따르므로, 볼 수 있는 범위를 좁혀 두기만 하면 어시스턴트를 도어락 가까이 두는 가장 안전한 방법입니다. 평점은 5점 만점에 4.3점입니다.
- Home Assistant MCP Server의 가격은 얼마입니까?
- 무료이며 Home Assistant에 포함되어 있습니다(Apache 2.0). 클라우드 기반 클라이언트에는 Home Assistant Cloud나 직접 구성한 원격 접속이 필요합니다.
- Home Assistant MCP Server의 단점은 무엇입니까?
- Claude Desktop을 포함한 클라우드 클라이언트는 인스턴스가 인터넷에 열려 있어야 합니다; 기본적으로 관리자 권한으로 모든 LLM API를 노출합니다; 동적 클라이언트 등록, 샘플링, 알림이 없습니다.
- Home Assistant MCP Server에 적합한 사람은 누구입니까?
- Home Assistant 자체 권한 아래에서 Claude나 다른 어시스턴트가 기기를 확인하고 제어하기를 원하는 Home Assistant 사용자입니다.
- 팀이나 프로덕션 환경에서 Home Assistant MCP Server의 비 용은 얼마입니까?
- Home Assistant와 함께 무료입니다. Nabu Casa를 통한 원격 접속은 미국 기준 월 $6.50 또는 연 $65입니다(영국은 세금 포함 월 £6.50). AI 클라이언트의 구독은 별도입니다.
- Home Assistant MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 클라이언트는 로그인한 사용자의 권한으로 노출된 모든 엔티티를 읽고 제어할 수 있습니다. 서버는 사용자 인스턴스 안에서 실행되지만, 클라우드 클라이언트를 쓰면 엔티티 이름과 상태가 AI 제공업체를 거칩니다. 할 일 항목처럼 사람이 Home Assistant에 입력한 텍스트는 그대로 모델에 전달됩니다.
- Home Assistant MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Google Workspace MCP servers 및 Zapier MCP입니다.
답변 확인일: 2026년 10월 22일.
Home Assistant MCP Server 개발사입니까? 이 평점을 사이트에 표시하십시오
