AcademIA MCP
AcademIA MCP conecta un agente con el servidor MCP de AcademIA, pensado para los profesores que crean cursos. El agente puede buscar en tus cursos, leer una ruta, un módulo o una lección, y escribir o corregir lecciones, o montar un curso entero a partir de una guía. Todo lo que escribe queda como borrador: nada se publica para los alumnos sin que el profesor lo revise.
No tienes que elegir ninguna operación: el componente da al agente todas las herramientas que ofrece el servidor, y el agente decide cuál usar en cada momento.
Cuándo usarlo
- Un profesor quiere un asistente en un chat que conozca sus cursos y le ayude a mejorar las lecciones.
- Quieres que un agente redacte un curso completo a partir de un documento o de una guía, como borrador.
- Un agente debe revisar las lecciones de una ruta y proponer correcciones.
Configuración
Necesitas una credencial MCP Remote server con la dirección del servidor MCP de AcademIA y una forma de acceso. Consulta Credenciales y Usar servidores MCP.
- MCP Server url: la dirección de la API de AcademIA o la de su servidor MCP, por ejemplo
https://academia.nappai.es/api/mcp. - MCP Server auth:
api_key, con la llave personal del profesor en MCP api key. También puedes usarOAuth2.1e iniciar sesión con tu cuenta de AcademIA.
La llave personal la crea el propio profesor en AcademIA, en Configuración › Integraciones, con Crear llave:
- Ponle un Nombre para reconocerla, por ejemplo
NappAI. - En Permisos, Leer mis cursos es obligatorio. Marca también Crear y editar mis cursos si quieres que el agente pueda escribir (siempre como borrador).
- Elige la Caducidad y confirma con tu contraseña.
- Copia la llave, que empieza por
nappai_prof_sk_live_. AcademIA solo la muestra una vez.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial MCP Remote server con la dirección de AcademIA y la llave del profesor. |
| MCP server URL | Lo rellena la credencial: la dirección de AcademIA o la de su servidor MCP (la que termina en /mcp). |
| Only these tools (avanzado) | Opcional. Los nombres de las herramientas que quieres dar al agente, separados por comas. Vacío: todas las que ofrece el servidor. |
Herramientas que recibe el agente
La lista la da el propio servidor de AcademIA cuando se ejecuta el flujo. Estas son las que ofrece:
| Herramienta | Qué hace |
|---|---|
academia_whoami | Dice a qué profesor pertenece la llave, qué permisos tiene y cuándo caduca. |
academia_search_content | Busca por texto en los títulos y el contenido de los cursos del profesor. |
academia_get_path | Lee la ficha de una ruta y su árbol de módulos y lecciones. |
academia_get_module | Lee un módulo con sus objetivos, su cuestionario y la lista de sus lecciones. |
academia_get_lesson | Lee una lección completa, con su contenido. |
academia_apply_course_manifest | Crea o actualiza un curso completo (ficha, módulos, lecciones y cuestionarios) en una sola operación. |
academia_upsert_lesson | Crea una lección o la reescribe entera. |
academia_patch_lesson | Corrige una parte de una lección. |
academia_request_review | Envía el curso a la revisión de la academia. No hay ninguna herramienta para publicar. |
Las cuatro últimas solo están disponibles si la llave tiene el permiso Crear y editar mis cursos.
Resultado
La salida Tools entrega las herramientas listas para un agente. Conéctala al conector Tools de un Agent.
Ejemplo
Una profesora quiere un asistente que le ayude a pulir su curso de Excel.
- Monta un chat con Chat Input, un Agent y Chat Output.
- Añade AcademIA MCP con la credencial de su llave personal y conecta Tools al conector Tools del agente.
- En las instrucciones del agente, explica que trabaja sobre los cursos de AcademIA de la profesora, que todo lo que escribe queda como borrador y que debe enseñarle los cambios antes de pedir la revisión.
- La profesora escribe “Revisa la lección de tablas dinámicas y simplifica los ejemplos” y el agente lee la lección, la corrige y le cuenta qué ha cambiado.
Buenas prácticas
- Para un asistente que solo consulte, crea la llave con Leer mis cursos únicamente, o escribe en Only these tools solo las de lectura, por ejemplo
academia_search_content, academia_get_path, academia_get_lesson. - Para un paso fijo del flujo, sin agente, usa los otros componentes de AcademIA, como AcademIA Content.
- Si un nombre de Only these tools no existe en el servidor, el componente falla y te dice qué herramientas tiene.
Seguridad y limitaciones
- Es un servidor para crear cursos: no da acceso a organizaciones, matrículas, analíticas ni usuarios. Para eso están los demás componentes de AcademIA.
- El agente actúa como el profesor de la llave y solo ve sus cursos.
- Todo lo que escribe el agente queda como borrador. No puede publicar ni borrar nada.
- La llave da acceso a todos los cursos del profesor mientras no caduque. Si deja de usarse, revócala en AcademIA, en Configuración › Integraciones.
Componentes relacionados
- AcademIA Content: crear, publicar y traducir rutas en un paso del flujo.
- AcademIA AI Tasks: los generadores de IA de AcademIA.
- MCP Connection: conecta con cualquier servidor MCP.