El asistente tiene que ver el mismo registro que el portal

Cuando el estudiante pregunta a ChatGPT qué clase tiene mañana, y la respuesta sale de una captura de pantalla, la institución vuelve a tener dos verdades. Una está en el sistema. La otra, en un chat. Copiar y pegar no es estrategia de inteligencia artificial. Es otra planilla de domingo.

AOKAI incluye ahora un servidor remoto de Model Context Protocol (MCP). ChatGPT, Claude, Cursor u otro cliente compatible se conecta como el miembro que ya inició sesión. No recibe un superusuario. Recibe los mismos módulos, el mismo rol de estudiante o docente, y los mismos permisos de personal que la aplicación web.

Cualquier membresía basta para conectar. Eso no significa verlo todo. El estudiante no opera finanzas. El profesor no convierte una admisión. El personal no abre una clase que no le toca. El protocolo hereda el alcance; no lo inventa.

Esta es la mitad operativa de Bring Your Own Agent. El portal sigue siendo el registro. El agente pasa a ser otro cliente de ese registro: no una segunda base de datos, y no un portapapeles.

Primero la identidad, después las herramientas

AOKAI no acepta una sesión copiada del navegador. Un JSON Web Token de Supabase —el que usa la web— no entra por la puerta MCP. El cliente externo completa OAuth 2.1 con PKCE y recibe un token MCP de corta duración, atado a una persona y a una organización. El acceso dura minutos y se renueva. Si alguien reutiliza un token ya revocado, se corta toda la familia.

El inicio de sesión sigue siendo el correo con código de un solo uso que la comunidad ya usa. La primera conexión abre una página de consentimiento: se elige la institución a la que se pertenece y se autoriza. El agente queda atado a esa organización. No cruza sedes ni cuentas porque el usuario lo pida en el chat.

Se revoca después en Aplicaciones conectadas, en la misma cuenta. Si el token desaparece, el agente desaparece. El registro, no.

El rol es el alcance

Cada listado de herramientas y cada llamada vuelven a comprobar membresía, rol y permisos de módulo: los mismos controles que la aplicación web. No hay un atajo de «el modelo ya está autenticado».

• Las herramientas de estudios solo las ve quien es estudiante.
• Las de enseñanza, quien es profesor.
• El personal ve admisión, matrícula, finanzas, malla o talento humano según los módulos que ya tiene.

Si una herramienta no aparece, esa persona no tiene ese módulo o ese rol. El modelo no debería inventar nombres. Los catálogos institucionales —departamentos, modalidades, escalas de nota— se listan según lo que esa persona ya puede ver; una elección fuera de alcance se rechaza.

Orientarse antes de escribir

El conjunto de herramientas es grande a propósito: cubre el mismo dominio que el portal. Un cliente bien comportado no carga todos los esquemas de una vez. AOKAI le indica un camino corto.

• Quién es la persona: organización, rol de estudiante, docente o personal, y los nombres de rol de sistema.
• Qué módulos puede usar ya.
• Una guía del dominio o de un flujo habitual: matricular, emitir una factura, revisar un postulante, abrir el periodo, operar una clase.
• Después, buscar personas, programas y postulantes por nombre, con el mismo alcance visual que ya tiene.

Las listas están paginadas —veinte resultados por defecto, cincuenta como tope—. Una llamada no puede volcar el periodo entero en el chat. El modelo trabaja con páginas. El registro no se vuelca.

Para el estudiante: el periodo, en conversación

El estudiante ya mira el teléfono para el horario. Con MCP, el agente que ya usa lee los mismos datos vivos, no un PDF exportado la semana pasada.

• Matrículas de programa y el panel de estudios.
• Cursos asignados, una materia concreta, sesiones abiertas y la marca de asistencia.
• Horario semanal.
• Récord académico y documentos visibles del expediente.
• Ventana de automatrícula, oferta y bloqueos.
• Cursos cortos complementarios: la oferta abierta y, si el cupo lo permite, la inscripción.
• Correo del campus: bandeja, no leídos y envío a personas de la organización.

Las preguntas dejan de ser capturas. «¿Qué tengo mañana?» es el horario. «¿Cómo voy en Cálculo?» es el expediente. «¿Todavía puedo matricularme?» es la ventana y sus bloqueos. «Inscríbeme en el curso corto de redacción» es una escritura sobre la misma oferta que ve el portal.

El agente responde con el registro, no con una ocurrencia. Si el bloqueo existe, lo dice. Si el documento está en el expediente, da el nombre y el enlace. No reconcilia una foto con una planilla.

Para el docente: operar la clase, hablando

Las herramientas del profesor no son un portal de solo lectura. Operan el paralelo. El docente que ya usa Claude para armar una clase puede, con el mismo chat, mirar y mover lo que el aula ya registra.

• Panel, paralelos e horario semanal.
• Abrir una clase —cierra primero las demás abiertas del paralelo— y cerrarla; tomar asistencia sobre la lista.
• Actualizar tema, contenido, notas y bibliografía; adjuntar o retirar un archivo de la sesión.
• Plan de sílabo: unidades, temas, horas de contacto, autónomas y de práctica; enviarlo a revisión o devolverlo a borrador.
• Documentos del curso, tareas, entregas y el registro de quienes ya subieron el archivo.
• Solicitudes de apertura o calificación tardía cuando el periodo ya no lo permite.

«¿Quién faltó la última sesión?» es la lista. «Abre la clase de hoy» es una escritura. «Envía el plan» es la misma bandeja que ya ve el personal de revisión de sílabos. El aula y el agente miran el mismo paralelo.

El correo del campus también está aquí. No es un módulo de estudios: lo comparte el docente. Un aviso al paralelo no tiene que salir de un segundo buzón.

Para el personal: la operación, sin un segundo escritorio

Aquí un sistema de información estudiantil justifica MCP. Quien tiene los módulos trabaja el periodo desde el agente que ya usa —sin exportar, sin pegar, sin una segunda verdad.

En admisión: ver postulantes, la ficha, los documentos, una URL corta de descarga, revisar el estado o convertir a matrícula. Las campañas de admisión —oferta y requisitos de documentos— se consultan y se actualizan; no se borran por el protocolo.

En lo académico: programas, cursos, periodos —con la política de matrícula y de planificación docente—, oferta de nivel, paralelos, lista del paralelo, matrícula de periodo, asignación y movimiento de cursos, aulas y choques de horario. Se puede matricular. No se puede retirar. Se puede marcar egresado o asignar tutor. No se gradúa ni se cambia de programa por el chat.

En finanzas: el mayor, el detalle de un cargo, emitir un cargo o una factura, armar un plan de pago. No anular. No revertir. No cancelar el plan. El cobro que no debió existir se deshace en la web, con quien ya tiene esa llave.

En malla: mapas, asignaturas, módulos e itinerarios; clonar o desactivar un mapa; modelos de evaluación, incluido un borrador asistido que no se guarda hasta que alguien lo confirma. Borrar el contenido de una malla no está en el protocolo.

En talento humano: personal, invitaciones, perfiles docentes y curriculum vitae, cargos, roles y módulos. Se invita. Se actualiza. No se restablece una contraseña ni se desactiva una cuenta. No se borra un rol.

Las bandejas de revisión —sílabo, apertura tardía, calificación tardía, ventanas de actas— son las mismas que en el portal. Aprobar o rechazar desde el agente deja el mismo rastro.

El dominio es el de la aplicación: organización, sedes, unidades, programas, mallas, periodos, oferta, paralelos, matrículas, finanzas. El agente busca por nombre antes de escribir. Sigue una guía para un flujo habitual en lugar de adivinar nombres de herramientas. Lo que no puede hacer es deshacer la institución. Eso es a propósito.

Lo que se queda fuera del protocolo

Las escrituras irreversibles siguen en la aplicación web, con las mismas personas que ya las tienen a cargo. El agente opera. No deshace.

• Retirar una matrícula, una inscripción de periodo o un curso asignado; graduar; cambiar de programa.
• Anular o revertir un cargo; anular una factura; cancelar un plan de pago.
• Borrar roles, permisos, módulos, o el contenido de una malla —asignaturas, módulos, itinerarios, vaciar el mapa.
• Restablecer la contraseña de un docente o desactivar un perfil.
• Conectar o desconectar Stripe.
• Subir un documento institucional por un canal sin control de tipo: en MCP, los documentos de institución son URL y metadatos, no un archivo suelto.

Los errores de dominio vuelven como texto que el modelo puede explicar —cupo, ventana cerrada, permiso, choque de horario—, no como un 500 silencioso. El chat no es un lugar donde la institución desaparece sin rastro.

Conectar una vez

En la cuenta, Aplicaciones conectadas muestra la URL MCP de la institución. Se apunta ChatGPT, Claude o Cursor a esa URL. El cliente descubre OAuth, se registra y abre el consentimiento. Se inicia sesión con el mismo correo y se elige la organización. A partir de ahí, el cliente solo ve las herramientas de los módulos que esa persona ya tiene.

Claude Desktop y otras apps compatibles con MCPB pueden instalar un paquete .mcpb desde la misma página —el nombre anterior, .dxt, es el mismo archivo—. La primera apertura lleva a AOKAI para autorizar. Se requiere Node.js 18 o posterior. Quien ya habla Streamable HTTP remoto y OAuth puede seguir usando la URL.

El registro sigue siendo el registro. El agente es un cliente. Quien opera el periodo deja de conciliar capturas. Ese es todo el diseño.