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 令牌的助手。如果您的助手可以使用 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 令牌”中。

步骤 2:任何其他带有设置界面的助手

虽然不同助手对这些字段的命名各不相同,但总共只有三个:

  1. 在“名称”栏中输入 FitnessSyncer
  2. 在“服务器”字段中输入https://www.fitnesssyncer.com/services/mcp,某些助手将其称为远程MCP服务器URL
  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 来了解用户如何使用本网站。 了解更多