프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 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 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.

내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude가 Long Run Hybrid Coach을 쓰고 있다고 하거나 답에 Long Run Hybrid Coach 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT 연결은 요금제에 따라 달라요

전체 MCP: 웹 ChatGPT Business, Enterprise, Edu · Pro: 읽기/가져오기 권한으로 연결, 데이터를 바꾸는 도구는 안 될 수 있어요 · Plus: 공식 문서 미확인, 플러그인 화면에 사용자 지정 MCP 추가 항목이 보이면 시도해 볼 수 있어요 · 웹만

  1. 웹 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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이 목록에 있고 연결됨으로 보이면 돼요

  4. 해 보기

    Long Run Hybrid Coach을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ 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을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ VS Code가 Long Run Hybrid Coach을 쓰고 있다고 하거나 답에 Long Run Hybrid Coach 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

웹으로 연결하는 앱용 주소

주소https://mcp.paceandstaystrong.com/mcp

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Long Run Hybrid Coach을 쓰는 사람에게 물어보세요💬 토론 →
개발자용: 터미널 명령과 JSON 설정

웹으로 연결

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월 17일
제작자
atomchung
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

인터넷으로 연결하는 앱

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

모든 앱과 장단점 →

할 수 있는 일

서버가 도구 목록을 보여 주기 전에 로그인을 요구해요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 18일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 atomchung 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 5일 전

  • ✓ 통과

    라이선스 있음

    MIT 사용

  • ✓ 통과

    엔드포인트 응답

    202ms 만에 응답(HTTP 401)

  • ✓ 통과

    OAuth로 로그인

    OAuth 로그인을 지원한다고 밝혀서, AI 앱이 로그인 화면으로 안내해 줘요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    아직 점검하지 않았어요. 엔드포인트를 점검할 때 도구 목록을 읽어요

클라우드 주소가 최근 3번 중 3번 응답 · 최근 202 ms · 확인 2026년 11월 17일

우리가 확인하는 것 → · 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

  • 이 카테고리의 다른 서버 20575개 중 95%보다 스타가 많아요
  • 이 카테고리의 다른 서버 20575개 중 39%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 20575개 중 99%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Long Run Hybrid Coach, 안전한가요?

해당하는 기본 점검 5개 중 5개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 5일 전 변경됐고, 최신 버전(1.4.10)은 2개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 받는 앱에서도 쓸 수 있어요. 예: 웹 ChatGPT(Business 이상은 전체 MCP, Pro는 읽기 전용).

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

World Monitor

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

제작자: koala73널리 사용됨★ 9.1만그저께 업데이트

클라우드에서 실행✓ 서비스 회사 · worldmonitor.app

openstatus

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

제작자: openstatusHQ널리 사용됨★ 9.3천2개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · openstatus.dev

Strata

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

제작자: Klavis-AI성장 중★ 5.8천14개월 전 업데이트

클라우드에서 실행저장소 보관됨✓ klavis.ai

Jitsu

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

제작자: jitsucom널리 사용됨★ 5.1천4개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · 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 目錄上架。最新限制以 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 貼進對話。

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 釋出。