Cómo usar la API y el servidor MCP de TrainerPlan

La API de TrainerPlan permite que tus propias herramientas lean tu cuenta de entrenador y planifiquen para tus deportistas: un asistente de IA como Claude, ChatGPT o Cursor a través de nuestro servidor MCP, un script o una hoja de cálculo. Está incluida en el plan Elite. En este artículo verás cómo crear una clave, conectar un asistente y hacer tu primera petición.

Qué puedes hacer con ella

• Leer tus deportistas, sus calendarios (entrenamientos planificados y realizados, con sus pasos), eventos, notas, comentarios, zonas de entrenamiento, fitness, fatiga y forma, métricas diarias como el peso, el sueño y la HRV, y tu librería de entrenamientos.
• Hacer cambios, con una clave que lo permita: planificar entrenamientos con pasos estructurados, copiar entrenamientos de tu librería, añadir notas y eventos, y comentar una sesión. El deportista recibe el aviso y ve el cambio en su calendario, igual que si lo hubieras hecho en TrainerPlan.

Antes de empezar

• La API y el servidor MCP forman parte del plan Elite. En la prueba gratuita o en otro plan, la página API / MCP explica cómo cambiar de plan.
• Solo el propietario de la cuenta y los administradores del equipo pueden crear claves.

1. Crea una clave

1. Abre tu perfil y elige API / MCP en el menú de la izquierda, o ve a app.trainerplan.co/trainer/api, y pulsa Crear clave.
2. Ponle un nombre que diga qué la va a usar, por ejemplo «Informe semanal».
3. Elige una Caducidad si quieres que la clave deje de funcionar sola a los 30 días, a los 90 días o al año.
4. Marca Permitir que esta clave haga cambios solo si la herramienta necesita planificar o editar. Sin esa opción, la clave solo puede leer.
5. La primera vez, acepta las Condiciones de la API. Solo se hace una vez por cuenta.
6. Pulsa Crear clave y después Copiar. La clave se muestra una sola vez, así que guárdala en un lugar seguro.

Una clave da acceso a todos los deportistas de tu cuenta, así que trátala como una contraseña. Usa una clave distinta para cada herramienta: puedes tener hasta 10 y puedes Revocar una en cualquier momento sin afectar a las demás.

2. Conecta un asistente de IA (MCP)

Los asistentes compatibles con el Model Context Protocol (MCP), como Claude, ChatGPT, Cursor o VS Code, se conectan directamente a TrainerPlan: todo lo que hace la API se convierte en una herramienta que el asistente puede usar, sin escribir código ni subir ningún archivo. La dirección del servidor también está en la página API / MCP:

https://api.trainerplan.co/api/v1/mcp

Se identifica con tu clave y solo hace lo que la clave permite: con una clave de solo lectura, el asistente solo puede leer. La mayoría de los asistentes permiten enviar la clave como cabecera. En Claude Code, por ejemplo:

claude mcp add --transport http trainerplan https://api.trainerplan.co/api/v1/mcp \

  --header "Authorization: Bearer YOUR_API_KEY"

Si un asistente solo pide una dirección (un conector personalizado en Claude o ChatGPT, por ejemplo), añade tu clave al final: https://api.trainerplan.co/api/v1/mcp/YOUR_API_KEY. Esa dirección funciona como la propia clave: no la compartas y revoca la clave si alguna vez se ha compartido.

Después pregunta con tus palabras, por ejemplo «¿Quién se ha saltado una sesión esta semana?» o «Planifica 5 x 1 km para Laura el jueves». Lo que el asistente cambie llega a los calendarios y dispositivos de tus deportistas como si lo hubieras hecho tú. Tiene instrucciones de consultarte antes de cambiar nada, pero dale una clave de solo lectura salvo que quieras que planifique, y revisa lo que planifica antes de darlo por bueno.

3. Úsala desde tus propios scripts

Envía la clave en la cabecera Authorization. Esta petición lista tus deportistas:

curl https://api.trainerplan.co/api/v1/athletes \
  -H "Authorization: Bearer YOUR_API_KEY"

Todas las direcciones empiezan por https://api.trainerplan.co/api/v1. La lista completa de lo que puedes pedir, con un ejemplo de cada petición, está en Documentación de la API, el enlace que hay al final de la página de la API.

Límites y uso

Cada clave puede hacer 120 peticiones por minuto, de las cuales 30 pueden ser cambios. Una petición por encima del límite recibe un error 429: espera un minuto y vuelve a intentarlo. Debajo de tus claves, Uso en los últimos 30 días muestra las peticiones de cada día y cuántas rechazó el límite.

Conviene saber

• De un deportista que todavía no ha aceptado tu invitación, la API solo devuelve lo que has añadido tú.
• Las notas que un deportista mantiene privadas no se devuelven.
• Si crees que una clave ha quedado expuesta, revócala en la página de la API y crea otra.

¿Dudas? Escríbenos a info@trainerplan.co.