Servidor MCP

Visión general

Creator incorpora un servidor MCP (Model Context Protocol). Cualquier asistente de IA compatible con MCP — Claude en claude.ai, Claude Code, MCP Inspector — puede conectarse a tu cuenta de Creator y hacer desde un chat todo lo que hace el editor:

  • Navegar por tu espacio de trabajo y tus organizaciones
  • Crear carpetas, cursos, microlearnings y bancos de preguntas
  • Añadir, editar, mover y borrar lecciones y los 46 tipos de bloque con toda su configuración
  • Gestionar la biblioteca de temas de la organización y elegir el tema de cada contenido (colores, tipografías, portada, CSS propio)
  • Exportar a SCORM, web o PDF, exportar el banco de preguntas (GIFT, Moodle XML o QTI 2.1), publicar enlaces de compartir, gestionar instantáneas, duplicar y traducir

La autenticación usa OAuth contra tu cuenta SLXD: el asistente nunca ve tu contraseña y puedes revocar el acceso cuando quieras. Todo lo que hace el asistente queda limitado a lo que puede hacer tu usuario — la pertenencia a la organización y los roles se comprueban en cada llamada.

Conectar

El endpoint MCP es la URL de conector de tu organización:

https://<tu-organizacion>.slxd.app/mcp/creator

No hace falta construirla a mano: la plataforma SLXD la lista en Organización > Conectores, junto a los conectores del resto de productos.

claude.ai

  1. Ve a Ajustes > Conectores > Añadir conector personalizado
  2. Pega la URL del endpoint
  3. Completa el inicio de sesión y autoriza el acceso

Claude Code

claude mcp add --transport http creator https://<tu-organizacion>.slxd.app/mcp/creator

La primera llamada abre el navegador para iniciar sesión y autorizar.

Los clientes se registran solos (registro dinámico de clientes OAuth) — no hay nada que configurar en el servidor.

Cómo funcionan las herramientas

El servidor expone un conjunto curado de herramientas de primer nivel (navegación del espacio de trabajo, CRUD de contenidos y lecciones, bloques, tema, exportación, subida de ficheros, duplicado de un contenido) más tres meta-herramientas que abren el catálogo completo:

browse_workspace cubre tres necesidades: navegar un nivel de carpeta, buscar en todo el ámbito por título/nombre con query, o mapear el árbol de carpetas entero en una sola llamada con recursive: true (cada carpeta con su parentId). Para clonar un contenido — lecciones, bloques y recursos — como plantilla, usa duplicate_content (de primer nivel); duplicate_lesson hace lo mismo con una sola lección.

Más allá de la autoría, el catálogo también cubre: el ciclo completo de la papelera de carpetas (restore_folder, delete_folder_permanently) y operaciones de contenido por lotes (batch_move_contents, batch_trash_contents); copiar un contenido a otro espacio, siempre una copia y nunca un movimiento (copy_content_to_tenant); la gestión de versiones (rename_snapshot, delete_snapshot); buscar en las bibliotecas de stock licenciadas e importar un recurso bajo un contenido (search_stock_images/import_stock_image, search_stock_icons/import_stock_icon); y auditar y corregir problemas de accesibilidad (más abajo). Los medios que genere el propio modelo se suben con request_asset_upload.

Meta-herramientaPara qué
find_toolsBuscar en todo el catálogo por palabra clave (publicación, instantáneas, traducción, plantillas, papelera…)
tool_schemaObtener el esquema de entrada de cualquier herramienta del catálogo
run_toolEjecutar por nombre una herramienta del catálogo

Para los bloques, list_brick_types lista todos los tipos agrupados por categoría (texto, medios, colecciones, preguntas, juegos, estructura de la lección — structure) con una pista de «cuándo usarlo» para elegir el adecuado a cada objetivo didáctico, y get_brick_type_schema devuelve la forma de autoría exacta (con un ejemplo) de cada uno — el texto enriquecido se redacta como HTML plano. El código en línea (<code>) vale en todo campo de texto de varias líneas y los bloques de código (<pre><code class="language-…">, con su lenguaje) en los de formato completo (get_brick_type_schema los lista en richText); los campos de una línea rechazan los dos con un error que nombra el campo. Lo que se guarda pero cambia por el camino —una etiqueta, un atributo o un estilo que el editor no puede conservar, un enlace en un campo sin enlaces, párrafos unidos en un campo de una línea— vuelve en el resultado de add_brick y update_brick en warnings, campo a campo, sin tener que releer la lección para descubrirlo.

La categoría structure contiene el tipo CONDITIONAL (Contenido condicional): add_brick recibe sus ramas y los bloques de cada una en una sola llamada, get_lesson devuelve los bloques anidados dentro de cada rama, y update_brick, move_brick y delete_brick actúan sobre el grupo entero. La gramática de la condición y las reglas (un solo nivel, nunca en exámenes ni bancos) están en Contenido condicional; el manifiesto y los mensajes de las simulaciones que lee, en Paquetes incrustados y simulaciones.

Elegir el bloque adecuado

Para ayudar al asistente a elegir el bloque más apropiado, list_brick_types lleva la guía de «cuándo usarlo» por tipo, y el recurso creator://guides/brick-selection es una guía de selección completa (intención → bloques recomendados). Ambos se generan de la misma fuente, así que nunca divergen, y ambos funcionan en cualquier cliente MCP.

Temas

Los temas viven en la biblioteca de temas de la organización y cada contenido usa uno. Varios contenidos pueden compartir el mismo tema, así que cambiar un tema cambia todos los contenidos que lo usan.

HerramientaPara qué
list_themesVer los temas de la biblioteca, cuántos contenidos usa cada uno y cuál es el tema por defecto (el que reciben los contenidos nuevos)
get_themeLeer un tema por contentId (el que usa ese contenido) o por themeId. Devuelve también su version y cuántos contenidos lo usan
get_theme_schemaVer qué admite un tema sin leer ninguno: de cada campo, su ruta exacta, la forma que acepta (una longitud o hasta cuatro, un color como texto —palette:accent— en los estilos de bloques o como {"paletteId": "accent"} en el resto, opciones, rangos), su valor por defecto o el campo del que lo toma, qué cambia en pantalla y los tipos de bloque que lo usan. Sin filtros, enumera las secciones y lo que el tema no puede cambiar (con la alternativa); se filtra por section, por brickType (p. ej. TIMELINE) o por texto con search
update_themeCambiar un tema por contentId o por themeId. Afecta a todos los contenidos que lo usan, y la respuesta dice a cuántos (affectedContents). Si se le pasa la version leída y otra persona ha cambiado el tema entretanto, no guarda nada y hay que volver a leerlo. Lo que guarda distinto de como llegó o con un problema vuelve en warnings, campo a campo: un campo que no existe (con el más parecido), un valor con otra forma (con la que acepta ese campo, la misma que da get_theme_schema) o fuera de rango, un valor que se guarda de otra manera, lo que descarta de una tipografía propia (solo admite regular, regularItalic, bold y boldItalic, pesos 400 y 700) y, si cambian los colores, un «Texto sobre acento» que no llega al contraste AA (4,5:1) con el acento; sin valor propio, ese texto usa el color de texto
create_themeCrear un tema: con el aspecto por defecto, a partir de un preajuste o como copia de otro tema o del tema de un contenido
set_content_themeElegir el tema de un contenido
apply_theme_presetDar a un contenido el aspecto de un preajuste: le pone un tema de la biblioteca igual al preajuste y, si no hay ninguno, lo crea
reset_themeVolver a poner en un contenido el tema por defecto de la organización
delete_themeBorrar un tema que no usa ningún contenido (tampoco en la papelera) y que no es el tema por defecto

Para cambiar el aspecto de un solo contenido cuyo tema comparten otros, haz una copia de su tema (create_theme con fromContentId), pónsela con set_content_theme y edita la copia. Cambiar el tema de un contenido no modifica el que deja de usar: sigue en la biblioteca. import_theme_from_content ya no existe: usar el tema de otro contenido es elegirlo con set_content_theme.

Puede editar los temas quien puede editar contenidos en la organización.

Subir ficheros

El contenido de Creator usa ficheros — imágenes, vídeo, audio, subtítulos, adjuntos descargables, tipografías propias, paquetes de embed — y el MCP puede subirlos. El binario nunca viaja por el MCP (nada de base64): la herramienta emite una URL de subida prefirmada de corta duración y el cliente manda el fichero directo al almacenamiento, por fuera.

El flujo para un recurso de bloque:

  1. Llama a request_asset_upload con el contentId de destino, el kind (image | video | audio | subtitle | attachment | font) y el contentType del fichero (p. ej. image/png). Para un fichero del tema (logo, imagen de cabecera, iconos, tipografías woff2 propias), pasa themeId en lugar de contentId: el fichero queda con el tema y no depende de ningún contenido; solo admite image y font. Cada kind tiene una lista blanca de MIME, así que un tipo que no cuadre se rechaza de entrada.
  2. La herramienta devuelve { uploadUrl, path, curlCommand, expiresAt }. Sube el fichero — ejecuta el curlCommand devuelto (sustituyendo <local-file> por la ruta real) o haz un PUT de los bytes a uploadUrl con el Content-Type exacto. La URL caduca a los 15 minutos.
  3. Pon el path devuelto en el campo de medios del bloque vía add_brick / update_brick (imagePath, videoPath, audioPath, filePath, posterPath, subtitlesPath, front*/back*/…), o en el tema vía update_theme (logo, tipografías woff2 propias), con el mismo themeId. La imagen de portada y el título del curso son de cada contenido, no del tema: sube la imagen con el contentId y ponla con update_content (coverImagePath; courseTitle para el título del curso); get_content los devuelve. Para sustituir la imagen de portada, pon la ruta nueva en coverImagePath: cambia la imagen y el título del curso y el velo se quedan como estaban; el fichero anterior no se borra, lo recoge el barrido de huérfanos. El velo de la imagen y la posición y los estilos del título del curso siguen en el tema. La imagen de las cabeceras de lección también es del contenido: ponla con update_content (lessonHeaderImagePath) y el tema la pinta con lessonHeader.background.type: image; cada lección puede llevar la suya con update_lesson (headerImagePath; null vuelve a heredar), que siempre gana. El velo sigue en el tema (lessonHeader.image.overlay).

list_content_assets devuelve los ficheros ya subidos de un contenido, para reutilizar un recurso existente en vez de subirlo otra vez.

Las imágenes SVG son la excepción: un SVG es código, así que nunca se sube con una URL firmada (request_asset_upload rechaza image/svg+xml). Se manda con upload_svg_image: el SVG viaja en la llamada, como texto (svg) o en base64 (svgBase64), hasta 5 MB, con contentId o themeId. El servidor lo sanea con las mismas reglas que el editor (quita scripts, atributos de evento y enlaces y recursos externos) y guarda solo el resultado; la path que devuelve vale en cualquier campo de imagen. Si no se puede leer sin riesgo, no se guarda nada y el error lleva un código estable: [svg_not_svg], [svg_malformed] o [svg_too_large]. Un SVG se muestra siempre como imagen, que no carga ninguna fuente de fuera: si su texto no lleva la fuente incrustada (o convertida a trazados), el resultado trae el aviso svg_text_without_font y el texto saldrá con la fuente que tenga el dispositivo del alumno. Los bancos de imágenes e iconos (import_stock_icon, import_stock_image) sanean los SVG igual. import_stock_image solo acepta una downloadUrl tal como la devolvió search_stock_images, con el mismo provider, y solo guarda imágenes: el tipo se lee de los bytes descargados (PNG, JPEG, WebP, GIF, AVIF o un SVG saneado, hasta 30 MB), nunca de la URL ni del Content-Type. Lo demás no guarda nada y falla con un código estable: [stock_url_not_allowed], [stock_not_image], [stock_too_large], [stock_blocked_target] (una redirección a una dirección sin https o interna) o [stock_too_many_redirects].

Los bloques de embed (un paquete autocontenido de index.html + recursos) usan request_embed_upload: sube cada fichero del paquete bajo el mismo folderId y pon el embedFolderPrefix devuelto en el bloque EMBED. Aterrizan en el bucket privado embeds con su Content-Type fijado, y se sirven a los espectadores mediante URLs de corta duración por carpeta — nunca desde un dominio público. Para que el paquete pueda completar el bloque (y así cumplir su bloqueo) o fijar su propio alto, sube también un slxd-embed.json en su raíz —p. ej. {"protocol":"slxd-embed","version":1,"capabilities":["complete","resize"]}— antes de poner la carpeta en el bloque: se lee al escribirla y queda en la propiedad de solo lectura embedPackage. add_brick y update_brick avisan (warnings) si el bloqueo no se podrá cumplir. Para una simulación declara también state, result e interaction, y escribe en el bloque simulationId (único en el contenido: uno repetido se rechaza), scored y weight —get_brick_type_schema describe el protocolo y la nota—; un bloque escrito antes de declarar las capacidades nuevas necesita volver a escribir su embedFolderPrefix para releer el manifiesto. Su slxd-embed.json puede declarar también las variables de su estado, con su tipo ("variables": {"trust": "number", "reused": "boolean"}), para que el contenido condicional las lea; grade, score, maxScore, ending y kind son nombres reservados (leen siempre la nota del paquete) y un paquete que los declare como variables no se acepta al subirlo. El manifiesto, los mensajes y sus límites se explican en Paquetes incrustados y simulaciones.

Las importaciones siguen el mismo patrón prefirmado:

  • Articulate Rise — start_rise_import (sube el .zip) → confirm_rise_import → consulta get_rise_import hasta completed para leer el contentId creado.

La importación de documentos (Importar documento) queda fuera del MCP a propósito: su paso de análisis depende de extracción en el navegador dentro de la app, así que el flujo no puede completarse sin interfaz — hazlo desde la app.

Todas las herramientas de subida autorizan el contenido o el tema de destino (ámbito + pertenencia a la organización; en un tema, además, permiso para editar temas) antes de firmar, y la clave de almacenamiento la construye el servidor — el cliente nunca aporta una ruta cruda.

Accesibilidad

El mismo verificador WCAG 2.2 que mueve el verificador de accesibilidad del editor está expuesto por MCP, así que un asistente puede revisar y corregir un curso de punta a punta:

  1. audit_content_accessibility — recuento de errores/avisos por lección en todo un contenido. Empieza aquí para la vista de curso.
  2. audit_lesson_accessibility — cada problema de una lección: la regla, el criterio WCAG, el bloque afectado, un motivo y el texto de remedio (en el idioma del contenido) y — cuando existe un arreglo seguro — un descriptor autofixes.
  3. apply_accessibility_autofix — aplica uno de esos descriptores (marcar una imagen como decorativa, corregir un nivel de encabezado, activar la cabecera de una tabla, …) al bloque/elemento exacto. Un solo paso de deshacer; los cambios llegan en tiempo real a un editor abierto, igual que update_brick.
  4. generate_accessibility_alt_text — para imágenes sin arreglo determinista seguro, manda la imagen al modelo de visión configurado y devuelve un texto alternativo sugerido. No escribe nada — aplica el resultado con apply_accessibility_autofix (kind: "set-property", o "set-item-property"/"set-character-property" para imágenes de galería/diálogo). Consume créditos de la organización, como el resto de herramientas de IA.

Un flujo típico: llama a audit_content_accessibility, elige una lección con problemas, llama a audit_lesson_accessibility sobre ella, aplica los arreglos deterministas, genera y aplica el texto alternativo del resto, y vuelve a auditar la lección para confirmar que queda limpia.

Diseño instruccional

Un asistente puede construir y comprobar un diseño instruccional entero; por ejemplo, reconstruir uno a partir de un Excel que le des. Las herramientas empiezan por design_matrix_. design_matrix_create, design_matrix_get, design_matrix_list, design_matrix_validate y design_matrix_generate_course son de primer nivel; el resto se alcanza con find_tools y run_tool.

HerramientaPara qué
design_matrix_createCrear un diseño: nombre, duración, nivel, público, idioma (idioma; por defecto, el de tu cuenta) y patrón estructural (no se puede cambiar una vez elegido)
design_matrix_getLeer el diseño entero en una llamada —ficha, competencias, objetivos, árbol de estructura y actividades— con los ids que hacen falta para cualquier edición
design_matrix_listListar los diseños, o la papelera con inTrash: true
design_matrix_update, design_matrix_delete, design_matrix_restoreEditar la ficha (también su idioma); mandar un diseño a la papelera y recuperarlo de ella (borrarlo del todo, solo en la app)
design_matrix_competencia_create, _update, _delete, _reorderCompetencias
design_matrix_objetivo_create, _update, _delete, _set_competencias, _reorderObjetivos, con su nivel de Bloom, su clave visible (clave, opcional) y las competencias a las que sirven
design_matrix_node_create, _rename, _update_horas, _update_objetivo_general, _set_rol, _reorder, _move, _change_level, _subdivide, _deleteEl árbol de estructura: módulos, unidades, apartados y subapartados; _set_rol marca un apartado como introducción o resumen de su unidad
design_matrix_node_link_objetivo, design_matrix_node_unlink_objetivoVincular un objetivo a una hoja del árbol, o desvincularlo
design_matrix_aa_*, design_matrix_ae_* (create, update, delete, set_objetivos, reorder)Las actividades de aprendizaje (aa, de una unidad o de un apartado) y de evaluación (ae, de una unidad) y los objetivos a los que sirven
design_matrix_validatePasar las mismas comprobaciones que el panel de Validación de la app y leer cada hallazgo como una frase, en el idioma del diseño o en el que pidas (locale) y con el título del elemento al que se refiere
design_matrix_exportObtener un enlace firmado para descargar el libro de Excel (.xlsx); con las etiquetas en el idioma del diseño o en el que pidas (locale); el enlace caduca a las 24 horas, aproximadamente
design_matrix_generate_courseCrear los cursos de un diseño que supera la validación, en el idioma del diseño salvo que pidas otro (locale). Solo una generación a la vez por diseño; si una se corta a medias, volver a pedirla con el mismo alcance retoma lo que faltaba sin duplicar cursos. Con leccionActividades y leccionesEvaluacion (true, false o "separadas") eliges, como en el diálogo de la app, si se crean las lecciones de actividades y dónde van los cuestionarios
design_matrix_redaccion_statusVer cómo va la redacción con IA de los cursos generados y si la generación sigue en marcha, sin gastar créditos
design_matrix_review_contextObtener el material para revisar la redacción y la alineación con el modelo de IA del propio asistente: los mismos criterios que la revisión de IA de la app, sin gastar créditos
design_matrix_dictamen_submitRegistrar los dictámenes del asistente como pendientes, con la etiqueta «Revisión del agente» en la sección de revisión de IA de la app; nada del diseño cambia hasta que los aceptes allí. Sin gastar créditos
design_matrix_dictamen_listListar los dictámenes de un diseño, de la IA de la app o del asistente, y su estado

Eliminar un diseño, un nodo, una competencia, un objetivo o una actividad exige confirm: true, como cualquier otra acción destructiva. La revisión de IA de la propia app y la redacción con IA de los cursos generados no están disponibles por MCP —consumen créditos y necesitan la confirmación en pantalla—, así que hazlas en la app; el estado de la redacción sí se consulta con design_matrix_redaccion_status. Tu asistente puede hacer la revisión él mismo, con su propio modelo de IA y sin gastar créditos: pide el material con design_matrix_review_context y registra sus dictámenes con design_matrix_dictamen_submit. Aparecen en la sección Revisión IA con la etiqueta «Revisión del agente», pendientes hasta que los aceptes, corrijas o descartes allí.

Las herramientas que sustituyen un conjunto entero de vínculos (design_matrix_objetivo_set_competencias, design_matrix_aa_set_objetivos y design_matrix_ae_set_objetivos) aceptan expectedUpdatedAt, el updatedAt de ese elemento tal como lo devolvió design_matrix_get: si alguien lo ha cambiado entretanto, la llamada se rechaza sin escribir nada y el asistente sabe que tiene que volver a leerlo.

El updatedAt del diseño que devuelven design_matrix_get y design_matrix_list cambia con cualquier edición de su contenido —competencias, objetivos, estructura, vínculos, actividades u horas—, no solo de la ficha: compararlo dice si algo ha cambiado desde la última lectura.

Colaboración en vivo

Las ediciones de bloques hechas por MCP se fusionan a través del servidor de colaboración: si alguien tiene la lección abierta en el editor, ve aparecer los cambios del asistente en tiempo real, y no se pisa el trabajo de nadie.

Acciones destructivas

Borrar contenidos, lecciones, bloques o temas, volver al tema por defecto, restaurar instantáneas y vaciar la papelera exigen un confirm: true explícito. Sin él, la herramienta responde con una vista previa de lo que pasaría, para que el asistente te pregunte antes.

Notas de operación

  • El servidor de autorización OAuth es parte de la app (plugin mcp de Better Auth); los tokens viven en las tablas oauth_* y caducan a la hora (tokens de refresco: 7 días).
  • El endpoint tiene límite de peticiones por usuario (120 por minuto).
  • Con la facturación activa, el acceso MCP se gatea por la feature apiAccess del plan, exactamente igual que las claves de API.
Servidor MCP