
homeassistant-ai/ha-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
비공식 그리고 멋진 홈 어시스턴트 MCP 서버
개요
ha_config_set_yaml 베타 버전으로 이동했습니다. AI 비서가 홈 어시스턴트와 상호작용할 수 있도록 하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다. 자연어를 사용하여 스마트 홈 기기를 제어하고, 상태를 조회하며, 서비스를 실행하고 자동화를 관리할 수 있습니다. 손으로 설치하는 걸 선호하시나요? 자세한 경로는 아래에 있습니다. Home Assistant OS를 사용 중인가요? ha-mcp Home Assistant를 실행하세요 — 관리 토큰이 없고, Claude Desktop, Claude.ai, ChatGPT 및 기타 MCP 클라이언트와 호환되며, 로컬 네트워크에 유지되거나 원격 및 HTTP 접근 방식으로 설정할 수 있습니다. 1. 저장소를 Home Assistant 인스턴스에 추가하세요: 만약 이 방법이 App Store에서 저장소 추가(Add repository) 대화 창이 나타나지 않는다면(Home Assistant의 알려진 문제), 수동으로 추가하세요: , 그리고 https://github.com/homeassistant-ai/ha-mcp.를 붙여넣으세요. 2. App Store에서 설치하고 클릭합니다. (Home Assistant 2026.2에서 "Add-ons"가 "Apps"로 이름이 변경되었고, 이전 버전에서는 Add-on Store가 사용됨) 3. 탭을 열어 고유한 MCP URL을 찾습니다 4.
개요(AI 번역)
Breaking Change (v7.3.0):
ha_config_set_yaml가 베타로 이동되었습니다.
비공식적이고 멋진 홈 어시스턴트 MCP 서버
AI 비서가 홈 어시스턴트와 상호작용할 수 있도록 하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다.
자연어를 사용해 스마트 홈 기기를 제어하고, 상태를 조회하며, 서비스를 실행하고, 자동화를 관리하세요.
🚀 시작해
ha-mcp 실행에 권장되는 방법은 HA-MCP 커스텀 컴포넌트입니다. 이 시스템은 HACS를 통해 Home Assistant에 설치되고, 전체 서버를 진행 중로 실행하며, **모든 ** Home Assistant 설치 유형(Home Assistant OS, Supervised, Container, Core)에서 완전한 기능 동등성으로 작동합니다. 모든 경우에 가장 쉬운 설정입니다: 설치 시 관리자 액세스 토큰과 클라이언트가 어떻게 연결할 수 있는지 요구합니다.
HACS(선호 설치)를 통해 Home Assistant에 추가하세요:
빠른 시작:
- HACS에서 HA-MCP 커스텀 컴포넌트를 설치하세요 — 위 배지를 클릭하거나 HACS에서 통합→ ⋮ → 커스텀 저장소를 열고
https://github.com/homeassistant-ai/ha-mcp-integration(카테고리: 통합)을 추가한 후 다운로드. - **Home Assistant 재시작.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Breaking change (v7.3.0):
ha_config_set_yamlhas been moved to beta.

🚀 Get Started
The recommended way to run ha-mcp is the HA-MCP Custom Component. It installs into Home Assistant through HACS, runs the full server in-process, and works on every Home Assistant installation type — Home Assistant OS, Supervised, Container, and Core — with full feature parity. It is the easiest setup in every case: setup asks for an administrator access token and how clients may connect.
Add it to Home Assistant via HACS (the preferred install):
Quick start:
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →