Todo lo necesario para manejar alinaflow desde fuera de la app: claves con permisos acotados a lo que puede hacer quien llama, un servidor MCP para que un agente de IA opere la academia por ti, y la referencia REST completa.
Cómo empezar con el Portal de Desarrolladores
El Portal de Desarrolladores sirve para conectar otro software con tu academia: tus propios scripts, una integración que prepare tu desarrollador web o un agente de IA como Claude o ChatGPT a través de MCP. Crea una clave en API / MCP, pégala en la herramienta que conectas y actuará con tu propio rol, así que nunca podrá hacer más que tú. Revócala ahí mismo cuando ya no la necesites.
alinaflow tiene cuatro portales, cada uno para un lector distinto. El Portal de Inscripciones es público, para quien todavía no estudia contigo. El Portal de Familias es donde inician sesión las familias de tu academia. El Portal de Profesores es donde tus Profesores organizan su día. El Portal de Desarrolladores sirve para conectar otro software y agentes de IA con tu academia. Los tres primeros comparten un mismo enlace: un visitante ve tu Portal de Inscripciones, y una familia o un Profesor que inicia sesión ve su propio Portal.
API / MCP
Acceso programático a tu Academia de Música
Crea claves de API para conectar Claude, ChatGPT o cualquier cliente MCP a tu Academia de Música, o para llamar a la API de alinaflow directamente. Las claves son personales: actúan con tu propio rol, así que nunca pueden hacer más que tú, y puedes revocarlas cuando quieras.
La pantalla API / MCP en alinaflow
Claves de acceso programático, incluido el servidor MCP que permite a otros agentes de IA operar tu academia. Una clave lleva exactamente el rol de la persona a la que pertenece y nunca puede excederlo, así que una clave de Viewer se rechaza en cualquier escritura. Emite claves con el acceso que le darías a una persona que hiciera ese mismo trabajo, y revócalas aquí cuando ya no hagan falta.
Secciones de esta pantalla
Esta pantalla se divide en secciones: Nueva clave. Cada una forma parte de la misma pantalla, no es una página aparte.
Nueva clave
Ponle a la clave un nombre que indique dónde la vas a usar, por ejemplo "Claude en mi portátil" o "Sincronización con Zapier". Así sabrás cuál es cuál cuando tengas varias y podrás revocar la correcta sin dudar. La fecha de caducidad no es obligatoria, pero conviene ponerla en claves de prueba o en las que compartes con alguien externo a la academia. La clave actúa con tu mismo rol, así que nunca podrá hacer más de lo que tú puedes hacer.
Pestaña Nueva clave
Campos principales
Claves de API - Tokens personales para acceso programático. Crea una, cópiala una sola vez (se muestra una única vez) y pégala en tu cliente. Puedes revocarla cuando quieras.
Rol - Una clave actúa con tu rol y acceso a sedes actuales, así que nunca puede hacer más que tú. Si tu rol cambia, la clave lo sigue.
Desactivación - Si tu cuenta se desactiva, todas tus claves dejan de funcionar de inmediato.
Servidor MCP - Apunta Claude, ChatGPT o cualquier cliente MCP a la URL del MCP y autentícalo con una clave para que lea y escriba los datos de tu Academia de Música en tu nombre.
Documentación de la API - Cada endpoint con su descripción y el rol requerido. Descarga la especificación OpenAPI (MCP o v1) para generar un cliente.
Documentación de la API
La referencia REST completa: cada endpoint, sus parámetros y sus respuestas, con los esquemas generados desde la propia API para que nunca se desactualicen.
