Conectar un asistente AI con una clave API
No todos los asistentes AI pueden iniciar sesión en el FitnessSyncer MCP Server en tu nombre. Muchos solo ofrecen una dirección de servidor y un campo para introducir un token, y algunos leen toda su configuración desde un archivo en el disco. Para esos casos, FitnessSyncer emite una clave API, que es un único token de larga duración que sustituye a todo el proceso de inicio de sesión.
Así es como se conecta Mistral Vibe, y también es la solución ideal para un asistente autohospedado, un cliente de línea de comandos, un marco de trabajo de agentes o un ChatGPT que te ofrece un encabezado en lugar de una pantalla OAuth. Claude, ChatGPT, Perplexity y Home Assistant tienen cada uno su propio proceso de inicio de sesión, por lo que es mejor seguir sus propias instrucciones cuando sea aplicable.
Antes de empezar
- Una cuenta FitnessSyncer con tus fuentes conectadas. El MCP Server se incluye con todas las cuentas, por lo que no hay que comprar nada adicional; consulta la sección «Primeros pasos» si eres nuevo. Una cuenta gratuita ofrece un historial más limitado aquí, exactamente igual que en el resto de la web.
- Un asistente que pueda enviar un encabezado «Authorization», o que denomine a este mismo elemento «token de portador» o «token de API». Si el tuyo puede iniciar sesión con OAuth en su lugar, esa es la mejor opción, ya que así eliges los permisos cada vez en lugar de hacerlo una sola vez.
Una clave API es una contraseña para los permisos que le concedes, y no caduca por sí sola. Utilízala únicamente con un asistente en el que confíes para tus datos de salud y concédele solo los permisos mínimos que necesite.
Paso 1: Crea tu clave API en FitnessSyncer
- Ve a la página «Cuentas de desarrollador».
- En la parte inferior de la página, selecciona «MCP: Clave API» en la lista y haz clic en «Crear».
- FitnessSyncer pregunta qué permisos debe tener esta clave. Selecciona solo lo que quieras que haga el asistente; para responder a preguntas, bastan los permisos de lectura, y nada de lo que dejes sin marcar se podrá utilizar más adelante sin crear una nueva clave.
- Selecciona «Crear clave API» y anota la clave API que aparece en la página siguiente. Solo se muestra una vez; si la pierdes, puedes volver a generarla, pero entonces tendrás que introducirla de nuevo en tu asistente.
Step 2: Mistral Vibe
Una vez que tengas tu clave API:
- En el menú de la izquierda, selecciona «Contexto» y, a continuación, «Conectores».
- Selecciona «Añadir conector» en la esquina superior derecha de la pantalla.
- Selecciona el conector personalizado MCP.
- Introduce «FitnessSyncer» como nombre
- Introduce «https://www.fitnesssyncer.com/services/mcp» como servidor
- Selecciona «Autenticación mediante token de API» y pega tu clave de API en el campo «Token de portador».
Paso 2: Cualquier otro asistente que tenga una pantalla de configuración
Los campos tienen nombres diferentes según el asistente, pero siempre son tres:
- Introduce «FitnessSyncer» en el campo «Nombre»
- Introduce «https://www.fitnesssyncer.com/services/mcp» en el campo «Servidor», que algunos asistentes denominan «URL del servidor remoto MCP».
- Introduce tu clave API en el campo «Bearer Token». Si el asistente te pide en su lugar un encabezado, el nombre del encabezado es «Authorization» y su valor es la palabra «Bearer», un espacio y tu clave API.
Si el asistente también te pide que elijas un protocolo de transporte, selecciona «Streamable HTTP». FitnessSyncer no ofrece el protocolo de transporte SSE, que es más antiguo.
Paso 2: Un asistente configurado a partir de un archivo
Muchos clientes de línea de comandos y de escritorio leen la configuración de sus servidores a partir de un archivo JSON. El formato varía, así que consulta la documentación de tu propio asistente, pero suele tener este aspecto:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Sustituye «YOUR_TOKEN_HERE» por tu clave API, conservando la palabra «Bearer» y el espacio que hay delante de ella.
Pruébalo
Abre un nuevo chat y pega cualquiera de estos mensajes para comprobar que todo funciona correctamente:
- Muestra una lista de todas las aplicaciones y dispositivos a los que FitnessSyncer está conectado actualmente en mi cuenta y indica cuándo se sincronizaron por última vez.
- ¿Cómo he dormido esta semana en comparación con la semana pasada?
- ¿Cómo ha evolucionado mi frecuencia cardíaca en reposo durante el último mes?
Hay muchas más ideas en la página MCP Server.
Tu asistente AI te explica los resultados basándose en las directrices públicas; esto no constituye un consejo médico.
¿Debo utilizar una clave API o iniciar sesión?
Inicia sesión donde tu asistente lo permita. Un inicio de sesión OAuth te pregunta qué permisos quieres conceder en el momento de conectarte, y se puede revocar para esa conexión concreta; una clave API mantiene los permisos que elegiste al crearla, mientras exista.
Utiliza una clave API cuando el asistente no pueda iniciar sesión, como ocurre con Mistral Vibe y con la mayoría de los clientes configurados a partir de un archivo.
¿Puedo modificar las acciones que puede realizar una clave API?
No a posteriori. Los permisos se establecen al crear la clave, por lo que, para ampliarlos o reducirlos, debes eliminar la clave en «Configuración del desarrollador» y crear una nueva con los permisos que desees. A continuación, tu asistente necesitará la nueva clave.
He perdido mi clave API. ¿Y ahora qué?
La clave solo se muestra en el momento de su creación, por lo que no hay nada que consultar. Vuelve a generarla en «Configuración del desarrollador» e introduce la nueva en tu asistente. La clave antigua deja de funcionar en cuanto la vuelves a generar, que es también la forma de bloquear a un asistente en el que ya no confías.
¿Cómo puedo desconectar a un asistente?
Retira el conector del asistente y, a continuación, elimina la clave en «Configuración del desarrollador». Lo importante es eliminar la clave, ya que, de lo contrario, cualquier elemento que aún la contenga seguiría funcionando.
