FitnessSyncer

Home Assistant
  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 上建立您的金鑰

  1. 前往「開發者帳戶」頁面。
  2. 在頁面底部,從清單中選取 Home Assistant,然後點擊「建立」。
  3. 請記下「Client Id」和「Client Secret」。「Client Secret」僅會顯示一次;若遺失,您可以重新產生,但屆時需再次在 Home Assistant 中輸入該值。

步驟 2:將 FitnessSyncer 加到 Home Assistant 上

  1. 在 Home Assistant 中,前往「設定」,然後選擇「裝置與服務」。
  2. 選取「新增整合」,然後選擇「Model Context Protocol」。
  3. 請在伺服器 URL 欄位中輸入「https://www.fitnesssyncer.com/services/mcp」,然後提交。
  4. Home Assistant 會要求您輸入應用程式憑證。請將 FitnessSyncer 輸入為名稱,並貼上步驟 1 中取得的「客戶端 ID」和「客戶端密鑰」。
  5. 系統會將您導向 FitnessSyncer 進行登入,並核准 Home Assistant 所請求的權限。請取消勾選您不希望「Assist」執行的任何項目;若僅用於回答問題,讀取權限已足夠。
  6. 系統將帶您返回 Home Assistant,此時積分運算即告完成。

步驟 3:讓 Assist 使用 FitnessSyncer

  1. 在 Home Assistant 中,前往「設定」,接著選擇「裝置與服務」,開啟您的 AI 整合功能(例如 Open AI 對話),然後點選其對話代理程式旁邊的齒輪圖示。
  2. 勾選「已受控」Home Assistant,同時也勾選 FitnessSyncer,然後提交。
  3. 在「設定」中,依序點選「語音助理」,開啟您常用的語音助理,並將其「對話代理」設定為該代理。
  4. 您的 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 隨後顯示錯誤訊息,表示登入過程耗時過久:請刪除該未完成的記錄,並重新新增此整合功能。

該如何斷開 Home Assistant 的連接?

請移除 Home Assistant 中的整合功能,然後在您的個人設定中撤銷其權限,或在「開發者設定」中刪除 Home Assistant 的金鑰。

FitnessSyncer 會使用必要的 Cookie 來協助您登入並記住您的設定。在獲得您的同意後,我們也會使用分析型 Cookie 來了解使用者如何使用本網站。 了解更多