最新版HA系统自带了MCP Server集成，本文介绍官方的MCP Server的集成使用方法

一、安装新版本的HA

新版本的HA安装方式，可参考另一篇文章，此处2025.10.4版本为例

飞牛OS安装新版本HomeAssistant-呱仔爱学习

二、添加MCP Server集成

进设置>设备与服务页面

搜索mcp，选择Model Context Protocol Server，点击添加。即可添加完成

三、HA MCP接入方式

官方文档地址：Model Context Protocol Server - Home Assistant

客户端 mcp-proxy (官网示例)

目前HA官方文档，以Claude和Cursor客户端为例，仅展示了command line方式，通过uw安装mcp-proxy的方式，让客户端调用mcp-proxy命令。该方式需要python uv基础环境，并且需要客户端支持command连接方式。具体步骤总结如下：

1. uv安装mcp-proxy（* 需要本地安装配置python环境，以及python的环境管理工具uv）

2. HA页面生成API_ACCSEE_TOKEN

3. 在客户端配置josn（通过mcp-proxy命令连接HA MCP Server）

客户端 sse (推荐通用)

官方文档上没有提及，但是通过翻看HA MCP Server官方GitHub仓库core/homeassistant/components/mcp_server at dev · home-assistant/core，发现它也支持sse连接方式，大多数mcp客户端都是支持发起sse连接的，而且不需要本地做任何配置。具体步骤如下：

1. 生成API_ACCSEE_TOKEN：在个人页面，最下方创建令牌

2. 客户端配置json如下格式：记得替换本地HA的url，和API_ACCSEE_TOKEN

{
  "mcpServers": {
    "Home Assistant": {
      "url": "http://192.168.1.6:8123/mcp_server/sse",
      "headers": {
        "Authorization": "Bearer ${API_ACCSEE_TOKEN}"
      }
    }
  }
}

3. 将配置json内容复制进任意mcp客户端即可使用

四、效果展示