FitnessSyncer 與 Home Assistant

Home Assistant 可透過其 Model Context Protocol 整合功能使用 FitnessSyncer MCP Server。 一旦連線完成,Assist 背後的 AI 便能透過語音或聊天方式,回答關於您自身健康與健身資料的問題:例如本週的睡眠狀況、靜息心率是否呈下降趨勢,或是您上次記錄體重的時間。
此設定會將 Assist 與 FitnessSyncer 連結,以便您提問時它能做出回應。此設定並不會將 FitnessSyncer 感測器新增至您的儀表板或自動化流程中。
開始之前
- 一個已連結您資料來源的 FitnessSyncer 帳戶。每個帳戶均包含 MCP Server;若您是新用戶,請參閱《入門指南》。
- Home Assistant 的 Assist 已設定為使用 AI 對話代理,例如 Open AI、Anthropic、Google Gemini 或透過 Ollama 使用的本地模型。 FitnessSyncer MCP Server 提供了許多工具,而大型模型在這些工具之間的選擇上,比小型本地模型更為可靠。
- 「我的 Home Assistant」整合功能是預設設定的一部分。登入 FitnessSyncer 後,系統會透過此功能將您導回您的 Home Assistant。
步驟 1:在 FitnessSyncer 上建立您的金鑰
- 前往「開發者帳戶」頁面。
- 在頁面底部,從清單中選取 Home Assistant,然後點擊「建立」。
- 請記下「Client Id」和「Client Secret」。「Client Secret」僅會顯示一次;若遺失,您可以重新產生,但屆時需再次在 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 對話),然後點選其對話代理程式旁邊的齒輪圖示。
- 勾選「已受控」Home Assistant,同時也勾選 FitnessSyncer,然後提交。
- 在「設定」中,依序點選「語音助理」,開啟您常用的語音助理,並將其「對話代理」設定為該代理。
- 您的 AI 服務供應商會將其 API 費用與任何聊天訂閱分開計費。若 Assist 回覆表示餘額不足,請向您的服務供應商儲值;Google Gemini 亦提供免費方案。
試試看
請向 Assist 提出以下任一問題,以確認一切運作正常:
- FitnessSyncer 連接到哪些應用程式和裝置?每項裝置上次同步的時間是什麼時候?
- 與上週相比,我這週的睡眠狀況如何?
- 過去一個月,我的靜息心率有何變化?
- 我昨天走了多少步?這與我的目標相比如何?
MCP Server 頁面上有更多相關點子。
您的 AI 助理會根據公開指引為您解釋檢測結果;這並非醫療建議。
FitnessSyncer 的資料能否以感測器的形式顯示在我的 Home Assistant 儀表板上?
並非透過此整合功能。當您向「Assist」提問時,它會提供答案,但不會在 Home Assistant 中建立感測器或歷史紀錄。若您認為步數、睡眠或體重的感測器對您有幫助,請告訴我們。
Home Assistant 無法連線至伺服器。我該檢查什麼?
- 網址必須完全為 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 隨後顯示錯誤訊息,表示登入過程耗時過久:請刪除該未完成的記錄,並重新新增此整合功能。
