Home Assistant (HA) 中通过HACS安装 MCP Server for Xiaozhi , 然后再集成添加插件 MCP Server for Xiaozhi（我们2026年4月后出去的主机已经完成了本步骤配置）
第一步：获取小智的“MCP 接入点地址”
小智设备需要一个通信地址才能跟你的 HA 连上，这个地址在小智的云端控制台里获取。
- 电脑或手机浏览器打开并登录 小智官方控制台（通常是 xiaozhi.me，如果是自部署的则打开你自己的控制台地址）。
- 在设备列表中，找到你目前正在使用的那台 ESP 小智设备，点击 配置 (Configure)。
- 页面向下滑动，找到 “MCP 设置” (MCP Setting) 区域。
- 点击 “获取 MCP 接入点” (Get MCP Endpoint)，此时会生成一串链接（通常以 wss:// 开头），复制这串地址备用。
第二步：在 HA 中配置小智 MCP 集成
现在我们要把刚才复制的地址填入 HA 中，让 HA 主动去连接小智服务器。
- 打开 Home Assistant 面板，点击左侧边栏的 配置 / 设置 (Settings)。
- 点击 设备与服务 (Devices & Services)。
- 点击右下角的 添加集成 (Add Integration)。
- 在搜索框输入 MCP 或 Xiaozhi，找到 MCP Server for Xiaozhi 并点击。
- 填写配置项：
- 小智MCP接入点地址：粘贴你在第一步复制的那串链接。
- 选择需要的 MCP（如果出现 llm_hass_api 复选框）：一定要勾选 。这是 HA 自带的控制功能，勾选后 HA 才能把家里的设备控制权“代理”交给小智。如果你在 HA 里还有其他 MCP 也可以一并勾选。
点击 提交 / 完成。
检查状态：耐心等待一分钟左右，回到小智控制台的 MCP 设置页面，点击刷新，看看状态是否已经变为“已连接”。
第三步：把 HA 的设备“公开”给小智（关键！）
如果直接对小智喊“开灯”，它可能会说找不到设备，因为出于安全考虑，HA 默认不会把所有设备都暴露给语音助手。
- 在 HA 面板中，进入 设置 (Settings) ->语音助手 (Voice assistants)。
- 找到 公开 (Expose) 选项卡。
- 在这里你会看到你家里的各种设备列表。勾选你想让小智控制的设备（比如具体的灯、开关、空调、风扇、温湿度传感器等）。 建议小白一开始只勾选 1-2 个灯测试，测试成功后再把其他设备勾选上。
第四步：语音测试与调试
全部配置完毕，你可以开始对小智下达指令了！
- 测试控制： “小智小智，打开书房的灯。”
- 测试查询： “小智小智，现在客厅的温度是多少？”
遇到问题怎么排查（避坑指南）：
- 小智没反应/乱回答：去小智的云端控制台，查看“聊天记录”。看看小智有没有听懂你的话，以及它有没有尝试调用 Home Assistant 的工具（Function Call）。
- 指令冲突：目前小智端如果开启了“内置的音乐/屏幕控制逻辑”，可能会与 HA 的灯光和音乐控制产生冲突。如果在控制灯光时经常失败，可以尝试把对话指令说得更具体，例如“通过智能家居把客厅的吸顶灯打开”。
- HA日志：如果小智确实发出了指令，但设备没动静，可以去 HA 的 设置 -> 系统 -> 日志 中查看 MCP 插件是否有报错信息。
按照以上四步，你的小智 AI 就能顺利化身为真正的“家庭智能管家”了！
