Long Run Hybrid Coach

Chino tradicional · English · Chino simplificado

Long Run Hybrid Coach es un entrenador de híbrido personalizado no oficial, Intervals-first y agnóstico al dispositivo. Mantiene el mismo rumbo de 28 días y los planes de esta semana (carrera + fuerza); lee evidencia real y fiable de finalización, la revisa de forma continua y, cuando lo confirmas, puede enviar el plan al calendario de Intervals.icu.

Garmin no es un requisito de uso. Garmin es, actualmente, la primera ruta de dispositivo descendente con verificación real en dispositivo; Apple Watch, COROS, Polar, Suunto, Wahoo, otras aplicaciones y relojes, o incluso ningún reloj, pueden usar el mismo Coach. La diferencia está en cuánta evidencia fiable puede entrar en el bucle de entrenamiento y en si la ruta de sincronización posterior a Intervals.icu está verificada.

Para usuarios generales, elige primero el Hosted MCP: https://mcp.paceandstaystrong.com/mcp. Necesitas una cuenta de Intervals.icu, pero no tienes que crear tu propia app OAuth de Intervals ni operar tu propio gateway.

Inicio rápido: Hosted MCP

¿Qué necesitas para empezar?

1. Una cuenta de Intervals.icu.

2. Un cliente de IA que pueda conectarse a un MCP remoto y que ofrezca las acciones que este producto necesita.

3. Opcional: un reloj o una app de entrenamiento que ya sincronice actividades a Intervals.icu.

También se puede usar sin Garmin. Cuando no hay evidencia automática de recuperación, el Coach trata los datos que faltan como «unknown», no como 0.

1. Conectar con el Hosted MCP

Endpoint MCP:

https://mcp.paceandstaystrong.com/mcp

• claude.ai / Claude Desktop – En Settings → Connectors → Add custom connector, pega el endpoint. Esta ruta ya está completamente verificada con OAuth en producción, turnos de coaching y entrega a Intervals.

• ChatGPT: El MCP completo (incluidas las acciones de escrita/modificación) se ofrece actualmente en HTML de la versión beta para ChatGPT Business, Enterprise y Edu, según la documentación oficial de OpenAI. La MCP personalizada del plan Pro solo tiene lectura/búsqueda y no puede completar el flujo de escritura/entrega del plan. Si tu workspace admite MCP completo, crea una app personalizada en Apps / modo desarrollo y apunta al endpoint remoto de arriba. Para las restricciones más recientes, consulta la documentación oficial de OpenAI.

• OpenClaw: Usa openclaw mcp add apuntando al mismo endpoint, y añade --auth oauth; si una instancia es compartida por más de una persona, debes configurar la identidad OAuth como "per-requester", sino todos se conectarán a la misma cuenta de Intervals. Configuración en entrypoints/openclaw/.

• Otros clientes MCP: Apunta la misma URL a un servidor remoto Streamable HTTP MCP; para ejecutar el flujo completo dependerá de si el cliente soporta los comportamientos de MCP/OAuth que este producto requiere.

El estado de cada punto de entrada, ya sea «verificado real en dispositivo» o «empaquetado, esperando verificación real en conexión», viene definido en entrypoints/.

2. Autorizar Intervals.icu

En la primera conexión, el navegador abrirá la página de consentimiento de Intervals.icu. Inicia sesión con tu propia cuenta de Intervals.icu y autoriza los permisos que el Coach necesita:

• ACTIVITY:READ: leer las actividades realizadas.

• WELLNESS:READ: leer la evidencia de bienestar que pueden proporcionar Intervals.

• CALENDAR:WRITE: leer/escribir el calendario de entrenamiento para que las sesiones confirmadas puedan entregarse y verificarse read-back.

• SETTINGS:WRITE: leer la configuración; y. completed, se incluye una flecha clave que falta y tiene evidencia de apoyo. Solo cuando el flujo de entrega real lo necesite.

La página de consentimiento de Intervals separa los permisos. Si omites una, las capacidades que dependen de ese permiso fallarán de forma visible; vuelve a conectar y añade el permiso. No peguen tu contraseña de Intervals, API key ni token.

3. Pregunta directamente como a un entrenador normal

No hace falta rellenar un cuestionario previo; por ejemplo:

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

o casi:

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

El Coach leerá primero toda la evidencia que ya exista y, después, solo preguntara las brechas que realmente cambian la decisión, como los días entrenables de esta semana, el equipo disponible o o baseline de fuerza que el proveedor no puede saber.

4. Mirar primero la vista previa de 30 días, después confirmar el plan

Al crear el plan por primera vez verás:

• Santa: sesiones exactas, ejecutables y entregables.

• Las tres semanas siguientes: una outlook orientativa, sin simular que ya se saben todos los detalles.

Solo tras confirmar esa vista previa se escribe el plan. Los cambios semanales siguientes tienen la misma experiencia:

vista previa de la situación / después → una confirmación → aplicar.

5. Para enviarlo al calendario, haga la confirmación de entrega

La entrega es otra confirmación independiente:

entrega vista previa →'una confirmación → escribir en Intervals.icu → verificación read-back.

El estado más lejano que este producto pueden demostrar es intervals_accepted. Intervals éxito no significa que las sesiones estén en Garmin, Apple Watch u otro reloj. La sincronización de Intervals es un salto externo y verificación por ruta cada entidad.

Related MCP server: Transition MCP

¿Qué papel juega Intervals.icu en este producto?

Intervals.icu es el centro =hub de interoperabilidad actual: recibe las evidencias de actividad y bienestar desde diferentes dispositivos / apps para el Coach, y también acepta las sesiones confirmadas. No es la fuente de la verdad del PlanState.

手錶 / 訓練 app
      │
      ▼
 Intervals.icu ───── 已完成活動 + wellness evidence ─────► Coach
      ▲                                                   │
      │                                                   │
      └────────── 確認後的 calendar workout ◄────────────┘
      │
      ▼
Garmin / Apple Watch bridge / 其他下游同步

División de responsabilidades:

• Intervals.icu: integrar la evidencia externa de entrenamiento y lleva el calendario del proveedor.

• Long Run Hybrid Coach: mantener el único estado actual del plan, el historial de decisiones, la evidencia declarada por el atleta, el binding confirmado y el flujo de coaching.

• Tu reloj / app: puede llevar actividades hacia Intervals y también recibir entrenamientos enviados por este; pero comprobar que el último tramo funcione es una evidencia de compatibilidad independiente.

¿Necesito algo más si ya tengo datos en Intervals?

No, solo es necesaria la cuenta en sí. Si ya se sincronizan actividades y bienestar al, la evidencia automática del Coach será más completa; los campos que no existen se consideran unknown, no como 0, y no por un dato opcional que falte se bloquea el a rutina normal.

Puedes especificar en la conversación lo que el dispositivo no llega a medir o no está sincronizado, por ejemplo:

• las series, pesos y repeticiones reales del entrenamiento de fuerza;

• tu disponibilidad semanal y restricción de equipo;

• peso /% de grasa corporal;

• una sesión sin dispositivo;

• estados subjetivos como «últimamente me siento muy cansado» o «n duermo bien»;

• los valores de recuperación reales que ves en tu reloj / app, como sleepla, HRVm, HR en reposo, readiness, etc.

El Coach no convierte un «estoy muy cansado» en una puntuación de readiness falsa.

Hosted MCP vs Local / Self-hosted MCP

La única diferencia que realmente notarás es esta: Hosted MCP puedes usarla directamente desde el móvil; Local MCP solo puedes usarla desde el servidor de gateway el que la ejecuta. Todo lo demás líneas son la costo de esta diferencia.

La ruta más corta para Hosted MCP

1. Añade un sender / conector MCP remoto en el cliente MCP que admita el flujo:.

2. Pega https://mcp.paceandstaystrong.com/mcp como URL.

3. Completa el flujo OAuth del cliente.

4. En el navegador, autoriza Intervals.icu.

5. Vuelto vuelve al chat y formula la primera pregunta de coaching.

El servicio alojado se encarga de dynamic client registration, PKCE, token de gateway y la map del propietario por atleta; no necesitas owner id, athlete id, API key, Intervals client secret o variables de entorno de servidor.

¿Cómo se ejecuta local / self-hosted?

El repositorio requiere Python 3.11; el producto en verdad no usa dependencias externas, no es necesario instalar packages Python.

1. Clona el repositorio.

2. Crea una aplicación OAuth en Intervals.icu. No hay interfaz self-service pública; según la documentación oficial OAuth: proporciona nombre de la app, descripción, web, logo, política de privacidad, URI de redirección y tu tu Intervals ID envía. La app aparno, en Settings → Manage App obtienes client_id y secret. Consulta Intervals.icu + OAuth support.

3. En la aplicación de Intervals configuro el callback de tu gateway: <gateway-origin>/oauth/callback. Un cliente local pode usa loopback; un cliente remoto necesita un túnel HTTPS/seguro accesible.

4. Configura las variables de entorno necesarias:

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="..."

5. Inicia:

python3 -m garmin_coach_loop.cli serve-gateway --host 127.0.0.1 --port 8422

6. Apunta el cliente MCP local a:

http://127.0.0.1:8422/mcp

Si lo vas a ofrecer a un cliente remoto, no trates esto como runbook manual. Persistent volume, TLS, entrusted origin, single replica, release identity y deployment verification aparecen en docs/deploy-gateway.md.

Local CLI no debería convertirse en una segunda version “current plan” sin avisar

Cada atleta debe tener un único writer/conductor actual. Cuando la configuración local con GARMIN_COACH_LOOP_GATEWAY_URL apunta al coach alojado, las escrituras al almacén local se bloquean por defecto; solo sabes que --offline significa “estoy haciendo deliberadamente otra segunda versión local del plan”.

Quienes ya tengan estado local pueden migrar a hosted siguiendo docs/ufs/migrate-local-store-to-hosted.md.

¿Qué puede hacer ahora?

• Mantener una dirección de 28 días mas la semana actual con sesiones precisas y las próximas, siguientes 3 semanas.

• Leer evidencia de actividades / salud / calendario de Intervals y conciliación automática de lo planeado con real vuelta al plan actual.

• Mezclar en el mismo plan 5 y entrenamiento de fuerza.

• Registrar perfil atletado, disponibilidad, objetivo de distancia lejanía, preferencias de entrenamiento, fuerza real, peso / esto es lo importante, y bienestar, y estados subjetivos.

• startCoachSession recibe los datos de recuperación de esa request; la Web no necesita ni accede a la base de datos de salud local.

• Importar evidencia histórica compatible, incluidos CSV en formatos soportados, contenido Apple Health XML, y / processed FIT.

• Las sesiones pueden llevar un coach_note para incluir las notas del coach en los eventos de Intervals, no crear otra gramática de entrenamiento.

• Auditorías semanales: qué se ha hecho, si hay datos de prospecto, cuál es el siguiente paso., no dar over just complete workout for increased Fitness.

• Los cambios repetitivos plan primero vistos, luego se aplican.

• Entrega de calendario con preview y una confirmación; soporta seguridad intentar, retry, replace, and delete of продукта.

• Export directo / borrado final definitivo y de dos etapas de owner data en el chat.

Límites importantes

• startCoachSession es deterministic reconciliation y puede escribir una nueva version del PlanState. Si solo quiere lectura sin side effects, usa getCoachState.

• Las actividades reportadas por el atletas son evidencia, no podrán ser transformadas silenciosamente en completas reales validadas.

• Las recuperaciones numéricas solo admiten métricas reales del dispositivo; de cultural no hay texto y deduces un números.

• No hacer diagnóstico médico.

• La evidencia de delivery solo es up to Intervals read-back; no hay rastro hasta disposit.

• Never store raw recovery; en mode hosted no se archive the input data of request.

• No not Monitoring mono...

Datos, exportación y borrado

The storage locations either inmanate or owner owner hierarch: PlanState version chain, decision / receipts, athlete-reported evidences, identity maps, and unresolved delivery data.

Cuando se exporta, ** NO ** deliberate omit: El OAuth fingerprint, el raíz proveedor de raw payload locations and the internal owner id. Fingerprint fingerprint is a one-way checksum is calculated; raw GPS / activity files should be provided by provider; owner id is used as a storage locator.

Los tres grandes límites en el borrado de datos; el producto no está involucrad en:

• los workouts ya escritos en el calendario de Intervals.icu;

• la potestador de que dar authorization en Intervals;

• logs de operación platform minimal, newestelinequeles, no de datos privados; Normas of sim 360 see docs/account-benefits.md, also complete privacy políticas paceandstaystrong.com/privacy.html.

Limitaciones actualmente

• el Coach no accede directamente a Apple Health, Garmin Connect or any other device islands; the main automatic entry will be the Intervals circumference.

• Hosted no persiste la carga de datos de recuperación de cada request; utiliza los sample de las sesiones

• No predictivos opciones per inter

• Notifications are the edge of the "unusual".

Superficie del producto y documentación

• "Actual release presenta: 22, 2?

• 22 MCP tools, 2 prompt templates, 30 CLI commands,

• 2 app release: 2 motowers regexes (?) Wait.

Let's correctly write:

"El release actual expone 22 herramientas MCP, 2 prompts, 30 comandos CLI, 3 contratos JSON Schema y 5 tablas de identidad." The numbers are verifies through tests.

• docs/user-story.md

• docs/data-sources.md

• entrypoints/

• entrypoints/mcp/README.md

• docs/deploy-gateway.md

• docs/account-lifecycle.md

• docs/distribution/

• docs/release-inventory.md

• AGENTS.md

Long Run Hybrid Coach es un proyecto independiente, sin afiliación, respaldo ni sponsor de Garmin, Intervals.icu, Apple or other device / platform suppliers. El código está bajo Licencia MIT.