Cycling Coach AI
Entrenador de ciclismo con IA: planes de entrenamiento personalizados, entrenamientos diarios, nutrición, entrenamiento de fuerza, métricas de condición física (FTP, VO2Max) e integraciones con Strava, Garmin, Wahoo, MyWhoosh y Rouvy.
Documentación
Servidor MCP
Cycling Coach AI en tu IA favorita
Conecta Claude, Claude Desktop, Claude Code y otros asistentes de IA directamente a tu cuenta de Cycling Coach AI. Consulta tu plan de entrenamiento, registra entrenamientos, gestiona tu nutrición y más, todo desde el chat.
Ir a Cycling Coach AI
URL del servidor MCP https://app.usecoachai.com/api/mcp
Requisitos
1
Una cuenta de Cycling Coach AI
Cualquier plan activo. El acceso de lectura está disponible en todos los planes.
2
Un cliente MCP compatible
Claude.ai (web), Claude Desktop, Claude Code, o cualquier cliente MCP con soporte para Streamable HTTP.
Configuración paso a paso
Opción A
Claude.ai (web)
- Ve a claude.ai → Configuración → Integraciones
- Haz clic en "Añadir integración"
- Pega la URL del servidor:
https://app.usecoachai.com/api/mcp - Claude te redirigirá a Cycling Coach AI para autorizar el acceso
- Inicia sesión con tu cuenta y haz clic en "Autorizar"
- ¡Listo! Ahora puedes hablar con Claude sobre tu entrenamiento
Opción B
Claude Desktop / Claude Code
Añade esto a tu archivo de configuración de Claude:
{
"mcpServers": {
"cycling-coach-ai": {
"type": "http",
"url": "https://app.usecoachai.com/api/mcp"
}
}
}
Claude te pedirá autorización automáticamente la primera vez que uses una herramienta.
Opción C
Otros clientes MCP compatibles
El servidor implementa el protocolo MCP estándar con OAuth dinámico (RFC 7591). Cualquier cliente que soporte Streamable HTTP y Registro Dinámico de Clientes puede conectarse usando la URL:
https://app.usecoachai.com/api/mcp
Herramientas disponibles
Solo lectura
Consultas de datos
Estas herramientas no modifican ningún dato en tu cuenta.
| Herramienta | Descripción |
|---|---|
| get_user_plan | Obtiene el plan de entrenamiento para una fecha específica (principal, semanal o diario) |
| get_plan_week | Detalles completos de una semana del plan: sesiones, enfoque, objetivos de potencia/FC |
| get_today_training | Resumen de todo el entrenamiento del día: sesiones del plan, salidas rápidas y pruebas |
| get_plan_progress | Progreso del plan activo: sesiones completadas, racha, distancia total, % completado |
| get_daily_workouts | Salidas rápidas recientes fuera del plan |
| get_tests | Pruebas de rendimiento (FTP, test de rampa, sprint, VO2Max, etc.) y sus resultados |
| get_last_activities | Últimas 7 actividades registradas |
| get_fitness_metrics | Métricas de condición física: FTP, VO2Max, zonas |
| get_training_insights | Resumen agregado de los últimos N días: TSS, distancia, horas, FTP/VO2Max |
| get_user_information | Datos personales del atleta (edad, peso, altura, métricas) |
| get_user_data | Nombre, correo electrónico y datos de la cuenta |
| get_user_availability | Disponibilidad semanal configurada (horas por día) |
| get_payment_subscription | Estado de la suscripción |
| get_nutrition_plan | Plan de nutrición personalizado del atleta |
| get_all_races | Todas las carreras y eventos del atleta |
| get_race_analysis | Análisis completo de la carrera: rendimiento, zonas, fortalezas/debilidades |
| get_wellness_data | Datos de bienestar: sueño y VFC (variabilidad de la frecuencia cardíaca) de los últimos 7 días |
| platform_information | Información sobre las características y precios de la plataforma |
Escritura
Acciones y modificaciones
Estas herramientas modifican datos y requieren confirmación explícita del usuario antes de ejecutarse.
| Herramienta | Descripción |
|---|---|
| complete_training_with_activity | Marca una sesión como completada, vinculándola a una actividad de Strava |
| complete_strength_training | Marca una sesión de fuerza como completada |
| skip_training_session | Omite una sesión del plan |
| change_training_session_date | Mueve una sesión a otro día de la semana |
| send_training_session_to_garmin | Envía una sesión a tu dispositivo Garmin |
| send_training_session_to_wahoo | Envía una sesión a tu dispositivo Wahoo |
| send_week_to_garmin | Envía la semana completa a Garmin |
| send_week_to_wahoo | Envía la semana completa a Wahoo |
| edit_user_information | Actualiza datos personales (edad, peso, altura, FTP, FC, etc.) |
| edit_user_data | Actualiza nombre, apellido o correo electrónico |
| edit_user_availability | Edita la disponibilidad semanal completa |
| edit_user_availability_day | Edita la disponibilidad para un día específico |
| save_new_preference | Guarda una preferencia de entrenamiento (estilo, limitaciones, objetivos) |
| update_weight | Registra un nuevo peso corporal con historial |
| update_language | Cambia el idioma de la aplicación |
| log_meal | Registra o actualiza una comida del día |
| cancel_subscription | Cancela la suscripción (requiere confirmación explícita) |
Generación con IA
Creación impulsada por IA
Crea o regenera contenido usando IA. Requiere una suscripción activa.
| Herramienta | Descripción |
|---|---|
| create_new_plan | Crea un nuevo plan de entrenamiento personalizado |
| regenerate_training_week | Regenera una semana completa del plan |
| regenerate_training_session | Regenera una sesión específica |
| create_quick_ride | Crea un entrenamiento adicional fuera del plan (resistencia, intervalos, recuperación…) |
| create_test | Crea una prueba de rendimiento (FTP, rampa, sprint, VO2Max, etc.) |
| generate_nutrition_plan | Genera un plan de nutrición personalizado basado en el entrenamiento |
Permisos (scopes)
Al autorizar la aplicación, puedes elegir el nivel de acceso que necesitas.
| Ámbito | Acceso |
|---|---|
| mcp:read | Solo lectura: consultar plan, progreso, actividades |
| mcp:write | Lectura + escritura: registrar finalizaciones, editar datos, enviar a Garmin/Wahoo |
| mcp:generate | Todo lo anterior + generación con IA: crear/regenerar planes y entrenamientos |
| mcp | Acceso completo |
Preguntas frecuentes
¿Necesito una cuenta de pago?
No. El acceso de lectura de MCP (mcp:read) está disponible en todos los planes. Las herramientas de escritura y generación con IA requieren una suscripción activa.
¿Están seguros mis datos?
Sí. El acceso se autoriza mediante OAuth 2.0 estándar con PKCE. Tu contraseña nunca se comparte. Puedes revocar el acceso en cualquier momento desde app.usecoachai.com → Configuración → Integraciones MCP.
¿Con qué clientes MCP funciona?
Cualquier cliente que soporte MCP sobre Streamable HTTP con OAuth dinámico: Claude.ai, Claude Desktop, Claude Code y otros clientes MCP del ecosistema.
¿Qué pasa si Claude comete un error?
Las herramientas de escritura y generación están diseñadas para solicitar confirmación explícita antes de ejecutar acciones. Claude mostrará una propuesta y esperará tu aprobación antes de modificar cualquier dato.
¿Cómo revoco el acceso?
Ve a app.usecoachai.com → Configuración → Integraciones → Tokens MCP y elimina el token correspondiente.
Detalles técnicos
Transporte: Streamable HTTP. Autenticación: OAuth 2.0 con PKCE (S256) y Registro Dinámico de Clientes (RFC 7591). No se requiere secreto de cliente.
Empieza ahora
Conecta tu asistente de IA favorito a tu entrenamiento en menos de un minuto.
¿Tienes problemas con la integración? Contáctanos en[email protected]