Conectar Lira con Claude (MCP)

Lira puede exponer los datos de tu institución a un asistente de IA externo —Claude, por ejemplo— para que puedas preguntarle sobre tu escuela sin entrar al panel.

Se hace con una credencial personal. Esa palabra es la parte importante de toda esta página.

Lo primero: la credencial es tuya, no de la escuela

Cuando pedís una credencial MCP, no se emite "una llave de la institución". Se emite tu llave, atada a tu usuario.

La regla, en una frase: una credencial no puede leer nada que vos no veas en el panel.

Eso significa, en concreto:

• Si sos Dirección, tu credencial lee toda la institución.
• Si sos Conducción de un nivel, tu credencial lee tu nivel. No el resto.
• Si sos Preceptoría de 3.° B, tu credencial lee 3.° B.
• Si sos Supervisión con acceso sólo a métricas agregadas, tu credencial lee sólo eso.

No hay forma de que una credencial amplíe tu rol. Se resuelve con el mismo motor de permisos que usa el panel, en cada consulta, y contra tus asignaciones actuales: si mañana te cambian el rol, la credencial cambia con vos sin que nadie tenga que reemitirla.

Dos credenciales de dos personas distintas conectadas al mismo Claude devuelven cosas distintas. Eso es lo esperado, no un error.

Qué puede leer hoy

Todo lo que se puede consultar es de sólo lectura, y agregado salvo el diagnóstico de acceso, que mira a una persona puntual y sólo para quien gestiona el equipo. Nada escribe: no toma asistencia, no carga notas, no modifica actas ni el libro diario. Lo más que puede hacer es proponer un arreglo, que queda esperando que una persona con permiso lo apruebe en el panel.

Una aclaración honesta sobre el alcance

De las seis, la que filtra por tu alcance es el Snapshot institucional. Las otras devuelven agregados de toda la institución.

Es el mismo comportamiento que ya tiene el asistente de Lira dentro del panel, y la razón es que un indicador como "sesiones de los últimos 7 días" es una métrica de la escuela, no de un curso. Aun así conviene saberlo: si tu rol está acotado a un nivel o a un curso, los indicadores generales que veas por acá son de la institución completa.

Ninguna de las seis devuelve datos de un alumno identificado.

Lo que todavía NO hace

• No escribe nada. Es deliberado: habilitar escritura sobre asistencia, calificaciones o el libro diario desde un asistente externo es una decisión con consecuencias legales, y no está tomada.
• No expone perfiles individuales, ni bienestar estudiantil, ni el libro diario, aunque tu rol te habilite a verlos en el panel. Esos datos requieren una decisión explícita de la institución antes de salir hacia un servicio externo.
• No guarda nada de lo que le preguntes. Lira responde y no persiste la conversación que ocurre del lado de Claude.

Conectarlo

No hace falta pedir nada ni copiar ninguna clave. Pegás una URL y el resto pasa en pantalla, igual que cuando conectás una cuenta de Google a otra aplicación.

La URL exacta está en el panel, en Configuración → Integraciones, con un botón para copiarla. Conviene copiarla de ahí y no escribirla: tiene que terminar en /api/mcp, y cualquier otra ruta del panel rechaza la credencial de una forma que cuesta reconocer (la conexión "sale bien" y después no anda nada).

Claude Code

claude mcp add --transport http lira https://<panel-de-tu-escuela>/api/mcp

Después, dentro de Claude Code, escribí /mcp y elegí autenticarte.

Claude Desktop

En el archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "lira": {
      "type": "http",
      "url": "https://<panel-de-tu-escuela>/api/mcp"
    }
  }
}

Reiniciá Claude Desktop.

Qué pasa después (las dos pantallas)

En los dos casos se abre el navegador:

1. Entrás a Lira con tu cuenta de siempre — la misma del panel. Si ya tenías sesión abierta, este paso no aparece.
2. Autorizás. Vas a ver una pantalla que dice qué aplicación se quiere conectar, con qué rol y qué alcance vas a compartir, y la lista de tus instituciones para que elijas cuáles. Vienen todas tildadas; destildá las que no quieras compartir.

Al aceptar volvés solo a Claude y ya está conectado. En ningún momento se copia ni se pega una clave.

💡 Si tenés varias instituciones, esto importa: podés conectar Claude para una sola y dejar las otras afuera. La autorización es tuya y por institución.

Revocar el acceso

En el panel: Configuración → Integraciones → Aplicaciones de IA con acceso a tus datos.

Ahí ves cada aplicación conectada, qué instituciones le autorizaste, cuándo la autorizaste y cuándo consultó por última vez. El botón Revocar la corta en el acto.

Vale la pena mirar esa lista cada tanto aunque no vayas a cortar nada: si autorizaste una escuela y ves dos, ahí te enterás.

Revocar no afecta tu cuenta ni tu acceso al panel.

Tampoco hace falta acordarse: si te cambian el rol o te sacan de una institución, el acceso se ajusta solo. El permiso no queda congelado en el momento en que autorizaste — se vuelve a resolver en cada consulta contra tus asignaciones de ese momento.

Para servidores y automatizaciones

Si en vez de una persona lo que se conecta es un servidor —un script, una tarea programada, un panel propio— no hay navegador que pueda abrir la pantalla de autorización. Para esos casos existen credenciales de larga duración que emite el equipo de Lira a pedido, atadas igual a un usuario y a su rol.

No es el camino normal: si hay una persona del otro lado, la autorización por pantalla es mejor en todo sentido y es la que conviene usar.

Cómo se usa

Una vez conectado, se le pregunta en castellano. Claude elige la herramienta.

• "¿Cómo viene la actividad de la escuela esta semana comparada con la anterior?"
• "Mostrame el estado institucional y resumime las tres cosas más urgentes."
• "¿Qué materias tienen el desempeño más bajo en mi nivel?"
• "Armame un resumen para la reunión de equipo directivo del viernes."

La primera consulta de cada sesión suele ser Instituciones accesibles: es donde Claude averigua a qué escuela te referís y con qué alcance.

Privacidad y registro

Esto es lo que corresponde saber antes de conectar nada:

• Cada acceso queda auditado. Toda consulta a datos de una institución escribe en el registro de auditoría del panel, con tu usuario, la acción y el rol que la habilitó, marcada como proveniente de MCP. Es el mismo registro que deja el panel; no hay forma de leer datos sin dejar rastro.
• Los datos salen hacia el proveedor del asistente. Cuando Claude responde, lo que la herramienta devolvió pasó por los servidores de ese proveedor. Son datos agregados y sin alumnos identificados, pero son datos de tu institución: la decisión de conectarlo es institucional, no personal.
• El token se guarda cifrado. En la base queda sólo un hash; ni siquiera nosotros podemos recuperar tu token.
• Se puede revocar en cualquier momento, sin afectar tu cuenta ni tu acceso al panel.

Si tu institución tiene un acuerdo de tratamiento de datos firmado con Lira, avisale al equipo antes de conectar: corresponde dejarlo asentado como sistema conectado.

Si algo no funciona

⚠️ Antes que nada, mirá la URL. Es el error más común y el que peor se disfraza: si pegaste una dirección del panel que no termina exactamente en /api/mcp, la autorización se completa igual —Claude dice "conectado"— y recién después todo devuelve error, sin ninguna herramienta a la vista. Copiala del panel: Configuración → Integraciones, botón Copiar URL.

Limitaciones importantes

• Los datos son los mismos que muestra el panel: reflejan la actividad dentro de Lira, no lo que pasa en el aula presencial.
• Un asistente de IA puede equivocarse al interpretar un número. Para decisiones institucionales, contrastá contra el panel.
• La credencial no reemplaza al panel: no permite gestionar, sólo consultar.

Próximos pasos

• Inteligencia institucional
• Privacidad y solicitudes de datos
• Gestión de personas