FITsociety Help ES

MCP y API de FITsociety: qué son, cómo configurarlos y utilizarlos

13 min de lectura

Con el MCP y la API de FITsociety conectas tu cuenta de FITsociety con un asistente de IA como Claude. Después gestionas tu trabajo de coach con lenguaje natural: escribes lo que necesitas y el asistente lo hace por ti en FITsociety.

En este artículo aprenderás:

  • qué son una API y un MCP

  • qué puedes hacer con ellos

  • cómo configurar la conexión

  • cómo crear paso a paso un programa de entrenamiento y un plan de nutrición

  • qué no se puede hacer todavía y respuestas a preguntas frecuentes

Este artículo está dirigido a coaches y propietarios de gimnasios que trabajan con FITsociety. No necesitas conocimientos técnicos.

¿Qué son una API y un MCP?

En pocas palabras: la API es la puerta de FITsociety y el MCP es la guía que permite a un asistente de IA pasar por ella.

API

API significa Application Programming Interface. Es una forma definida de comunicación entre dos programas. Compárala con el servicio de un restaurante: tú no entras en la cocina, sino que haces tu pedido al camarero. El camarero sabe exactamente qué puede preparar la cocina y te lo trae.

La API de FITsociety hace lo mismo. Otro software puede solicitar datos de FITsociety o modificar algo mediante la API, como buscar un cliente o añadir un programa de entrenamiento. Siempre se hace siguiendo reglas definidas y solo con los permisos que otorgues.

MCP

MCP significa Model Context Protocol. Es un estándar abierto que permite a asistentes de IA como Claude trabajar de forma segura con otro software. Un MCP indica al asistente qué acciones están disponibles en FITsociety, como "buscar cliente", "crear plan de nutrición" o "enviar mensaje", y cómo utilizarlas.

Sin MCP, un asistente de IA solo puede conversar y aconsejar. Con MCP también puede realizar acciones por ti en tu propia cuenta de FITsociety.

¿Cómo funcionan juntos?

  1. Escribes una pregunta o instrucción en lenguaje natural en tu asistente de IA.

  2. El asistente determina qué acciones de FITsociety necesita para realizarla.

  3. Mediante MCP, ejecuta esas acciones en tu cuenta con los permisos que le has otorgado.

  4. El asistente muestra lo que ha encontrado o realizado. Tú lo compruebas y haces los ajustes necesarios.

¿Qué puedes hacer?

Mediante MCP, tu asistente de IA puede realizar gran parte de tu trabajo diario de coach en FITsociety. Las secciones disponibles dependen de los módulos de tu cuenta.

Sección

Qué puede hacer el asistente

Ejemplo de pregunta

Clientes

Buscar y crear clientes, consultar perfiles, objetivos, mediciones, formularios de evaluación inicial y revisiones, y mantener notas

"¿Cuáles son los objetivos de Sanne y cómo han cambiado sus mediciones?"

Entrenamiento

Crear, modificar, duplicar y asignar ejercicios, programas y WOD a clientes; consultar sesiones y rendimiento

"Crea un programa de cuerpo completo de 3 días por semana para principiantes."

Nutrición

Crear y modificar planes de nutrición, recetas y suplementos, configurar objetivos nutricionales, consultar la ingesta de clientes y buscar productos

"¿Cuántas proteínas ha consumido Mark de media esta semana?"

Hábitos

Crear plantillas de hábitos, vincularlas a clientes y seguir el progreso

"Asigna a Sanne el hábito '8.000 pasos diarios'."

Agenda y reservas

Consultar y programar clases, citas y tareas, realizar reservas y actualizar la asistencia

"¿Quién se ha inscrito al bootcamp del jueves?"

Mensajes

Leer conversaciones con clientes y enviar mensajes

"Envía a Mark un mensaje indicando que su nuevo programa está listo."

Resúmenes

Resúmenes de la adherencia de los clientes a su plan y de reservas, suscripciones, facturas y créditos

"¿Qué clientes han completado menos de la mitad de sus entrenamientos este mes?"

También puedes combinar varios pasos en una sola instrucción. Por ejemplo: "Busca a Sanne, crea un programa de entrenamiento a partir de su evaluación inicial, asígnaselo y envíale un mensaje indicando que está listo."

Seguridad: tú mantienes el control

La conexión nunca puede hacer más de lo que te permite FITsociety y tú defines cuánto puede hacer.

  • Solo tu propia cuenta. El asistente trabaja únicamente en tu cuenta y en la empresa vinculada a la conexión. Los datos de otras empresas nunca son visibles.

  • Solo tus propios módulos. Si no tienes un módulo, como nutrición, el asistente tampoco puede utilizarlo.

  • Consentimiento de tus clientes. Los datos de los clientes solo están disponibles dentro del consentimiento que hayan dado. Si falta, el asistente no puede consultar esos datos.

  • Lectura y modificación por separado. Eliges si la conexión solo puede consultar o también crear y modificar. Solo puede realizar cambios con los permisos que otorgues.

  • Tú sigues siendo el coach. Un asistente de IA puede cometer errores. Revisa siempre lo que propone o crea antes de compartirlo con un cliente, especialmente en nutrición y entrenamiento si hay lesiones, embarazo o problemas médicos.

Consejo: empieza solo con permisos de lectura. Así descubrirás con calma qué puede hacer el asistente sin modificar nada. Activa los permisos de escritura cuando conozcas su funcionamiento.

Configurar la conexión

Puedes conectar FITsociety con tu asistente de IA en unos minutos. Necesitas un asistente que admita conexiones MCP, como Claude.

Disponibilidad: MCP estará disponible para todos después del seminario del 6 de noviembre. ¿Quieres utilizarlo ya? Envíanos un mensaje y lo activaremos antes en tu cuenta.

Paso 1: abrir la página MCP en FITsociety

Abre la página MCP en FITsociety. En Datos de conexión encontrarás el endpoint (la dirección web de la conexión) y un ejemplo de configuración que puedes copiar. ¿No ves la página? MCP todavía no está activado en tu cuenta. Envíanos un mensaje y te ayudaremos.

Paso 2: crear una clave y elegir los permisos

En la misma página, crea una clave nueva (token). Elige qué puede hacer la conexión:

  • Solo lectura: el asistente puede consultar y resumir datos, pero no modificarlos.

  • Lectura y escritura: el asistente también puede crear y modificar programas, planes, notas, mensajes y citas.

Copia la clave y guárdala de forma segura. No la compartas con nadie: quien la tenga podrá acceder a tu cuenta con los permisos elegidos.

Paso 3: añadir la conexión a tu asistente de IA

Añade una conexión MCP nueva en tu asistente de IA:

  1. Asigna un nombre reconocible, por ejemplo, FITsociety.

  2. Pega el endpoint del paso 1 como dirección. Elige el tipo de conexión Streamable HTTP si tu asistente lo solicita.

  3. Añade tu clave según el ejemplo de configuración de FITsociety. Sustituye el texto provisional por tu propia clave.

  4. Guarda y permite que el asistente consulte las acciones disponibles.

Paso 4: probar la conexión

Haz una pregunta sencilla, por ejemplo: "¿Qué clientes tengo en FITsociety?" o "¿Qué tengo hoy en mi agenda?". Si responde con tus propios datos, la conexión funciona.

¿No funciona? Comprueba que has copiado la clave completa, que la conexión está activada en tu asistente y que MCP ya está activo en tu cuenta.

Revocar una clave

¿Quieres retirar el acceso, por ejemplo, porque se ha filtrado tu clave o vas a utilizar otro asistente? Revócala en la página MCP de FITsociety. La conexión dejará de funcionar de inmediato.

Ejemplo: crear un programa de entrenamiento

En este ejemplo creas un programa de fuerza para una clienta nueva, Sanne, y se lo asignas. Necesitas una conexión con permisos de escritura.

Paso 1: permitir que el asistente conozca a tu cliente

Empieza con una pregunta para que el asistente tenga la información adecuada:

Busca a Sanne de Vries en FITsociety. Resume su evaluación inicial, sus objetivos y las posibles lesiones.

El asistente busca a Sanne y resume su evaluación inicial y objetivos. ¿Hay algo incorrecto o falta información? Complétalo en tu siguiente mensaje.

Paso 2: solicitar una propuesta

Describe lo que quieres de la forma más concreta posible:

Prepara una propuesta de programa para Sanne: 3 días por semana, centrado en fuerza, unos 60 minutos por entrenamiento. Entrena en un gimnasio con pesos libres y máquinas. Ten en cuenta sus molestias de rodilla. Utiliza ejercicios de mi biblioteca. No crees nada todavía; muestra primero la propuesta.

El asistente muestra los ejercicios propuestos para cada día, con series, repeticiones y descanso.

Paso 3: ajustar

Modifica la propuesta con lenguaje natural tantas veces como quieras:

Sustituye las zancadas por subidas al escalón y añade un ejercicio de core al día 2. Configura 2 minutos de descanso en los ejercicios compuestos.

Paso 4: crear y asignar el programa

¿Estás conforme? Da la instrucción de guardarlo realmente en FITsociety:

Está bien. Crea este programa en FITsociety y asígnaselo a Sanne desde el lunes.

El asistente crea el programa, añade los ejercicios a los días y lo asigna a Sanne. Te avisa cuando está listo.

Paso 5: comprobar e informar

Abre el programa en FITsociety y revísalo. Después puedes pedir al asistente que envíe el mensaje:

Envía a Sanne un mensaje indicando que su nuevo programa está listo en la app y que puede preguntar cuando lo necesite.

Consejo: ¿Utilizas a menudo el mismo tipo de programa? Pide al asistente que lo guarde como plantilla. Después puedes decir: "Duplica mi plantilla 'Fuerza principiantes 3x' para Mark y adáptala para alguien sin molestias de rodilla."

Ejemplo: crear un plan de nutrición

En este ejemplo creas un plan para Mark, que quiere perder peso y conservar músculo. Necesitas el módulo de nutrición y una conexión con permisos de escritura.

Paso 1: conocer la situación inicial

Busca a Mark Jansen. ¿Cuáles son sus objetivos, su peso actual y sus objetivos nutricionales? ¿Y qué ha comido de media la última semana?

El asistente consulta los objetivos, mediciones y objetivos nutricionales configurados de Mark y resume su ingesta registrada. Así ves de inmediato dónde hay más margen de mejora.

Paso 2: configurar los objetivos nutricionales

Define tú los objetivos o pide una propuesta al asistente y revísala:

Configura para Mark estos objetivos diarios: 2.200 kcal, 170 gramos de proteínas, 220 gramos de carbohidratos y 70 gramos de grasas.

Paso 3: solicitar una propuesta de plan

Prepara una propuesta de plan de nutrición para Mark que encaje con estos objetivos: desayuno, almuerzo, cena y dos refrigerios. No come pescado y tiene poco tiempo para cocinar, así que hazlo sencillo. Utiliza recetas de mi biblioteca siempre que sea posible. No crees nada todavía.

El asistente muestra su propuesta para cada comida, con cantidades y el total diario de calorías y macros.

Paso 4: ajustar

Sustituye el queso quark del desayuno por avena con whey y prepara para los días laborables un almuerzo que pueda llevarse. ¿Siguen siendo correctas las proteínas?

El asistente adapta el plan y vuelve a calcular si cumple los objetivos.

Paso 5: crear y revisar el plan

Perfecto. Crea este plan de nutrición en FITsociety para Mark y comprueba que coincide con sus objetivos.

El asistente crea el plan y lo contrasta con los objetivos configurados. Si algún día se desvía demasiado, lo indica. Después, abre tú el plan en FITsociety para revisarlo.

Paso 6: seguir el progreso

Después de una o dos semanas puedes comprobar rápidamente cómo va:

¿Cómo ha seguido Mark su plan de nutrición durante las últimas dos semanas? ¿Qué días se desvía más?

Consejo: Si creas una receta nueva para un cliente, pide al asistente que también la guarde en tu biblioteca de recetas. Así podrás reutilizarla después para otros clientes.

Más ejemplos de preguntas y consejos

Ejemplos de preguntas

Clientes y progreso

  • "¿Qué clientes todavía no han completado su revisión de esta semana?"

  • "Resume las últimas tres revisiones de Sanne y añade una nota a su expediente."

  • "¿Cómo ha cambiado el peso de Mark en los últimos tres meses?"

Entrenamiento y WOD

  • "Crea un WOD para el sábado: un AMRAP de 20 minutos con kettlebells y remo, y publícalo."

  • "¿Qué entrenamientos ha completado Sanne este mes y cuáles fueron sus sentadillas más pesadas?"

Agenda y reservas

  • "Programa una entrevista inicial con Lisa el próximo martes a las 18:00."

  • "¿Cuántas personas han asistido de media a mis clases grupales este mes?"

Administración

  • "Dame un resumen de las facturas pendientes."

  • "¿Qué suscripciones terminan el próximo mes?"

  • "¿Cuántos créditos le quedan a Mark?"

Consejos para dar buenas instrucciones

  1. Sé concreto. Indica el nombre completo del cliente y añade cantidades, días, horas y objetivos.

  2. Aporta contexto. Explica las lesiones, preferencias, material disponible y tiempo del cliente.

  3. Pide primero una propuesta. Di "no crees nada todavía" si primero quieres ver qué planea hacer el asistente.

  4. Ajusta con lenguaje natural. No necesitas empezar de nuevo; indica simplemente qué debe cambiar.

  5. Comprueba el resultado. Revisa en FITsociety que todo sea correcto antes de compartirlo con tu cliente.

  6. Trabaja por pasos en tareas grandes. Completa primero un cliente correctamente antes de pedir al asistente que haga lo mismo para diez.

Qué no se puede hacer todavía

  • Crear facturas y pagos. Puedes consultar y resumir facturas, suscripciones y créditos. Para crear facturas o procesar pagos, sigue utilizando FITsociety directamente.

  • Importar clientes y suscripciones desde otro sistema. ¿Cambias desde otro sistema? Contacta con nosotros y te ayudaremos con la migración.

  • Asesoramiento médico. El asistente es una herramienta para tu trabajo como coach, no un médico ni dietista. Ante problemas médicos, prevalecen tu criterio y el de un especialista.

  • Trabajar fuera de tus módulos o permisos. El asistente tampoco puede hacer lo que no permite tu cuenta o clave.

¿Falta algo? Añádelo a la lista de deseos

¿El asistente todavía no puede hacer algo? Pregúntaselo. Si realmente falta una función, te ofrece añadir tu idea a nuestra lista de deseos. Otros coaches pueden votarla para que veamos qué se solicita más. Una solicitud no garantiza que la desarrollemos ni establece un plazo. Nunca se incluyen datos de clientes ni información personal en la lista de deseos.

Preguntas frecuentes

¿Qué asistente de IA necesito?
Uno que admita conexiones MCP, como Claude. Algunos asistentes requieren una suscripción de pago para ello.

¿MCP tiene un costo adicional?
Contacta con nosotros y te explicaremos las opciones de tu paquete.

¿Puede el asistente eliminar o modificar algo por error?
Con una clave de solo lectura no puede modificar nada. Con permisos de escritura puede crear y modificar elementos, pero solo dentro de tu cuenta y módulos. Por eso debes pedir primero una propuesta y comprobar el resultado.

¿Mis clientes ven que utilizo un asistente de IA?
No automáticamente. Un programa, plan o mensaje creado por el asistente aparece en FITsociety igual que si lo hubieras creado tú.

¿Qué ocurre con los datos de mis clientes?
El asistente solo puede consultar los datos para los que tus clientes hayan dado consentimiento y únicamente dentro de tu cuenta. Lee también las condiciones de privacidad del asistente que utilices.

Recibo un mensaje de error. ¿Qué hago?
Comprueba primero la clave, los permisos y si la conexión está activada en tu asistente. Si aparece un mensaje de permisos insuficientes, probablemente tu clave solo tenga permisos de lectura. ¿No consigues resolverlo? Contacta con soporte.

¿Dónde puedo verlo en acción?
En nuestro seminario del viernes 6 de noviembre a las 13:00 mostraremos cómo utilizar MCP con un caso práctico. ¿Quieres asistir? Envíanos un mensaje y nos aseguraremos de que recibas la invitación.

¿Te ha resultado útil este artículo? ¡Gracias por tu opinión!

Gracias, leemos todos los comentarios.

Artículos relacionados