FitnessSyncer

  將 AI Assistant 與 API 金鑰進行連結

並非每個 AI 助理都能代您登入 FitnessSyncer MCP Server。 許多助理僅提供伺服器位址和放置憑證的欄位,有些則會從磁碟上的檔案讀取完整的設定。針對這類情況,FitnessSyncer 會發放一個 API 金鑰,這是一個長期有效的單一憑證,可代表整個登入流程。

這就是 Mistral Vibe 的連線方式,同時也是自建助理、命令列客戶端、代理框架,或是提供標頭而非 OAuth 畫面的 ChatGPT 的解決方案。 Claude、ChatGPT、Perplexity 和 Home Assistant 各自擁有專屬的登入流程,因此請在適用時優先參考其各自的操作說明。

開始之前

  • 一個已連接資料來源的 FitnessSyncer 帳號。每個帳號均包含 MCP Server,因此無需額外購買;若您是新用戶,請參閱「入門指南」。在此處,免費帳號所能查閱的歷史資料範圍較短,這與本網站其他處的情況完全相同。
  • 一個能夠傳送「Authorization」標頭的助理,或者將此標頭稱為「Bearer Token」或「API token」。如果您的助理能改用 OAuth 登入,那會是更好的選擇,因為您可以每次自行選擇權限,而非僅在首次設定時選擇一次。

API 金鑰是您授予其權限的密碼,它本身並不會過期。請僅將其輸入至您信任且願意託付健康資料的助理中,並僅授予其所需的最低權限。

步驟 1:在 FitnessSyncer 上建立您的 API 金鑰

  1. 前往「開發者帳戶」頁面。
  2. 在頁面底部,從清單中選取「MCP: API 金鑰」,然後點擊「建立」。
  3. FitnessSyncer 詢問此金鑰應具備哪些權限。請僅勾選您希望助理執行的操作;若僅用於回答問題,讀取權限已足夠,且您未勾選的任何權限,日後若要使用,必須先建立新的金鑰。
  4. 選擇「建立 API 金鑰」,並記下下一頁顯示的 API 金鑰。此金鑰僅會顯示一次;若遺失,您可以重新產生,但屆時需再次在您的助理中輸入該金鑰。

  Step 2: Mistral Vibe

取得 API 金鑰後:

  1. 從左側選單中,選擇「上下文」,然後選擇「連接器」。
  2. 請點選畫面右上角的「新增連接器」。
  3. 選擇「自訂 MCP 連接器」。
  4. 請在「名稱」欄位中輸入「FitnessSyncer」
  5. 請為伺服器輸入「https://www.fitnesssyncer.com/services/mcp」
  6. 選擇「API 憑證驗證」,並將您的 API 金鑰貼上至「Bearer Token」欄位中。

步驟 2:任何其他具有設定畫面的助理

雖然不同助手對這些欄位的命名各不相同,但實際上始終只有三個:

  1. 在「名稱」欄位中輸入「FitnessSyncer」
  2. 在「伺服器」欄位中輸入「https://www.fitnesssyncer.com/services/mcp」,部分助理將其稱為「遠端 MCP 伺服器網址」
  3. 請在「Bearer Token」欄位中輸入您的 API 金鑰。如果助理要求提供標頭,則標頭名稱應為「Authorization」,其值應為「Bearer」、一個空格,以及您的 API 金鑰。

如果系統也要求您選擇傳輸協定,請選擇「Streamable HTTP」。FitnessSyncer 不提供較舊的 SSE 傳輸協定。

步驟 2:從檔案設定助理

許多命令列和桌面客戶端會從 JSON 檔案中讀取其伺服器資訊。檔案格式因情況而異,請參照您所使用助理的文件說明,但通常如下所示:

{
 "mcpServers": {
   "FitnessSyncer": {
     "transport": "http",
     "url": "https://www.fitnesssyncer.com/services/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_TOKEN_HERE"
     }
   }
 }
}

請將 YOUR_TOKEN_HERE 替換為您的 API 金鑰,並保留「Bearer」一詞及其前面的空格。

試試看

開啟一個新的聊天視窗,並貼上以下任一內容,以確認一切運作正常:

  • 列出我的帳戶目前已連線的所有應用程式和裝置 FitnessSyncer,並顯示它們上次同步的時間。
  • 與上週相比,我這週的睡眠狀況如何?
  • 過去一個月,我的靜息心率有何變化?

MCP Server 頁面上有更多相關點子。

您的 AI 助理會根據公開指引為您解釋檢測結果;這並非醫療建議。

我應該使用 API 金鑰還是登入?

請在您的助理支援登入功能的地方進行登入。OAuth 登入方式會在您連線的當下詢問您要授予哪些權限,且該權限可針對該次連線予以撤銷;而 API 金鑰則會保留您在建立時所選擇的權限,直到該金鑰存在為止。

當助理無法登入時,請使用 API 金鑰;此情況適用於 Mistral Vibe 以及大多數透過檔案進行設定的客戶端。

我可以變更 API 金鑰的權限範圍嗎?

不要事後再調整。權限是在建立金鑰時就已設定好的,因此若要擴大或縮小權限範圍,請在「開發者設定」中刪除該金鑰,並根據所需權限建立一個新的金鑰。接著,您的助理就需要使用這個新金鑰。

我遺失了 API 金鑰。現在該怎麼辦?

該金鑰僅在建立時才會顯示,因此無從查詢。請在「開發者設定」中重新產生金鑰,並在您的助理中輸入新的金鑰。一旦重新產生金鑰,舊金鑰便會立即失效,這也是您鎖定不再信任的助理的方式。

該如何解除與助理的連結?

請先從助理中移除連接器,然後在「開發人員設定」中刪除該金鑰。刪除該金鑰是關鍵步驟,因為若仍有任何項目持有該金鑰,系統將持續運作。

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