Servidor MCP
Tu entrenamiento, dentro de Claude y ChatGPT
Conecta a OpenAthlete el asistente que ya pagas. Lee tu calendario, tus actividades y tu forma y, con tu permiso, planifica un bloque de 12 semanas directamente en tu calendario. Desde ahí, las sesiones van a tu reloj.
- 23 herramientas
- Gratis en todos los planes
- OAuth, lectura y escritura separadas
Hazme un plan de 12 semanas para un maratón el 14 de marzo, 5 salidas por semana, tirada larga los domingos.
- get_athlete_contextzonas, VAM, frescura −6
- get_training_volumeúltimas 12 semanas
- plan_sessions60 sesiones, 4 bloques
Tu plan ya está en el calendario: 60 sesiones en 4 bloques, umbral los martes, tiradas largas de 1h30 a 2h50 los domingos, una semana más suave cada cuatro y dos semanas de puesta a punto. Los entrenamientos llegarán a tu Garmin a medida que se acerquen sus fechas.
En un párrafo
Qué es MCP
El Model Context Protocol es un estándar abierto que permite a un asistente de IA usar herramientas que ofrece otra app. OpenAthlete es un servidor MCP: una vez conectado, Claude o ChatGPT pueden llamar a funciones como get_training_load o plan_sessions en tu cuenta, igual que tú harías clic en la app. El modelo se ejecuta del lado de tu asistente, así que a OpenAthlete no le cuesta nada, y a ti tampoco: el servidor MCP es gratis en todos los planes, incluidas las instancias autoalojadas.
Ejemplos
Qué puedes pedir
Cuatro peticiones y las herramientas que usa el asistente para responderlas.
“Hazme un plan de 12 semanas para un maratón el 14 de marzo, 5 salidas por semana, con la tirada larga los domingos.”
get_athlete_context→get_training_load→get_training_volume→plan_sessions“Tengo fiebre desde ayer. Adapta mis próximas dos semanas.”
create_period→get_calendar→move_sessions→update_session“¿Cómo fue la semana pasada respecto al plan? ¿Llego en buena forma a la carrera del sábado?”
get_calendar→get_activity→get_training_load“Mi nuevo FTP es 265 W: regístralo y actualiza mis zonas de potencia.”
log_metrics→update_training_zoneHerramientas
23 herramientas: calendario, carga, actividades, planificación
Los entrenamientos se leen y escriben en unidades sencillas: duraciones en segundos, ritmos como 4:35 por km, tus zonas por id, o porcentajes de VAM, FTP o frecuencia cardiaca máxima. Las fechas están en tu zona horaria.
Acceso de lectura
read · 12get_athlete_contextFecha y zona horaria actuales, métricas, zonas, forma física y frescura, las últimas 4 semanas, próximas carreras, periodos y lesiones. Los agentes la llaman primero.
get_calendarSesiones planificadas (realizadas, no realizadas o pendientes), carreras, notas, actividades y periodos entre dos fechas.
get_sessionget_activityEl entrenamiento estructurado de una sesión; las vueltas de una actividad y tus respuestas a las preguntas posteriores.
get_activitiesget_training_volumeHistorial de entrenamiento y volumen semanal por deporte.
get_training_loadCarga semanal, realizada y planificada, con forma física, fatiga y frescura proyectadas sobre las sesiones planificadas.
get_metricsget_capacitiesget_recordsHistorial de métricas (peso, FC en reposo, VFC, sueño), capacidades y mejores esfuerzos.
list_workout_templateslist_athletesTu biblioteca de entrenamientos; para entrenadores, los atletas que entrenan.
Acceso de escritura, además
write · 11plan_sessionsAñade de una vez hasta 60 entrenamientos con sesiones estructuradas, carreras y notas. Se guardan todos o ninguno.
update_sessionModifica una sesión, una carrera o una nota; en una sesión repetida, esta y las siguientes.
move_sessionscopy_sessionsrepeat_sessionMueve o copia sesiones varios días y repite una cada pocas semanas.
delete_sessionsElimina sesiones planificadas. Las sesiones realizadas y las actividades registradas nunca se eliminan.
create_periodupdate_perioddelete_periodBloques de entrenamiento y periodos sin entrenar: viaje, enfermedad, lesión.
log_metricsupdate_training_zoneRegistra mediciones y modifica una zona después de un test.
Configuración
Conectado en dos minutos
La dirección es la misma en todas partes. En una instancia autoalojada es https://<tu dominio>/api/mcp.
https://api.openathlete.org/mcpClaude
claude.ai y la app de escritorio, luego también en el móvil. Un conector personalizado en el plan gratuito
- 1Customize › Connectors › Add custom connector
- 2Pega la dirección y pulsa Conectar
- 3Inicia sesión en OpenAthlete y elige Permitir
ChatGPT
Planes Business, Enterprise y Edu cuando lo comprobamos; Pro solo puede leer
- 1Plugins › + › Add custom MCP server
- 2Pega la dirección, elige OAuth y créalo como plugin
- 3Autorízalo en OpenAthlete
Claude Code
En una terminal, y después /mcp para iniciar sesión
claude mcp add --transport http openathlete https://api.openathlete.org/mcpCursor, VS Code, tu propio agente
OAuth si el cliente lo admite; si no, un token personal desde Ajustes › Agentes de IA, que se muestra una sola vez
{
"mcpServers": {
"openathlete": {
"url": "https://api.openathlete.org/mcp",
"headers": { "Authorization": "Bearer oa_pat_..." }
}
}
}Para entrenadores
Trabaja con todos tus atletas
El asistente de un entrenador accede a los atletas que entrena, con las mismas reglas que en la app. Primero los lista y luego indica el atleta en cada petición. Pide un repaso de la semana de todos o rehaz el bloque de un atleta después de un mal resfriado.
OpenAthlete para entrenadoresPara cada uno de mis atletas, ¿cómo fue la semana pasada respecto al plan?
- list_athletes6 atletas
- get_calendar× 6, semana pasada
Cuatro de seis cumplieron el 90 % o más del tiempo planificado. Léa se saltó las dos sesiones de calidad y escribió “gemelo cargado” el jueves. Marc hizo un 30 % más de lo planificado.
Seguridad
Seguridad y permisos
Lo que un asistente hace con tus datos depende de él y de su proveedor. Conecta solo los que te den confianza.
OAuth 2.1 con PKCE: apruebas cada asistente en una página de OpenAthlete. Nunca ve tu contraseña.
Lectura y escritura están separadas. A un asistente con acceso de lectura ni siquiera se le ofrecen las herramientas de escritura.
Los tokens se guardan cifrados con hash. Los tokens de acceso duran una hora; los de actualización son de un solo uso, y si uno robado se usa dos veces, se revoca el acceso.
Los tokens personales duran 30, 90 o 365 días, o no caducan nunca. Revoca cualquier conexión en Ajustes › Agentes de IA; deja de funcionar en la siguiente petición.
Los asistentes acceden a tu entrenamiento, no a tu cuenta: no pueden cambiar la contraseña, los dispositivos ni la suscripción, ni borrar tu historial.
Preguntas frecuentes
Sí, en todos los planes, incluido el gratuito, y en instancias autoalojadas. El modelo se ejecuta del lado de tu asistente, con tu cuenta de Claude o ChatGPT.
Claude (claude.ai, escritorio, móvil y Claude Code), ChatGPT en modo desarrollador, Cursor, VS Code y cualquier cliente MCP compatible con OAuth o un token bearer.
No. Las sesiones realizadas y las actividades registradas son tu historial y son de solo lectura vía MCP. Solo puede modificar o eliminar sesiones pendientes.
Sí, exactamente igual que las que planificas tú: a Garmin, Suunto o COROS si la exportación de entrenamientos está activada.
Sí. Aprueba solo el permiso de lectura o crea un token personal con acceso de lectura. Así el asistente no puede cambiar nada.
Sí. La dirección es https://<tu dominio>/api/mcp, con el mismo flujo OAuth y las mismas herramientas.
El resto del ciclo semanal
Todas las funcionesDale a tu asistente datos reales con los que trabajar
Crea una cuenta, conecta tu reloj para que lleguen tus actividades y luego añade OpenAthlete como conector.
Gratis para siempre. Sin tarjeta de crédito.