FitnessSyncer 和 Home Assistant

Home Assistant 可通过其 Model Context Protocol 集成功能使用 FitnessSyncer MCP Server。 连接后,Assist背后的AI可以通过语音或聊天方式回答有关您自身健康和健身数据的问题:例如本周您的睡眠情况如何、静息心率是否呈下降趋势,或者您上次记录体重是什么时候。
这会将 Assist 与 FitnessSyncer 连接起来,以便您提问时它能作出回应。此操作不会将 FitnessSyncer 传感器添加到您的仪表盘或自动化流程中。
开始之前
- 一个已连接数据源的 FitnessSyncer 账户。每个账户都包含 MCP Server;如果您是新用户,请参阅《入门指南》。
- Home Assistant 已配置为使用 AI 对话代理,例如 Open AI、Anthropic、Google Gemini 或通过 Ollama 调用的本地模型。 FitnessSyncer MCP Server 提供了许多工具,而大型模型在这些工具之间的选择要比小型本地模型更可靠。
- “我的 Home Assistant” 集成是默认配置的一部分。登录 FitnessSyncer 后,系统会通过该集成返回您的 Home Assistant。
步骤 1:在 FitnessSyncer 上生成密钥
- 转到“开发者账户”页面。
- 在页面底部,从列表中选择 Home Assistant,然后点击“创建”。
- 请记下客户端 ID 和客户端密钥。客户端密钥仅显示一次;如果遗失,您可以重新生成,但随后需要将其再次输入到 Home Assistant 中。
步骤 2:将 FitnessSyncer 加到 Home Assistant 上
- 在 Home Assistant 中,进入“设置”,然后选择“设备与服务”。
- 选择“添加集成”,然后选择“Model Context Protocol”。
- 在服务器 URL 处输入 https://www.fitnesssyncer.com/services/mcp,然后提交。
- Home Assistant 要求输入应用程序凭据。请将 FitnessSyncer 作为名称输入,并粘贴步骤 1 中获取的客户端 ID 和客户端密钥。
- 系统会将您引导至 FitnessSyncer 进行登录,并批准 Home Assistant 请求的权限。请取消勾选您不希望 Assist 执行的任何操作;对于回答问题而言,仅需读取权限即可。
- 系统将返回 Home Assistant,至此积分的添加操作完成。
第 3 步:让 Assist 使用 FitnessSyncer
- 在 Home Assistant 中,进入“设置”,然后选择“设备与服务”,打开您的 AI 集成(例如 Open AI 对话),并点击其对话代理旁边的齿轮图标。
- 在“Under Control”Home Assistant下,同时选择FitnessSyncer,然后提交。
- 在“设置”中,依次选择“语音助手”,打开您常用的语音助手,并将该助手的“对话代理”设置为该代理。
- 您的 AI 服务提供商会对 API 服务单独收费,与任何聊天订阅费用分开。如果 Assist 提示余额不足,请向您的服务提供商充值;Google Gemini 还提供免费套餐。
试试看
请向“Assist”提出以下任何一个问题,以确认一切运行正常:
- FitnessSyncer 连接了哪些应用和设备?它们各自上次同步是什么时候?
- 与上周相比,我这周的睡眠情况如何?
- 过去一个月里,我的静息心率有什么变化?
- 我昨天走了多少步?这与我的目标相比如何?
MCP Server 页面上还有更多想法。
您的 AI 助手会根据公开指南为您解释检测结果;这并非医疗建议。
FitnessSyncer 数据能否作为传感器显示在我的 Home Assistant 仪表盘上?
并非通过此集成实现。当你向 Assist 提问时,它会提供答案,但不会在 Home Assistant 中创建传感器或历史记录。如果你觉得步数、睡眠或体重的传感器对你有帮助,请告诉我们。
Home Assistant 无法连接到服务器。我应该检查什么?
- URL 必须完全为 https://www.fitnesssyncer.com/services/mcp. FitnessSyncer 使用的是 Streamable HTTP 传输协议,而不是较旧的 SSE 协议。
- Home Assistant 必须是最新版本,才能使其 Model Context Protocol 集成支持登录功能。如果系统未提示您输入应用程序凭据,请更新 Home Assistant。
登录 FitnessSyncer 后,我无法返回 Home Assistant。为什么?
登录操作将通过“我的 Home Assistant”返回,随后会打开您自己的 Home Assistant。请确保已启用“我的 Home Assistant”集成功能,并且您是从能够访问您的 Home Assistant 的浏览器进行登录的。
如果“链接账户”页面一直处于等待状态且无法完成,请检查其下方显示的实例 URL。该 URL 以 http://homeassistant.local:8123, 开头,仅适用于您网络中以该名称命名的 Home Assistant。 点击铅笔图标,输入您用于打开 Home Assistant 的地址,然后重新建立关联。如果 Home Assistant 随后显示错误,说明登录耗时过长:请删除该未完成的条目,并重新添加集成。
