Bỏ qua tới nội dung
Ông T.vn

ha-mcp: điều khiển Home Assistant bằng Claude, ChatGPT — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

Bài này là một góc nhìn khác về homeassistant-ai/ha-mcp — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: ha-mcp: điều khiển Home Assistant bằng Claude, ChatGPT — hướng dẫn cài đặt và dùng →

ha-mcp: điều khiển Home Assistant bằng Claude, ChatGPT — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

ha-mcp là một MCP server (giấy phép MIT) giúp trợ lý AI như Claude, ChatGPT nói chuyện với Home Assistant: tìm thiết bị, điều khiển, tạo automation, sửa dashboard, kiểm tra lỗi. Cách cài khuyến nghị là một integration cài qua HACS hoặc Marketplace trong Home Assistant, khá gọn nếu bạn đã quen vào Settings. Repo còn có bản demo để thử mà không cần nối nhà thật.

ha-mcp là một MCP server cho Home Assistant. Nói đơn giản: nó là cầu nối để các trợ lý AI như Claude, ChatGPT hay công cụ khác biết đọc và chỉnh hệ thống nhà thông minh của bạn. Thay vì tự gõ YAML cho automation, bạn chỉ cần nói: “Tạo automation bật đèn hiên khi trời tối”.

Repo dành cho ai đang dùng Home Assistant và thấy việc cấu hình automation, script, dashboard hơi mệt. Người mới cũng dùng được, vì AI lo phần kỹ thuật, bạn chỉ cần mô tả điều mình muốn. Hiện repo có khoảng 7687 sao và 466 fork, giấy phép MIT, viết bằng Python và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất: cách cài khuyến nghị chạy ngay trong Home Assistant, ở mọi kiểu cài (Home Assistant OS, Supervised, Container, Core). Ngoài ra repo có bản demo một lệnh, để bạn thử với môi trường mẫu trước khi nối nhà thật của mình.

MCP server

homeassistant-ai/ha-mcp

ha-mcp cho Claude, ChatGPT và các trợ lý AI khác đọc, tạo và sửa automation, script, dashboard trong Home Assistant bằng câu nói tự nhiên.

★ 7.7kPythonMIT
Xem repo trên GitHub

I.ha-mcp làm được gì

Theo README, các khả năng chính chia thành mấy nhóm. Mình giải thích theo lợi ích thực tế.

A.Tìm kiếm

Tìm thiết bị (entity) theo kiểu “mờ”, tìm sâu trong cấu hình và xem tổng quan hệ thống. Bạn không cần nhớ chính xác tên entity, chỉ cần nói gần đúng là AI tìm ra.

B.Điều khiển

Gọi bất kỳ service nào, điều khiển nhiều thiết bị một lúc, xem trạng thái theo thời gian thực. Ví dụ bật tắt hàng loạt đèn trong một khu vực.

C.Quản lý cấu hình

Automation, script, helper, dashboard, khu vực (area), zone, nhóm, lịch, blueprint. Đây là phần tiết kiệm thời gian nhất: AI đọc automation cũ, thêm hành động mới rồi lưu lại.

D.Theo dõi và gỡ lỗi

Xem lịch sử, thống kê, ảnh chụp từ camera, trace (dấu vết chạy) của automation và thiết bị ZHA. Khi một automation “không chịu chạy”, AI có thể phân tích trace để tìm nguyên nhân.

E.Hệ thống

Sao lưu và khôi phục, cập nhật, quản lý app (add-on), device registry.

F.An toàn

Có chế độ Read Only (chỉ đọc), bật tắt từng công cụ, chính sách bảo mật cho từng công cụ (yêu cầu người dùng duyệt) và tự động sao lưu trước khi sửa. Ngoài ra, khi cài theo kiểu integration, trong thanh bên của Home Assistant có thêm bảng HA-MCP dành cho admin để quản lý công cụ, feature flag, backup và giao diện.

II.Cần chuẩn bị gì

  • Một hệ thống Home Assistant đang chạy. Cách khuyến nghị yêu cầu Home Assistant 2026.8.0 trở lên.
  • Quyền quản trị (Administrator) trong Home Assistant, vì server cần một tài khoản admin hoặc token của admin để hoạt động.
  • Một trợ lý AI hỗ trợ MCP: Claude Desktop, Claude Code, ChatGPT, Gemini CLI, Open WebUI, VSCode, Cursor… README nói Setup Wizard hỗ trợ hơn 15 ứng dụng khách (client).
  • HACS nếu Home Assistant của bạn ở bản 2026.8–2026.10. Từ bản 2026.11 trở lên thì dùng Marketplace có sẵn.
  • Nếu chạy bằng PyPI/uvx: gói ha-mcp yêu cầu Python 3.14 (pyproject.toml ghi >=3.14,<3.15).
  • Muốn dùng từ xa: Nabu Casa hoặc một reverse proxy đã trỏ tới Home Assistant. README chưa nói rõ yêu cầu phần cứng nào khác.
  • Muốn chỉ thử demo: một tài khoản claude.ai miễn phí là đủ, README ghi rõ “không cần gói trả phí” cho các script demo. Riêng đường Claude Code trên Linux cần gói Claude trả phí.

Server này có quyền admin trên nhà bạn. Đừng dán token vào chỗ công khai, và nên dùng tài khoản riêng cho HA-MCP thay vì tài khoản cá nhân của bạn.

III.Cài đặt từng bước

Mình hướng dẫn cách README khuyến nghị: cài HA-MCP integration. Đây là cách chạy trong Home Assistant, thay thế cho app (add-on), Docker và uvx. Chỉ chạy một cách, đừng chạy song song.

  1. Tải integrationCài HA-MCP qua HACS hoặc Marketplace
  2. Khởi động lạiRestart Home Assistant
  3. Chọn tài khoảnTạo token hoặc tài khoản riêng cho HA-MCP
  4. Thêm integrationSettings → Devices & Services → Add Integration
  5. Lấy URLCopy connect URL ở màn hình Configure
  6. Nối AIDán URL vào ứng dụng AI của bạn

A.Bước 1: Cài integration

Nếu Home Assistant của bạn là bản 2026.8 đến 2026.10: mở HACS, tìm HA-MCP, bấm Download. Nếu là 2026.11 trở lên: vào Settings → Marketplace, chấp nhận cảnh báo lần đầu, tìm HA-MCP, bấm Install. README nói HA-MCP nằm trong danh mục mặc định, nên không cần nối GitHub hay thêm repo tự chọn.

Bạn không dùng HACS hay Marketplace? README cho phép cài thủ công: chép thư mục custom_components/ha_mcp_tools/ từ repo vào thư mục config/custom_components/ của Home Assistant.

Terminal
git clone https://github.com/homeassistant-ai/ha-mcp.git

Lệnh trên tải repo về máy. Sau đó bạn chép thư mục nói trên sang Home Assistant.

B.Bước 2: Khởi động lại Home Assistant

Sau khi cài, hãy restart Home Assistant. Nhiều người quên bước này nên không thấy integration trong danh sách.

C.Bước 3: Chọn tài khoản admin mà server dùng

Có hai cách:

  • Tạo long-lived access token trên tài khoản của bạn: vào hồ sơ → Security → Long-lived access tokens → Create token. README cảnh báo token này dùng được từ mọi nơi nếu bị lộ, và các thay đổi sẽ hiện dưới tên bạn.
  • Cách an toàn hơn: tạo tài khoản riêng cho HA-MCP ở Settings → People → Add person, bật Allow login, Local access only và Administrator. README nhấn mạnh là đừng dùng chính tài khoản đăng nhập của bạn cho cách này.

D.Bước 4: Thêm integration

Vào Settings → Devices & Services → Add Integration, tìm HA-MCP và chọn HA-MCP Server. Dán token (hoặc nhập tên người dùng và mật khẩu của tài khoản riêng, HA-MCP sẽ tự tạo token). Sau đó chọn cách client được phép kết nối:

  • Remote access through Home Assistantnên bắt đầu bằng Secret URL cho đơn giản; Home Assistant sign-in thêm bước đăng nhập.
  • Network access: Local networkdùng trong mạng nội bộ.

Bấm Submit. Chỗ hay vấp: cả hai lựa chọn kết nối này mặc định đang tắt, nên máy khác muốn nối vào phải bật ít nhất một cái. Ngoài ra, README ghi rằng form có bước tài khoản admin chỉ có từ phiên bản 9.0.0 trở đi; bản cũ hơn có form ngắn hơn.

E.Bước 5: Lấy URL kết nối

Vào Settings → Devices & Services → “HA-MCP — Manage Home Assistant with AI” → HA-MCP Server → Configure và copy URL. Có một thông báo sẽ báo server đã chạy và chỉ bạn tới đó. Dạng URL README mô tả:

text
https://<your-ha-domain>/api/webhook/<webhook-id>
http://<ha-host>:8123/api/webhook/<webhook-id>
http://<ha-ip>:9584/private_<random>

Dòng đầu dùng cho truy cập từ xa (qua Nabu Casa hoặc reverse proxy), dòng hai khi ở trong nhà, dòng ba là cổng trực tiếp cho thiết bị trong cùng mạng.

F.Bước 6: Dán URL vào ứng dụng AI

Dán URL vào ứng dụng AI của bạn. Mỗi ứng dụng có cách thêm MCP server khác nhau, nên README gợi ý dùng Setup Wizard trên trang chủ dự án (https://homeassistant-ai.github.io/ha-mcp/setup/) để lấy cấu hình đúng cho từng client.

G.Các cách cài khác

App (add-on) trên Home Assistant OS và Supervised: thêm repo https://github.com/homeassistant-ai/ha-mcp vào Settings → Apps → Install app → ⋮ → Repositories, cài “Home Assistant MCP Server”, bấm Start, rồi mở tab Logs để lấy URL MCP. Cách này không cần token.

Docker và PyPI/uvx dành cho Container/Core hoặc máy riêng. Lệnh uvx README nêu là:

Terminal
uvx --python 3.14 ha-mcp@latest

Còn lệnh Docker đầy đủ, README chưa ghi trong phần mình có; bạn xem ở Setup Wizard và image là ghcr.io/homeassistant-ai/ha-mcp. Repo cũng có Dockerfile và docker-compose.yml để tham khảo.

IV.Kiểm tra đã chạy được chưa

Sau khi dán URL, hãy hỏi AI đúng câu README gợi ý:

text
Can you see my Home Assistant?

Bạn có thể hỏi bằng tiếng Việt cũng được, miễn nội dung tương tự. Nếu AI trả lời được những thứ có thật trong nhà bạn (đèn, cảm biến, khu vực) là đã nối thành công. Với Claude Code, README nói bạn chạy /mcp để xác nhận server đã được nhận.

Trong Home Assistant, nếu server đang chạy thì thanh bên có thêm bảng HA-MCP (chỉ admin thấy).

A.Thử demo trước khi nối nhà thật

Chưa muốn đụng vào nhà thật? Repo có script demo, kết nối tới một môi trường demo được lưu trữ sẵn.

Trên Windows, mở Windows PowerShell:

PowerShell
irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex

Trên macOS, mở Terminal:

Terminal
curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh

Trên Linux, với Claude Code (cần gói Claude trả phí):

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

Sau đó khởi động lại Claude Desktop và hỏi “Can you see my Home Assistant?”. Các lệnh này tải script từ GitHub rồi chạy ngay, nên bạn nên mở link script trước để xem nó làm gì.

V.Dùng vào việc thật

Dưới đây là những tình huống bám theo các ví dụ trong README. Câu lệnh mẫu bạn gõ cho AI.

A.Chủ nhà muốn tạo automation mà không biết YAML

Bối cảnh: bạn vừa lắp đèn hiên, muốn nó tự bật lúc hoàng hôn. Bạn nói với Claude:

text
Create an automation that turns on the porch light at sunset

Kết quả theo README: AI tạo automation với trigger và action phù hợp. Bạn vào Home Assistant kiểm tra lại là xong.

Cấu hình nhà thông minh không còn là việc của người biết YAML, mà là việc của người biết mình muốn gì.

Ông T

B.Sửa automation đang có

Bối cảnh: bạn có automation buổi sáng và muốn thêm máy pha cà phê.

text
Make my morning routine automation also turn on the coffee maker

AI đọc automation hiện tại, thêm hành động mới và cập nhật. Vì repo có tính năng tự động sao lưu trước khi sửa, bạn có đường lui nếu kết quả không như ý.

C.Gỡ lỗi khi automation không chạy

Bối cảnh: cảm biến chuyển động không kích hoạt đèn như mong muốn.

text
The motion sensor automation isn't working, debug it

Theo README, AI phân tích trace của lần chạy, tìm chỗ sai và đề xuất cách sửa. Bạn nên đọc đề xuất trước khi cho phép sửa.

D.Tạo chế độ “xem phim” bằng một script

Bối cảnh: mỗi tối bạn phải tắt đèn, kéo rèm, bật TV bằng tay.

text
Create a script that sets movie mode: dim lights, close blinds, turn on TV

AI tạo một script dùng lại được, gồm chuỗi hành động đó. Từ đó bạn chỉ cần bấm một nút hoặc gọi tên script.

VI.Lỗi hay gặp và cách xử lý

A.Không thấy HA-MCP trong danh sách integration

Thường do chưa restart Home Assistant sau khi cài, hoặc Home Assistant cũ hơn 2026.8.0. Hãy kiểm tra phiên bản, restart rồi thử lại. Lưu ý các bản cài cũ có thể hiện tên “HA-MCP Custom Component”; tìm “HA-MCP” sẽ khớp cả hai tên.

B.Máy khác không kết nối được

Theo README, cả hai tùy chọn truy cập (từ xa và mạng nội bộ) mặc định đều tắt. Vào màn hình Configure của integration, bật ít nhất một tùy chọn rồi copy lại URL.

C.Kết nối bị treo

README nêu rõ đây là nguyên nhân quen thuộc: cấu hình hai mục cho cùng một server trong một ứng dụng AI (ví dụ một mục uvx cục bộ cùng một URL app hoặc component). Hãy chỉ giữ một mục, một cách cài.

D.Chạy stdio bị chập chờn

README cảnh báo kiểu stdio có vấn đề về kết nối mà streamable HTTP không gặp. Nên dùng stdio chỉ để thử demo; nhà thật thì dùng custom component hoặc một cách HTTP.

E.Không mở được hộp thoại thêm repo cho app

README nói đây là lỗi đã biết của Home Assistant. Hãy thêm thủ công: Settings → Apps → Install app → ⋮ → Repositories, rồi dán https://github.com/homeassistant-ai/ha-mcp.

VII.Có nên dùng không

Điểm mạnh:

  • Cài ngay trong Home Assistant, hỗ trợ mọi kiểu cài, một nơi quản lý.
  • Phạm vi rộng: từ tìm kiếm, điều khiển, tạo automation tới backup và gỡ lỗi.
  • Có lớp an toàn: chế độ chỉ đọc, bật tắt từng công cụ, duyệt từng công cụ, tự sao lưu trước khi sửa.
  • MIT, có trang tài liệu, Setup Wizard, và bản demo để thử.

Giới hạn:

  • Server dùng quyền admin, nên bạn cần cẩn thận với token và với việc mở truy cập từ xa.
  • Cần bản Home Assistant đủ mới (2026.8.0 trở lên).
  • Một số tính năng như sửa file và YAML là tùy chọn, mặc định tắt, và cần thêm một mục riêng của integration. Thay đổi ha_config_set_yaml đã được chuyển sang beta theo ghi chú đầu README.
  • Muốn dùng ChatGPT từ xa mà Home Assistant không có địa chỉ công khai thì phải dựng thêm đường hầm, README nhắc tới một integration cộng đồng cho việc này.
  • Thông tin về chi phí dùng AI (gói của Claude, ChatGPT…) nằm ngoài repo; bạn tự xem gói bạn đang dùng.

Nếu bạn chỉ cần vài automation đơn giản và đã quen giao diện Home Assistant, có lẽ không cần thêm công cụ. Còn nếu bạn hay phải chỉnh cấu hình, gỡ lỗi, hoặc muốn nói chuyện với ngôi nhà bằng câu thường, ha-mcp đáng thử. Hãy bắt đầu với bản demo hoặc chế độ chỉ đọc cho yên tâm.

4.3/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

ha-mcp có miễn phí không?

Repo dùng giấy phép MIT nên dùng tự do. Các script demo ghi rõ không cần gói trả phí, chỉ cần tài khoản claude.ai miễn phí. Riêng đường Claude Code trên Linux cần gói Claude trả phí, còn chi phí của các AI khác thì README chưa nói.

Cần GPU hay máy mạnh không?

README không nêu yêu cầu GPU hay phần cứng riêng. Cách khuyến nghị chạy ngay trong Home Assistant. Phần xử lý ngôn ngữ do trợ lý AI của bạn đảm nhiệm.

Chạy được trên Windows không?

Có cho phần demo: README có script PowerShell cho Windows và hướng dẫn riêng. Còn cách chạy thật thì ha-mcp chạy trong Home Assistant, nên không phụ thuộc hệ điều hành máy bạn. Nó hỗ trợ Home Assistant OS, Supervised, Container và Core.

Dữ liệu và nhà của tôi có an toàn không?

Server dùng tài khoản admin nên bạn cần cẩn trọng. README khuyên tạo tài khoản riêng chỉ cho HA-MCP với quyền truy cập local, và token cá nhân sẽ dùng được từ mọi nơi nếu bị lộ. Repo có thêm chế độ Read Only, duyệt từng công cụ và tự sao lưu trước khi sửa, đồng thời có file PRIVACY.md và SECURITY.md để bạn đọc thêm.

Dùng được với ChatGPT không, hay chỉ Claude?

README nói dùng được với Claude, ChatGPT và các trợ lý AI khác. Setup Wizard liệt kê hơn 15 ứng dụng như Claude Code, Gemini CLI, ChatGPT, Open WebUI, VSCode, Cursor. Với ChatGPT thì thường cần URL truy cập được công khai, hoặc dùng đường hầm cộng đồng như README mô tả.

Nên chọn integration, app (add-on) hay Docker?

README khuyên dùng integration vì chạy ngay trong Home Assistant và đủ tính năng trên mọi kiểu cài. App là lựa chọn thứ hai trên Home Assistant OS và Supervised, không cần token. Docker hoặc uvx phù hợp với Container, Core hoặc máy riêng. Dù chọn cách nào cũng chỉ nên chạy một.

Khác gì so với tự viết automation trong giao diện Home Assistant?

README không có phần so sánh chính thức. Điều nó cho thấy là bạn mô tả bằng lời, AI đọc cấu hình, tạo hoặc sửa automation, script, dashboard và gỡ lỗi bằng trace. Giao diện Home Assistant vẫn là nơi bạn kiểm tra và quyết định cuối cùng.

Chuyển nhanh tới mục

  1. I.ha-mcp làm được gì
    1. A.Tìm kiếm
    2. B.Điều khiển
    3. C.Quản lý cấu hình
    4. D.Theo dõi và gỡ lỗi
    5. E.Hệ thống
    6. F.An toàn
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Bước 1: Cài integration
    2. B.Bước 2: Khởi động lại Home Assistant
    3. C.Bước 3: Chọn tài khoản admin mà server dùng
    4. D.Bước 4: Thêm integration
    5. E.Bước 5: Lấy URL kết nối
    6. F.Bước 6: Dán URL vào ứng dụng AI
    7. G.Các cách cài khác
  4. IV.Kiểm tra đã chạy được chưa
    1. A.Thử demo trước khi nối nhà thật
  5. V.Dùng vào việc thật
    1. A.Chủ nhà muốn tạo automation mà không biết YAML
    2. B.Sửa automation đang có
    3. C.Gỡ lỗi khi automation không chạy
    4. D.Tạo chế độ “xem phim” bằng một script
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Không thấy HA-MCP trong danh sách integration
    2. B.Máy khác không kết nối được
    3. C.Kết nối bị treo
    4. D.Chạy stdio bị chập chờn
    5. E.Không mở được hộp thoại thêm repo cho app
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.