プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Long Run Hybrid Coach

作者:atomchungバージョン 1.4.10i★ 6iクラウドで動く公式サイト ↗
レジストリ名io.github.atomchung/long-run-hybrid-coach

インストール方法

What it does

Adaptive running and strength coaching for the long run.

  • Connects クラウドで動く
  • Account or key Sign in to the service when you connect (OAuth)
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気10/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア30/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Long Run Hybrid Coach をインストールして。https://mcp.popnx.com/i/atomchung-long-run-hybrid-coach.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp.paceandstaystrong.com)を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Long Run Hybrid Coach
    Remote MCP server URL · アドレスhttps://mcp.paceandstaystrong.com/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsLong Run Hybrid Coach

  4. 試してみる

    Long Run Hybrid Coach を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Long Run Hybrid Coach を使っていると言うか、回答に Long Run Hybrid Coach のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Long Run Hybrid Coach
    Connection · アドレスhttps://mcp.paceandstaystrong.com/mcp
  3. チャットで Long Run Hybrid Coach を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Long Run Hybrid Coach を選びます

  4. 試してみる

    Long Run Hybrid Coach を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Long Run Hybrid Coach を使っていると言うか、回答に Long Run Hybrid Coach のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user long-run-hybrid-coach https://mcp.paceandstaystrong.com/mcp
  3. Claude Code で /mcp と入力

    Long Run Hybrid Coach が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Long Run Hybrid Coach を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Long Run Hybrid Coach を使っていると言うか、回答に Long Run Hybrid Coach のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Long Run Hybrid Coach を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Long Run Hybrid Coach を使っていると言うか、回答に Long Run Hybrid Coach のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Long Run Hybrid Coach を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Long Run Hybrid Coach を使っていると言うか、回答に Long Run Hybrid Coach のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.paceandstaystrong.com/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Long Run Hybrid Coach を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user long-run-hybrid-coach https://mcp.paceandstaystrong.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "long-run-hybrid-coach": {
      "url": "https://mcp.paceandstaystrong.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "long-run-hybrid-coach": {
      "type": "http",
      "url": "https://mcp.paceandstaystrong.com/mcp"
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
1.4.10
カテゴリi
その他
レジストリ公開日i
2026年9月14日
コードの最終更新i
2026年11月13日
最終確認
2026年11月18日
作者
atomchung
ウェブサイト
paceandstaystrong.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント atomchung で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:6 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    262ミリ秒で応答(HTTP 401)

  • ✓ 合格

    OAuthでサインイン

    OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

クラウドのアドレスは直近 4 回中 4 回応答 · 最新 262 ms · 確認日 2026年11月18日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/atomchung-long-run-hybrid-coach.svg)](https://mcp.popnx.com/en/servers/atomchung-long-run-hybrid-coach)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20653件のうち95%よりスターが多い
  • このカテゴリのほかの20653件のうち39%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20653件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Long Run Hybrid Coachは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は6 日前、最新バージョン(1.4.10)がレジストリに届いたのは2 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Long Run Hybrid Coach
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/44/44/41/44/4
ライセンスMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Long Run Hybrid Coach

繁體中文 · English · 简体中文

官網 paceandstaystrong.com | 遇到問題看支援頁

把一個網址貼進 Claude 或 ChatGPT,你就有一個讀得到你真實訓練的教練。

它讀你 Intervals.icu 帳號裡的活動與恢復數據,維持同一份 28 天的跑步+重訓方向與本週課表,拿計畫去對你實際做了什麼,並在你同意之後,把每一堂課排進你的日曆。免費使用,沒有付費方案。

Garmin 不是使用前提。 Garmin 只是目前第一條做過實機驗證的下游裝置路徑;Apple Watch、COROS、Polar、Suunto、Wahoo、其他 app/手錶,甚至沒有手錶,都可以用同一個教練。差別在於有多少可信的訓練紀錄能進到教練手上,以及 Intervals 後面那段裝置同步是否已經被驗證過。

一般使用者直接用託管版: https://mcp.paceandstaystrong.com/mcp。你需要一個 Intervals.icu 帳號,但不需要自己向 Intervals 申請 OAuth App,也不需要自己維運伺服器。


連接:兩步

官網把同一條流程拆成四個點擊步驟走一次:開始使用。

你需要什麼
  1. 一個 Intervals.icu 帳號。 免費,用 Google 登入大約 30 秒就能開好。
  2. Claude 或 ChatGPT。
  • Claude(claude.ai/Claude Desktop):免費方案就可以,免費帳號限一個自訂連接器。這條路徑已經做過完整實機驗證——production OAuth、教練對話、以及把課表送進 Intervals。
  • ChatGPT:目前需要 Business、Enterprise 或 Edu 的網頁版 workspace,在 Apps/developer mode 建立 custom app。個人方案的 custom MCP 只有 read/fetch,跑不完本產品「寫計畫+交付課表」的流程。ChatGPT 外掛程式目錄上另有這個教練的 Plugin 版。最新限制以 OpenAI 官方說明 為準。
  • 其他 MCP client:OpenClaw 與自架 client 見下面一節。
  1. 選配:已經會把活動同步進 Intervals.icu 的手錶或訓練 app。沒有手錶也可以用——教練會把拿不到的欄位當成「不知道」,不會當成 0。
第一步:把網址貼進你的 AI

在 AI 的連接器設定裡新增一個 remote MCP server,網址是:

https://mcp.paceandstaystrong.com/mcp
  • claude.ai/Claude Desktop:Settings → Connectors → Add custom connector → 貼上網址。
  • ChatGPT:Apps/developer mode → 建立 custom app → 指到同一個網址。

沒有別的欄位要填,也沒有金鑰要貼。

第二步:授權 Intervals.icu

瀏覽器會開 Intervals.icu 的同意頁。登入你自己的 Intervals.icu 帳號,四個權限都勾起來:

權限教練拿它做什麼
ACTIVITY:READ讀你已完成的訓練。
WELLNESS:READ讀 Intervals 手上的恢復數據。
CALENDAR:WRITE讀寫訓練日曆,讓你確認過的課表能送進去,並讀回來核對。
SETTINGS:WRITE讀你的門檻配速。它唯一會寫進去的,是你還沒有的門檻配速,發生在你已經確認過的課表交付當下;已經設好的絕不覆寫。

Intervals 也有只讀的設定權限;這裡要寫入,是因為上面那個補值動作真的會寫。它之所以需要,是因為 Intervals 這邊沒有門檻配速時,它照樣收下有配速的課表,但往手錶送的時候會把配速目標拿掉——你會收到距離正確、卻沒有任何目標的一堂課。少勾任何一個權限,需要它的功能就會壞掉,而且不容易看出原因;重新連線補上即可。

不要把 Intervals 密碼、API key 或 token 貼進對話。

在 ChatGPT 安裝 Plugin 版

ChatGPT 的外掛程式目錄上有這個教練的 Plugin 版,不用貼網址。先準備好一個 Intervals.icu 帳號,而且手錶的訓練紀錄已經同步進去。

  1. 開啟 Long Run Hybrid Coach 的安裝頁,按「安裝外掛程式」。還沒登入 ChatGPT 的話,會先請你登入。
  2. 連接時登入你自己的 Intervals.icu 帳號並同意。Plugin 版只要三項權限:ACTIVITY:READ、CALENDAR:WRITE、SETTINGS:WRITE。
  3. 在 ChatGPT 的對話裡問它,例如「讀我最近的訓練,告訴我這週該怎麼練。」

Plugin 版從 Intervals.icu 只讀你完成的訓練(活動、配速、運動心率、訓練負荷),不讀那裡的恢復數據。它的計畫和完整版(上面的個人 MCP 連線,https://mcp.paceandstaystrong.com/mcp)各自獨立,不互通。

Intervals 帳號是新的或空的?

教練讀的是 Intervals.icu 裡已經有的東西。帳號是新的話,有兩條路把歷史補進去:

  • 接上你原本就在用的裝置或 app。 在 Intervals.icu 自己的 Settings 裡連 Garmin 或你的手錶/訓練 app,過去的活動會自動補上。資料到了之後,再請教練重新讀一次。
  • 把匯出檔直接交給教練。 在對話裡給它 CSV、Apple Health 匯出檔或 .fit 檔,請它匯入。同檔與同一場活動會自動去重,判斷不了才回頭問你。(檔案是給教練的,不會進 Intervals.icu。)

裝置量不到的東西也可以直接在對話裡講:重訓的實際組數重量次數、本週能練的時間與器材、體重體脂、沒帶錶的那一場、「最近很累」「睡不好」,以及你從手錶上實際看到的睡眠、HRV、靜止心率、readiness 數字。教練不會把一句「我很累」偷偷翻成一個假的 readiness 分數。


連上之後會發生什麼

直接問正常的教練問題

不用先填問卷:

讀我最近的訓練,告訴我這週該怎麼練。

或:

我想提升 VO2max,又不想掉力量,幫我排第一個 28 天方向。

教練會先讀已經有的資料,再只問真正會改變決策的缺口——例如本週可練日、器材,或裝置不可能知道的重訓基準。

第一次會先看 28 天預覽,你同意才寫進去
  • 本週:精確、可執行、可以直接送進日曆的課。
  • 後三週:大方向,不假裝現在就知道所有細節。

之後每一次改動也是同一條體驗:改動前後對照 → 你同意一次 → 才寫入。

要送進日曆時,再確認一次

交付是另一個獨立確認:課表預覽 → 你同意一次 → 寫進 Intervals.icu → 讀回來核對。

預覽會先說明這次要寫進哪一個 Intervals.icu 帳號——先講 Intervals 上的 email,再講顯示名稱,所以同時有正式帳號和測試帳號的人,在寫進去之前就看得出來是哪一個。email 放前面,是因為自己的兩個帳號常常取同一個顯示名稱。兩者都是當下向 Intervals 讀的,只用在這一次回答,不會被存下來。

本產品能證明的最遠一步是 Intervals.icu 收下了。Intervals 成功不等於課表已經在 Garmin、Apple Watch 或其他手錶上——Intervals 後面那段同步是外部路徑,要各自驗證。


Intervals.icu 在這個產品裡做什麼?

Intervals.icu 是目前的中轉站:它幫教練接住不同裝置/app 的活動與恢復數據,也承接教練確認後的日曆課表。它不是計畫本身的存放處。

手錶 / 訓練 app

│ ▼ Intervals.icu ───── 已完成活動 + 恢復數據 ─────► 教練 ▲ │ │ │ └────────── 你確認過的日曆課表 ◄───────────┘ │ ▼ Garmin / Apple Watch / 其他下游同步

責任分工:

  • Intervals.icu:整合外部訓練資料,並持有日曆。
  • Long Run Hybrid Coach:持有唯一的當前計畫、決策歷史、你自己回報的紀錄、每一次確認的綁定,以及整條教練流程。
  • 你的手錶/app:可以把活動帶進 Intervals,也可能接收 Intervals 往下送的課表;但最後一哩是否成功,要獨立驗證。

只有帳號本身是必要條件。Intervals 裡已經有活動與恢復數據的話,教練自動拿得到的資料會比較完整;沒有的欄位保持「不知道」,不會被當成 0,也不會因為少一個選配數值就把一般教練對話擋掉。


託管版 vs 自架

實際會感覺到的差別只有一個:託管版你在手機上就能直接用;自架只有在跑伺服器的那台電腦上能用。下面每一行都是這個差別的成本。

託管版(推薦)自架
手機上能用嗎能——連一個有手機 App 的 client 就好不能,除非你自己把伺服器對外開放並處理 TLS
網址https://mcp.paceandstaystrong.com/mcp你自己的伺服器,例如 http://127.0.0.1:8422/mcp
維運不用自己管自己啟動、更新、備份與維運
Intervals OAuth App不需要需要自己的 OAuth application 憑證
計畫存哪託管端、以每位使用者為範圍你自己的伺服器 state root
適合誰一般使用者、多個 client 共用同一份計畫開發者、需要完全自管環境/資料的人

託管版會自己處理 dynamic client registration、PKCE、token 與使用者對應;一般使用者不需要任何 id、API key、client secret 或環境變數。

其他 MCP client
  • OpenClaw:用 openclaw mcp add 指到同一個網址,加上 --auth oauth。一個 instance 若不只一個人用,要把 OAuth identity 設成 per-requester,否則所有人會連到同一個 Intervals 帳號。設定見 entrypoints/openclaw/。
  • 其他:把同一個網址設成 remote Streamable HTTP MCP server。跑在你自己機器上的 client(OAuth callback 落在 loopback)可以直接連;跑在雲端主機、用自己網域接 callback 的 client 也能自行註冊連上,只是在進到 Intervals 授權之前,會先看到本產品自己的一頁確認畫面,上面寫明授權會被送到哪一個 origin,按下 Continue 才會繼續。該 origin 若已被維運者驗證並加進清單,就直接跳過這一頁。細節見 entrypoints/mcp/README.md。

逐入口「已完整實機驗證」或「已封裝、等待真實連線驗證」的狀態,以 entrypoints/ 為準。

自架怎麼跑?

Repo 使用 Python 3.11,只有一個釘死版本的依賴:官方 MCP Python SDK(requirements.txt 寫版本,requirements.lock 連同它解析出的每個套件一起釘死 sha256),它負責 /mcp 的協定與傳輸層。教練判斷、驗證、store、交付與身分都仍然只用標準函式庫。

  1. Clone repo,然後 python3 -m pip install --require-hashes -r requirements.lock。
  2. 向 Intervals.icu 申請建立 OAuth application。 Intervals 目前的公開流程不是在 Settings 自助新增:依官方說明提供 app name、description、website、logo、privacy policy、redirect URI 與你的 Intervals ID;app 建立後才會出現在 Settings,從 Manage App 取得 client_id / secret。流程見 Intervals.icu OAuth support。
  3. 在 Intervals app 裡註冊 callback: /oauth/callback。本機 client 可以走 loopback;remote client 需要可達的 HTTPS 或安全通道。
  4. 設定必要環境變數:
export GARMIN_COACH_LOOP_GATEWAY_STATE_ROOT="$HOME/.local/share/long-run-hybrid-coach-gateway"

export GARMIN_COACH_LOOP_TOKEN_HMAC_KEY="$(openssl rand -base64 32)" export GARMIN_COACH_LOOP_INTERVALS_CLIENT_ID="..." export GARMIN_COACH_LOOP_INTERVALS_CLIENT_SECRET="..."

  1. 啟動:
python3 -m garmin_coach_loop.cli serve-gateway --host 127.0.0.1 --port 8422
  1. 本機 MCP client 指到 http://127.0.0.1:8422/mcp。

要正式提供給 remote client 的話,不要把 loopback 範例當 production runbook。Persistent volume、TLS、信任的 client origin、single replica、release identity 與部署驗證見 docs/deploy-gateway.md。

一個人只該有一份當前計畫

本機設定 GARMIN_COACH_LOOP_GATEWAY_URL 指向託管版時,本機寫入預設會被擋;只有明確加 --offline 才代表「我刻意在做另一份本機計畫」。已經有本機資料的人可以搬到託管版,流程見 docs/ops/migrate-local-store-to-hosted.md。


現在可以做什麼?

  • 維護一份 28 天方向:本週精確的課 + 後三週大方向。
  • 讀 Intervals 的活動、恢復數據與日曆,把可信的「排了什麼 vs 實際做了什麼」自動對回當前計畫。
  • 在同一份週計畫裡同時處理跑步與重訓。
  • 記錄你自己回報的東西:個人資料、可練時間、長期目標、訓練習慣、實際重訓、體重體脂、裝置沒錄到的活動,以及主觀狀態。
  • 每次對話可以帶入當下的恢復數字。託管版不會、也不需要去讀你電腦上的健康資料庫。
  • 匯入歷史資料:支援格式的 CSV、Apple Health XML,以及 FIT 檔。同檔與同一場活動會自動去重,判斷不了才問你。
  • 課表可以帶一段教練備註一起進 Intervals,而不是偷偷長出第二套課表寫法。
  • 每週複盤「實際練了什麼、有沒有進步的證據、下一步是什麼」,而不是把「課表做完」直接當成體能提升。
  • 計畫變更先看對照,同意後才套用。
  • 日曆交付先看預覽,同意後才寫入;支援安全重試、取代與撤回本產品自己送出去的課表。
  • 在對話裡直接匯出本產品持有的資料。刪除整個帳號改為寫信申請,教練會直接給你說明要寄什麼的頁面。
重要邊界
  • 開始一次教練對話會做自動對帳,可能寫入新的計畫版本。只想看目前存了什麼、完全不動到資料的話,用唯讀的那條路徑(getCoachState)。
  • 你自己回報的活動是佐證資料,不會被偷偷升格成裝置確認的完成紀錄。
  • 恢復數字只接受真的觀察值;模型不可以從文字自己猜一個數字出來。
  • 本產品不做醫療診斷。
  • 交付的證據只到 Intervals 讀回來核對,不會聲稱已經到手錶。

資料、匯出與刪除

託管端保存維持同一份計畫所必要的東西:計畫的版本鏈、決策與回執、你自己回報的紀錄、身分對應,以及還沒收斂的交付紀錄。

匯出時刻意不包含三樣東西:授權憑證的 fingerprint(單向的指紋,只拿來做內部記帳)、供應商的原始 payload 與 GPS 軌跡(原始活動檔應該跟供應商拿),以及內部的 owner id(本產品自己的儲存位置編號)。

刪除也有三個明確邊界,這三件不在本產品能刪的範圍:

  • 已經寫進 Intervals.icu 日曆的課表;
  • 你在 Intervals.icu Settings 給出的授權;
  • 不含計畫、健康或身分內容的最小化平台營運紀錄。

匯出在對話裡自己做。刪除整個帳號是寫信申請,流程在支援頁:要的是你的 Intervals.icu athlete id,以及一張 Intervals.icu Settings 頁的截圖;不會跟你要密碼、API key 或 token。在對話裡要求刪除全部資料,教練只會給你這一頁——在你寄信之前,沒有提交,也沒有刪除任何東西。

1.4.5 之前刪除是兩次 tool call 加一次確認。有些 AI 用戶端會在自己的核准層擋掉那次確認,服務端完全收不到訊息,使用者手上只剩一份預覽、資料沒被刪掉。改成一條一定走得完的路,取代兩條中間可能斷掉的路。

完整生命週期見 docs/account-lifecycle.md,公開隱私政策在 paceandstaystrong.com/zh/privacy.html(英文版為準)。


目前限制

  • 教練不直接登入 Apple Health、Garmin Connect 或其他裝置帳號;主要的自動資料路徑目前仍是 Intervals.icu。
  • 託管版會按日期保存你提供的睡眠分數、睡眠時長、昨夜 HRV 與靜息心率,直到你刪除帳號資料。教練每次讀取最近 28 天,這不是保存期限;其他傳入的恢復數字只供當次判斷。要拿掉某一天的恢復紀錄,說那天的紀錄不算即可,但那一天是整筆拿掉,不能只留其中一個數字,詳見 資料說明。
  • 本產品不觀察 Intervals 之後的每一段裝置同步,因此不會把「Intervals 收下了」說成「已經在手錶上」。
  • 自架是給開發者/自管的人;一般使用者應優先用託管版。
  • 裝置相容性是逐條路徑的證據,不會因為 Garmin 已驗證就推論其他裝置一定相同。
  • 這是一個人的專案,不是公司。不保證服務不中斷,也可能改變。

遇到問題

  • [支援頁](https://paceandstaystrong.com/zh/support.html):匯出、刪除、更正、撤銷授權。匯出與更正你在對話裡自己做;刪除整個帳號是這一頁說明的寫信申請。上面也有直接寄給開發者的信箱。
  • [Issue tracker](https://github.com/atomchung/long-run-hybrid-coach/issues):bug 與功能建議。它是公開且永久的,不要貼健康/訓練/計畫內容、Intervals 的 athlete id、token 或任何憑證。要指認自己的帳號,用你資料匯出檔裡那個不可還原的參照碼就夠了。
  • 認為是資安或隱私漏洞的話,不要公開描述,直接寄信。

技術文件

目前 release 對外有 24 個 MCP tool、2 個 prompt、34 個 CLI 指令、4 份 JSON Schema contract、12 張 identity 表。這些數量由測試從真實程式碼推導,避免這份文件自己走鐘。

Long Run Hybrid Coach 是獨立專案,與 Garmin、Intervals.icu、Apple 或其他裝置/平台供應商沒有隸屬、背書或贊助關係。程式碼以 MIT License 釋出。