Suunto MCP 用户指南
将你的 Suunto 运动、睡眠、恢复和路线数据连接到支持 MCP 的 AI 助手，让它在你授权后基于真实数据回答训练相关问题。
https://mcp.suunto.cn/open/mcp
这是什么
Suunto MCP 是 Suunto 为用户提供的数据连接能力。它让 ChatGPT、Claude、WorkBuddy、Hermes、OpenClaw 等支持 MCP 的 AI 助手在你授权后读取你的 Suunto 数据，用来总结训练、分析恢复和回答你自己的运动问题。
你不需要手动导出文件，也不需要把截图一张张发给 AI。你提出问题，AI 会在需要时通过 Suunto MCP 查询相关数据，再给出回答。
你可以用它做什么
总结最近一周或一个月的跑步、骑行、徒步等运动记录，查看训练量变化。
结合睡眠、恢复和活动数据，了解近期是否需要降低训练强度。
对比几次训练的距离、时长、速度、心率区间和训练效果。
查看保存的路线，按距离或运动类型筛选适合下一次训练的路线。
可接入的 AI 助手
ChatGPT
- 打开 ChatGPT 网页端，进入设置中的 应用(或者叫Apps或Connectors)。
- 进入高级设置，开启Developer mode。
- 添加新的 MCP 应用，在连接处选择 服务器 URL，并填入上方 MCP 地址。
- 按页面提示登录 Suunto 账号并完成授权。
- 回到对话中，要求 ChatGPT 使用 Suunto MCP 查询你的数据。
请使用 Suunto MCP 查看我最近两周的运动记录，并总结训练量变化。Claude App
这里的 Claude 指网页端或桌面端的 Claude 对话产品，不是 Claude Code。
- 打开 Claude，进入 Connectors 设置。
- 添加 Custom Connector，名称可填写 Suunto MCP。
- 填入上方 MCP 地址并保存。
- 按页面提示登录 Suunto 账号并完成授权。
- 在对话中启用该连接器，并提出你的训练或恢复问题。
请用 Suunto MCP 分析我最近 7 天的睡眠和恢复情况。Codex App
Codex App 可以在设置页添加 MCP 服务器。推荐按下面步骤配置：
- 打开设置：进入 Codex 设置，选择 MCP 服务器。
- 添加服务器：点击添加服务器。
- 填写名称：
suunto。 - 选择类型：流式 HTTP。
- 填写 URL：
https://mcp.suunto.cn/open/mcp。 - 保存启用：保存后打开 suunto 右侧开关。
- 完成授权：如果出现进行身份验证按钮，点击后按提示登录 Suunto 账号并完成授权。
请使用 suunto MCP 查询我最近 14 天的运动记录，并输出训练量总结。命令行配置（可选）
如果使用 CLI 或自动化配置，也可以执行：
codex mcp add suunto --url https://mcp.suunto.cn/open/mcp
codex mcp listClaude Code
在命令行执行：
claude mcp add --transport http suunto https://mcp.suunto.cn/open/mcp
claude mcp list进入 Claude Code 会话后，可以通过 /mcp 查看连接状态，并按提示完成 Suunto 授权。
Suunto MCP 还可接入更多支持远程 MCP/OAuth 的 AI 工具，例如 WorkBuddy、Hermes、OpenClaw。
WorkBuddy
WorkBuddy 可通过自定义连接器接入 Suunto MCP。进入 WorkBuddy 的连接器或专家页面，点击自定义连接器，然后在 MCP 服务管理中点击配置 MCP。
在配置文件中添加：
{
"mcpServers": {
"suunto": {
"url": "https://mcp.suunto.cn/open/mcp",
"auth": "oauth"
}
}
}保存后返回 MCP 服务列表，点击 信任。如果服务显示需要认证，按提示完成 Suunto OAuth 授权；授权完成后启用 suunto 服务，即可看到可用工具并在对话中使用 Suunto MCP 查询数据。
Hermes
Hermes 支持连接 OAuth 认证的远程 HTTP MCP 服务。先在 Hermes 配置(~/.hermes/config.yaml)中添加 Suunto 服务：
mcp_servers:
suunto:
url: https://mcp.suunto.cn/open/mcp
auth: oauth
sampling:
enabled: false保存后执行登录命令，并按提示在浏览器中完成 Suunto 授权：
hermes mcp login suunto更多说明见 Hermes MCP OAuth 文档。
OpenClaw
Suunto MCP 也可以接入 OpenClaw。OpenClaw 可把远程 MCP 服务保存为客户端侧配置，再通过 OAuth 完成登录。
在命令行执行：
openclaw mcp add suunto --url https://mcp.suunto.cn/open/mcp --transport streamable-http --auth oauth --timeout 300 --connect-timeout 5
openclaw mcp login suunto
openclaw mcp login suunto --code {{CodeFromOpenClawRedirectUrlPath}}
openclaw mcp doctor suunto --probe如果是第一次启动 OpenClaw，建议在 ~/.openclaw/openclaw.json 中允许插件工具。如果文件里已有其他配置，请按 JSON 语法补逗号后合并：
{
"tools": {
"allow": ["group:plugins"]
}
}更多说明见 OpenClaw MCP 文档。
隐私与授权
- 只有在你主动授权后，AI 助手才能通过 Suunto MCP 读取你的 Suunto 数据。
- AI 助手不会获得你的 Suunto 密码。
- 当前 Suunto MCP 是只读能力，不会修改你的账号、运动记录或训练计划。
- 不要把授权链接、访问凭据或账号信息分享给他人。
- AI 给出的训练建议仅供参考，不能替代医生、教练或专业人士的判断。
常见问题
AI 没有使用我的 Suunto 数据怎么办？
请在提问时明确写出“使用 Suunto MCP 查询我的真实 Suunto 数据后再回答”，并给出时间范围，例如最近 7 天、最近 28 天或上个月。
MCP 工具名称可以使用中文吗？
建议 MCP 工具名称使用英文。如果 AI 平台尚未完整支持其他语言，非英文工具名可能导致 MCP 无法正常使用。ChatGPT 网页端当前对中文 MCP 工具名的支持也比较有限。
为什么有些长时间范围查询比较慢？
运动、睡眠和恢复数据通常适合按较短时间窗口查询。你可以让 AI 分段查询，再做汇总。
它会自动修改我的训练计划吗？
不会。当前 Suunto MCP 只读取数据，用于分析和回答问题。