Tredict

Tredict MCP 服务

适用于 Tredict 的官方 Model Context Protocol（MCP）服务。Tredict 是面向耐力运动员和教练的规划与分析平台。将你偏好的 AI 助手连接到完整的训练历史记录，涵盖跑步、骑行、游泳等项目。分析活动、确定能力值，并在 Tredict 中创建结构完整的训练计划，直接同步到你的运动手表。

Tredict 还提供交互式 MCP App UI 小组件，可在 Claude.ai 或 ChatGPT 等宿主的 LLM 聊天中，以可视化方式呈现活动详情和训练计划。

概览

名称	Tredict MCP 服务
MCP 服务 URL	https://www.tredict.com/api/mcp/v2
传输方式	Streamable HTTP 和 SSE
协议	MCP 2025-06-18
身份验证	OAuth 2.1 with PKCE / Personal API Token

完整技术文档：Tredict MCP 服务文档。

核心功能

• 创建训练计划。 分析训练历史和当前体能状况，生成可重复使用、为期数周且包含结构化训练的计划，并将其保存到用户的“My Plans”类别中。
• 编写结构化训练。 为跑步、骑行、游泳和力量训练创建可执行的结构化训练，并重新安排计划训练或为其重命名。
• 活动分析。 获取每项已完成活动的详细指标和完整时间序列（心率、配速、功率、步频、海拔、位置、圈数）。
• 能力评估。 根据近期训练数据确定 FTP、FTPace（跑步）、HRmax 和乳酸阈值。
• 健康与恢复。 获取 HRV、睡眠、身体数据（体重、体脂、静息心率）和随时间变化的训练负荷。
• 训练区间。 读取区间修订记录，以及按 sportType 和 zoneType（heartrate、pace、power、cadence）汇总的区间分布。
• 装备追踪。 列出所有装备（自行车、跑鞋、游泳装备、其他），包括使用范围、次数、距离和时长。
• 设备同步。 应用到训练日历的计划会自动上传至已连接的运动手表（Garmin、Suunto、Coros、icTrainer、Wahoo、Apple Watch 等）。

对话示例

活动分析

You: "How did my long run on Sunday go?"
Claude: [Shows pace, heart rate, cadence, elevation and zone distribution. 
         Flags the last 5 km where HR drifted into threshold]

创建训练计划

You: "Build me a 10-week half marathon plan based on my recent training"
Claude: [Analyses last 8 weeks of running history, creates a structured 
         multi-week plan in My Plans, pushes workouts to your Garmin]

FTP 与能力

You: "What is my current running FTP?"
Claude: [Derives FTPace from recent efforts, compares to last revision, 
         suggests updated training zones]

装备与跑鞋

You: "How many kilometres do my current running shoes have?"
Claude: [Lists active shoes with distance logged, 
         flags gear approaching typical replacement range]

年度对比

You: "How does my 2025 training compare to 2024?"
Claude: [Compares total volume, zone distribution, long run progression
         and peak weeks across both years]

恢复状况检查

You: "Am I ready for tomorrow's threshold session?"
Claude: [Reads HRV trend, resting heart rate and recent training load.
         Gives a clear go or back-off recommendation]

计划执行情况

You: "Am I actually hitting my training zones as planned?"
Claude: [Shows prescribed vs actual time in each zone per sport,
         highlights where execution is drifting from the plan]

HRV 与体能趋势

You: "What does my HRV trend tell me about my current fitness?"
Claude: [Analyses rMSSD baseline, flags suppression periods,
         links dips to high-load weeks in training history]

比赛目标现实性检查

You: "Is my sub-4 marathon goal realistic given my current training?"
Claude: [Derives pace capacity from recent long runs and threshold efforts,
         compares to goal pace, outlines what needs to improve]

平台支持

官方支持： Anthropic Claude（Web、Desktop、Code）、OpenAI ChatGPT、OpenAI Codex、Mistral Le Chat、Mistral Vibe。

兼容： 任何支持 OAuth 2.1 或 bearer-token 身份验证的 MCP 客户端，包括本地 LLM 部署。

各平台的设置指南：

• Claude Web / Claude Desktop
• Claude Code
• ChatGPT
• Codex
• Mistral Le Chat
• Mistral Vibe

配置

Claude.ai / Claude Desktop

Settings → Connectors → Add custom connector：

• 名称：Tredict
• 远程 MCP 服务 URL：https://www.tredict.com/api/mcp/v2

首次使用时会自动处理 OAuth。

通用 MCP 客户端（Streamable HTTP）

{
  "mcpServers": {
    "tredict": {
      "url": "https://www.tredict.com/api/mcp/v2",
      "transport": { "type": "http" }
    }
  }
}

Personal API Token

对于不支持 OAuth 的客户端，请在 Tredict 的“Settings → Personal API / MCP”中创建访问令牌，并将其作为 bearer token 传入：

Authorization: Bearer <your-personal-api-token>

身份验证

该服务支持两种方式：

1. 带 PKCE 和客户端凭据的 OAuth 2.1。 推荐用于第三方 MCP 主机。权限范围粒度细致：activityRead、activityWrite、bodyvaluesRead。
2. 个人 API 令牌。 推荐用于自建 Agent 和本地大模型工作流。

完整详情请参阅 OAuth2 文档。

可用工具

MCP 客户端可以列出所有工具名称、描述和架构。括号内为权限范围。

活动

工具	描述	权限范围
activity-list	列出指定日期范围内已完成的活动	activityRead
activity	活动详情、指标和时间序列	activityRead
activity-update	更新活动标题和备注（非破坏性）	activityWrite
equipment-list	列出用户的所有装备（自行车、鞋、游泳及其他）	activityRead

计划

工具	描述	权限范围
plan-creation	在“My Plans”中创建可重复使用的训练计划	activityWrite
add-plan-training	向现有计划添加一项结构化训练	activityWrite
planned-workout-list	列出计划中／已安排的训练	activityRead
planned-workout	查看单项计划训练的详情和结构	activityRead
planned-workout-change-date	将计划训练改期至新日期	activityWrite
training-effort-list	查看所有 sportTypes 随时间变化的训练负荷	activityRead

身体、健康与能力

工具	描述	权限范围
bodyvalues	体重、体脂率、静息心率、身高等	bodyvaluesRead
capacity	每种 sportType 的能力值（HRmax、HRlth、FTP、FTPace）	bodyvaluesRead
hrv-list	心率变异性数据及基准值	bodyvaluesRead
sleep-list	睡眠数据及基准值	bodyvaluesRead
zones	每种 sportType 和 zoneType 的区间修订记录	bodyvaluesRead
zones-distribution	按 sportType 和月份汇总的区间分布	bodyvaluesRead

交互式 MCP 应用 UI 小组件

工具	描述	权限范围
show-activity-ui	在聊天中呈现活动详情、指标、分段和地图	activityRead
show-plan-ui	在聊天中以日历视图呈现可重复使用的训练计划	activityRead

提示词

主机可作为模板提供的预定义参数化任务：

• better-names：查找近期标题不佳的活动，并为其建议有意义的标题。
• coolest-training (year)：查找指定年份中最有趣的一次训练。
• compare-years (firstYear, otherYear)：深入比较两个年份。
• create-plan (monthsBack?, durationInWeeks?, workoutsPerWeeks?, sportTypes?, targetZonesTypes?)：根据近期历史记录制定完整训练计划。
• determine-ftp (sportType?)：根据训练历史推算当前 FTP。
• indepth-analysis：对近 2 年的训练状态进行深入评估。
• recreate-structured-workout (activityId)：根据已完成的活动重建可执行的结构化训练。

资源

URI	描述
mcp://tredict/assets/logo.svg	Tredict 矩形徽标（浅色／深色主题）
mcp://tredict/assets/logo-slogan.svg	带有“耐力运动员分析”标语的 Tredict 徽标
ui://widget/activity-ui-100.html	活动详情 UI 小组件（MCP 应用）
ui://widget/plan-ui-100.html	训练计划 UI 小组件（MCP 应用）

数据完整性

• 所有写入操作均可撤销。activity-update 会将先前的标题和备注保存在 mcpUpdatedFields 数组中，因此可以随时回滚任何更改。
• 该服务仅访问你自己的个人资料。如果你以朋友或教练的身份有权访问其他 Tredict 运动员的数据，这些数据对 MCP 服务仍不可见。

健康数据责任

某些响应，尤其是来自 plan-creation 的响应，会要求大模型展示健康和责任声明。用户注册 Tredict，即表示接受《使用条款》中定义的数据健康相关应用责任。大模型也会出错，不能替代合格的教练或您自己的判断。

隐私与控制

在用户明确配置之前，外部 MCP 客户端无法访问 Tredict 数据。创建令牌时，可以按范围限制读写权限。Tredict 完全符合 GDPR；请参阅《隐私政策》。请查看已连接 AI 提供商的隐私政策，了解通过其发送的数据将如何处理；也可以使用本地大模型，将所有数据保留在设备上。

链接

• 服务文档：MCP 服务文档
• 发布公告及示例：将 AI 助手和大模型与 Tredict MCP 服务搭配使用
• 常见问题：模型上下文协议与 AI 集成
• 术语表：耐力运动中的人工智能与 MCP