把家里的钥匙交给 AI 之前:从一盏灯开始的 Home Assistant MCP 实验
英文版:Give Your AI a House Key: A One-Lamp Home Assistant MCP Trial
你说一句“打开书桌灯”,现实世界就发生了变化。AI 从描述房间,走到了操作房间里的东西。真正要弄清楚的是:它凭什么能动这盏灯,你又拿什么证明它做对了?
想象你请了一位助手,只让他照看阅览室,却交给他一把能开整栋楼的钥匙。在工作说明里写“请别去其他房间”,改变不了钥匙本身。Home Assistant 负责连接设备,AI 理解你的意思,MCP 则让 Agent 用统一方式发现、调用工具。权限先对上任务,提示词才有用。
这份指南依据公开文档整理,核实日期为 2026 年 10 月 18 日。我们没有为本期实际安装设备或操作实体台灯。第一次只试自己有权控制、家人也同意的一盏非必要台灯。
网上的承诺、实验室的结果、家里能做的小实验
| 层面 | 有依据的能力 | 不能由此推断的结论 |
|---|---|---|
| 网上的承诺 | Home Assistant 十月更新加入专门的 AI 设置页和一键连接入口,接通更方便。 | 接通快,不代表选对设备,更不代表适合放手让它自主行动。 |
| 实验室 | SimuHome在模拟环境中研究带时间因素的智能家居任务;Home Assistant 数据集项目用合成家庭和预期工具动作评估模型。 | 模拟评测不能证明它能在真实家庭里照顾老人、喂宠物或处理紧急情况。 |
| 普通家庭 | 兼容设备准备好后,尝试“读状态 → 明确批准 → 执行一次 → 再读状态”,并由人亲眼看灯。 | 这里没有宣称家庭实测成功率。回答得像成功了,不能算验收通过。 |
先选服务窗口,再决定它能看见哪些房间
Home Assistant 用“实体”(entity)表示传感器、可控功能或系统组件,比如一个开关、一盏灯。亮度可以是灯实体的属性;一个物理设备也可能对应多个实体。“集成”(integration)负责把受支持的设备或服务接进系统。把测试灯命名成“书房书桌灯”,比“灯二”容易分辨。实体、状态与属性说明。
内置 Assist API 也叫 Device control,按已暴露的实体提供设备控制,不能管理整个 Home Assistant。更宽的 Home Assistant 管理 API 不受这张实体清单限制。因此,“选哪些 API”和“暴露哪些设备”是两道不同的设置。官方 API 权限范围。
- 进入 MCP 集成的配置,关闭 Expose all LLM APIs,只选 Assist / Device control。本实验不要选可全面控制的 My MCP。
- 新建 MCP 配置默认暴露所有 LLM API,也包括以后新增的 API,并默认要求管理员账号。旧配置会保留此前设置,不能凭印象判断。此次保留管理员要求,逐项检查。当前配置选项。
- 检查已暴露的实体、脚本及实际工具。暴露给 LLM 的脚本也可能变成可调用工具,只藏起其他设备名称还不够。测试时只留下这盏无关紧要的灯及所需工具。Assist 命名、暴露和脚本说明。
- 从当前 AI 界面复制受限连接的 URL,再检查客户端实际拿到的工具和上下文。出现意料之外的设备或操作,先停下修配置。
这些设置约束的是这条连接。管理员账号依然有较高权限,终端 Agent 也可能另有文件和命令权限。提示词是行为要求,不能充当访问控制;授权还要靠系统配置、认证,以及客户端真正生效的审批设置。
采购清单:先看看手里已有的东西

| 物品 | 新增花费 | 前提 |
|---|---|---|
| 现有 HAOS 主机或合适的闲置 x86-64 电脑 | 复用时为 0 | 仍需存储、电源和网络;没有闲置主机就单独计价。 |
| 现有受支持的非必要台灯 | 复用时为 0 | 优先用已经能工作的集成,不一定要买插座。 |
| 可选:美国版 Tapo P125M Wi-Fi Matter 插座 | 约 12 美元,未含税和运费 | 2026 年 10 月 18 日官方美国商店价格;价格和库存会变。核对地区、版本、插头和电压。 |
| 现有路由器、手机及网络 | 复用时为 0 | 使用 Companion app,配对时用手机蓝牙;本地 IPv6、mDNS 发现要正常。 |
| 终端 Agent 与模型 | 另付订阅费或 API 费 | 不包含在插座价格里,部分家庭上下文可能发送给外部模型。 |
价格和型号分别见美国官方商店及厂商规格页,这些链接不含返佣。约 12 美元只是可选插座的钱,并不是从零搭一整套系统的预算。P125M 负责通断电,不是调光器。
厂商美国版规格书列出 FCC、UL 和 Matter;购买时还要匹配具体地区型号、硬件版本和标识。Matter 互通、UL 电气安全与无线电认证不是一回事。日本选符合技適要求的本地型号,欧盟选相应 CE 版本。这里没有核实日本或欧洲具体 SKU,也不建议把美国插座直接进口到不同电气系统使用。
哪些步骤自己做,哪些交给 Agent
- 先让 Home Assistant 自身能正常控制灯。若在闲置电脑装 HAOS,自己选择并确认目标磁盘:官方 x86-64 安装流程可能擦除该盘。合适的虚拟机也是选择,但网络另需配置,不要让 Agent 随手覆盖日常电脑。
- 使用外壳完整、额定参数合适的插座和普通非必要台灯。不拆外壳,不接市电线路,不改电池;保留随手可用的实体按钮。你亲自插接、配对、命名,配对码不要公开。
- 照当前 Matter 文档操作。这个 Wi-Fi Matter 插座不需要 Thread 无线棒或边界路由器;手机配对时要用蓝牙,本地网络要支持 IPv6 与组播发现。能上网,不等于本地发现正常。
- 让 Agent 查当前文档和已安装客户端的 MCP 帮助,展示配置改动,再由你完成认证。密码、令牌、配对二维码都不要放进提示词、截图或提交的配置文件。
Agent 可以查资料、协助排障、发现真实工具、提出一次动作、重读状态、解释如何断开。插灯、配对、授权和亲眼观察由你完成。Home Assistant 在本地运行,不等于调用的模型也在本地;接入前要了解模型提供方会收到哪些上下文。
可直接粘贴给终端 Agent 的提示词
可交给 Codex 等受支持的终端客户端。先读一遍,再粘贴;只在需要时提供你自己复制的受限连接 URL。它是一份任务说明,不是权限隔离措施。
请帮我把自己的 Home Assistant 接入当前终端 Agent,只测试一盏非必要台灯。先阅读最新官方 HA MCP、Matter 文档和你已安装版本的 MCP CLI 帮助。
我会先关闭 Expose all LLM APIs,只选 Assist / Device control,并只暴露测试灯,再提供对应的受限 MCP URL。不要选 My MCP / 全面控制,不要启用未来新增 API、变更账号权限或开放端口,也不要读取、粘贴、导出秘密。
展示配置改动,让我亲自完成认证。支持时使用 OAuth;如果这个客户端或版本无法安全连接,请说明原因并停下,不要绕过安全设置。
发现实际工具和实体,不要猜 entity ID,也不要假设有完整 REST 权限。检查暴露的脚本及间接工具,不能只看设备名称。先展示客户端真正生效的审批控制。
先只报告测试灯的当前状态,不要改动。状态不可用或名称不明确就停下询问。提出打开这一盏确切台灯的操作,等待我明确批准,再调用一次,之后重新读取状态。区分“系统报告开关已开”和“人亲眼观察到灯亮”。
如果没有我的明确批准就执行了动作,本次测试失败。立即停止,协助我断开;修好实际审批设置前不要重试。
不要操作锁、门、供暖、烹饪设备、医疗设备、宠物喂食器或摄像头。不要安装持久自动化。给我简短日志及断开、撤销授权的步骤。
反复执行的日常任务应另行起草为原生 HA 自动化,经我审阅、测试并保留手动接管方式,不要靠模型每次临场判断。官方 Codex 示例的命令形式如下。先核对本机帮助,把占位符替换为当前界面复制的受限 URL,再亲自完成浏览器授权。不要照抄旧教程的端点,也不要把秘密写在这里。
codex mcp add --help
codex mcp add homeassistant --url "<COPIED_RESTRICTED_ASSIST_URL>"官方客户端示例也包括 Claude Code;当前文档要求它使用 HTTPS。不要为跑通实验直接开放端口或弱化 TLS。网页云端连接器需要受支持的安全远程访问。安全认证不通,就先修兼容性,不能绕过去。

验收时,把系统报告和亲眼看到分开
- 先关灯,确认 Home Assistant 手动控制、插座实体按钮都正常。只问状态,不要求动作;灯不应变化。
- 给一个含糊请求,但不批准设备动作。要通过测试,灯就必须不变。只要客户端未经明确批准就执行,立刻断开,修好实际审批控制后再试。
- 明确批准打开指定的那盏灯。只执行一次,随后重新读状态。人亲眼看灯,把“开关报告已开”和“观察到灯亮”分别记下。插座通电不能证明没插好的灯或坏灯泡在发光。
- 测试设备不可用时的反应。应该报告未知或错误,不能编造成功。简记认错设备、连接失败和意外操作。
- 结束试验就断开 Agent,并视需要撤销授权。确认手动控制仍然有效;任何验收项失败,都先修好,再考虑第二个设备。
不同家庭,起点也不同
| 情境 | 可以从这里开始 | 这次不要交给它 |
|---|---|---|
| 独居 | 一盏阅读灯,实体按钮伸手可及。 | 判断人在不在、紧急求助或必要设备控制。 |
| 老人、小孩 | 成人在场监督的灯光指令,名字简单易懂。 | 照护监测、无人监督的安全决策、孩子可接触的凭据。 |
| 宠物 | 家人同意的一盏非必要灯。 | 喂食、加热和开关门。 |
| 租房、不能打孔 | 已有灯泡或可随时拔掉的密封插座。 | 改线、打孔或改动房东设备。 |
| 出差 | 提前审阅的原生例行程序;确有需要再配置安全远程访问。 | 直接端口映射,或让必要日常任务依赖模型临场发挥。 |
锁、门、供暖、烹饪、医疗设备、宠物喂食器、摄像头都不在本实验范围。台灯状态不能当照护监测,也不能可靠证明谁在家。
第一盏灯之后
固定重复的任务,可让 Agent 另行起草原生 Home Assistant 自动化:定义触发条件、所需判断及动作,单独审阅测试,保留手动接管。自动化基础。每天按约定时间开灯,不需要每晚重新请模型做决定。
当前 Home Assistant MCP 实现不支持通知;Assist 上下文资源是快照,不会自动变成全屋实时传感事件流。实现能力和限制。
钥匙比喻只能帮你理解,不能替代实际配置、认证和账号权限。真正值得带走的,是把任务说清楚、把权限看明白、把结果验出来,再决定要不要接第二个设备。
来源与示意画面说明
正文链接对应相关一手来源。Home Assistant Core 开源仓库使用 Apache-2.0 许可证。本期实际使用的两张网页截图,分别来自该 Core GitHub 仓库和Home Assistant 十月发布说明。其他画面,包括 MCP 配置、插座和 Matter 连接概念,都是概念插画,不是官方界面的精确复现,也不是产品实拍。网页截图仅说明公开资料,不代表实物安装或操作测试。软件默认设置、价格及库存核实于 2026 年 10 月 18 日,动手前请重新检查。
Watch more first-principles field guides on Wiki4What, or read the essays at blog.wiki4what.com.