MCP — conectar un agente de IA externo a Omniscol

Lo que puede hacer el agente

El agente MCP funciona muy bien con las preguntas de consulta en las que el dato está en Omniscol:

• «Indíqueme la tasa de ocupación de las aulas respecto a los horarios de apertura de esta semana.»
• «Búsqueme un aula disponible tres lunes de octubre en la misma franja horaria de 2 horas.»
• «¿Cuántas horas de sesión ha impartido Jean Dupont en el año escolar en curso?»
• «¿Cuáles son todas las sesiones de matemáticas de hoy?»
• «Enumere los profesores que han realizado menos del 70 % de sus horas de servicio este trimestre.»

Estas consultas cruzan habitualmente varias herramientas: horario, tableros de control estadísticos, disponibilidades calculadas, fichas de profesores. El agente orquesta las llamadas y formula la respuesta en lenguaje natural.

Las herramientas expuestas

El servidor MCP construye sus herramientas a partir de las rutas de la API de Omniscol autorizadas para MCP. Las rutas ignoradas explícitamente, y algunos módulos técnicos (por ejemplo, los relativos a la autenticación de los usuarios) no se convierten en herramientas. La lista refleja, por tanto, la API expuesta al MCP, no la totalidad interna de la aplicación. Es, no obstante, una parte muy grande. Es más, existe cierto número de rutas dedicadas al MCP y no utilizadas por Omniscol. Es el caso de herramientas de búsqueda avanzada para que el texto libre que designa una entidad («profesor Jean Dupont», «clase 6A») sea localizado por Omniscol con su identificador técnico, que sirve después para consultar los datos con precisión. También es el caso de herramientas complejas donde Omniscol no dispone de interfaz gráfica, porque se presta mejor al prompt: la búsqueda de ocupación y de disponibilidad de una entidad, por ejemplo («búsqueme un aula disponible durante 2 horas por la tarde 3 lunes seguidos», «¿está disponible un profesor de matemáticas la semana del 14 de octubre durante 3 horas?»).

Las herramientas cubren en particular:

• el módulo Administración (usuarios, asignaturas, años escolares, ajustes),
• el módulo Gestión horarios (configuración, sedes, aulas, clases, sesiones),
• el módulo Horario (planificación, tableros de control, búsquedas),
• el módulo Gestión de ausencias (declaración, estadísticas),
• búsqueda global.

Las rutas de lectura son las más adecuadas para un uso agéntico. Ciertas operaciones de escritura pueden existir en el catálogo, según los derechos del token y la API disponible, pero deben permanecer supervisadas: una petición que modifica varios objetos de negocio debe ser verificada por un usuario antes de considerarse fiable.

Activar el servidor MCP

El servidor MCP está disponible en las cuentas Premium. Todo parte de la pantalla MCP, abierta desde el módulo Administración con Configurar: muestra la URL del servidor según el ámbito elegido (global o restringido a un módulo) y proporciona, listos para copiar, los elementos de configuración de su cliente.

La autenticación estándar de MCP es OAuth2. Un cliente compatible (como Claude) se conecta simplemente a la URL del servidor, descubre allí la configuración OAuth2 de la cuenta, y el usuario aprueba el acceso mediante una pantalla de consentimiento: no hay nada más que aportar que la URL. El ámbito concedido sigue los derechos de la cuenta y sus restricciones de visibilidad. El servidor OAuth2 de Omniscol, su pantalla de gestión de clientes y el detalle del consentimiento se describen en OAuth2 / OIDC (proveedor).

Para un cliente que no gestiona OAuth2, la misma pantalla genera un token (clave de API, expiración, usuario asociado opcional, derechos de escritura a marcar) y ofrece después, listos para pegar, los formatos útiles según el caso: encabezado Authorization: Bearer, URL con token, bloque de configuración Claude Desktop (modo gratuito) y comando de proxy local. El token se apoya en el sistema de claves descrito en API de Omniscol.

Buenas prácticas de seguridad

• Autenticación OAuth2 — más práctica y preferible cuando su agente la admite (versión de pago de Claude).
• Token dedicado a la IA — cree un token con una etiqueta descriptiva (Agente de IA — Claude desktop) que pueda revocar si es necesario.
• Ámbito mínimo — con un token de API, seleccione únicamente los puntos de acceso de la API necesarios. Con un token OAuth, limite los scopes a la necesidad real.
• Registros de actividad (logs) — una llamada aparece en los registros asociados al token cuando la ruta correspondiente está registrada. Estos registros trazan la llamada; no conservan ni el detalle de los datos devueltos ni el contenido reproducible de la petición.
• Restricciones de visibilidad — el agente ve lo que Omniscol le devuelve. Si ha configurado restricciones de visibilidad estrictas para el rol del token, se aplican.