Servidor MCP

Visão geral

O Creator inclui um servidor MCP (Model Context Protocol) incorporado. Qualquer assistente de IA compatível com MCP — Claude em claude.ai, Claude Code, MCP Inspector — pode ligar-se à sua conta Creator e, a partir de um chat, fazer tudo o que o editor faz:

  • Explorar o seu espaço de trabalho e organizações
  • Criar pastas, cursos, microlearnings e bancos de perguntas
  • Adicionar, editar, mover e eliminar lições e todos os 46 tipos de brick com a sua configuração completa
  • Gerir a biblioteca de temas da organização e escolher o tema de cada conteúdo (cores, tipos de letra, capa, CSS personalizado)
  • Exportar para SCORM, web ou PDF, exportar o banco de perguntas (GIFT, Moodle XML ou QTI 2.1), publicar links de partilha, gerir snapshots, duplicar e traduzir

A autenticação usa OAuth contra a sua conta SLXD: o assistente nunca vê a sua palavra-passe e pode revogar o acesso a qualquer momento. Tudo o que o assistente faz está limitado ao que o seu utilizador pode fazer — a associação e os papéis na organização são impostos em cada chamada.

Ligar

O endpoint MCP é o URL do conector da sua organização:

https://<a-sua-organizacao>.slxd.app/mcp/creator

Não precisa de o construir à mão: a plataforma SLXD mostra-o em Organização > Conectores, ao lado dos conectores dos outros produtos da suite.

claude.ai

  1. Vá a Definições > Conectores > Adicionar conector personalizado
  2. Cole o URL do endpoint
  3. Complete o início de sessão e autorize o acesso

Claude Code

claude mcp add --transport http creator https://<a-sua-organizacao>.slxd.app/mcp/creator

A primeira chamada abre o navegador para iniciar sessão e autorizar.

Os clientes registam-se automaticamente (registo dinâmico de cliente OAuth) — não há nada a configurar do lado do servidor.

Como funcionam as ferramentas

O servidor expõe um conjunto selecionado de ferramentas de topo (exploração do espaço de trabalho, CRUD de conteúdo/lição, bricks, tema, exportação, carregamento de ficheiros, duplicação de conteúdo) mais três meta-ferramentas que desbloqueiam o catálogo completo:

browse_workspace cobre três necessidades: explorar um nível de pasta, pesquisar em todo o âmbito por título/nome com query, ou mapear toda a árvore de pastas numa única chamada com recursive: true (cada pasta com o seu parentId). Para clonar um conteúdo — lições, bricks e recursos — como modelo, use duplicate_content (de topo); duplicate_lesson faz o mesmo para uma única lição.

Além da autoria, o catálogo também cobre: o ciclo de vida completo do lixo para pastas (restore_folder, delete_folder_permanently) e operações em lote sobre conteúdo (batch_move_contents, batch_trash_contents); copiar um conteúdo para outro espaço, sempre uma cópia e nunca uma mudança (copy_content_to_tenant); gestão de versões (rename_snapshot, delete_snapshot); pesquisa em bibliotecas de stock licenciadas e importação de um recurso para um conteúdo (search_stock_images/import_stock_image, search_stock_icons/import_stock_icon); e auditoria e correção de problemas de acessibilidade (ver abaixo). A média que o modelo gera por si mesmo é carregada com request_asset_upload.

Meta-ferramentaFinalidade
find_toolsPesquisar em todo o catálogo por palavra-chave (publicação, snapshots, tradução, modelos, lixo…)
tool_schemaObter o esquema de entrada de qualquer ferramenta do catálogo
run_toolExecutar uma ferramenta do catálogo pelo nome

Para os bricks, list_brick_types lista todos os tipos agrupados por categoria (texto, média, coleções, perguntas, jogos, estrutura da lição — structure) com uma sugestão de "quando usar" para escolher o mais adequado a um objetivo pedagógico, e get_brick_type_schema devolve a forma exata de autoria (com um exemplo) para cada um — o texto rico é gerado como HTML simples. O código em linha (<code>) é aceite em todos os campos de texto com várias linhas e os blocos de código (<pre><code class="language-…">, mantendo a linguagem) nos de formato completo (get_brick_type_schema lista-os em richText); os campos de uma linha rejeitam ambos com um erro que indica o campo. O que é guardado mas muda pelo caminho — uma etiqueta, um atributo ou um estilo que o editor não consegue manter, uma ligação num campo sem ligações, parágrafos unidos num campo de uma linha — volta no resultado de add_brick e update_brick em warnings, campo a campo, sem ter de reler a lição.

A categoria structure contém o tipo CONDITIONAL (Conteúdo condicional): add_brick recebe os seus ramos e os blocos de cada um numa só chamada, get_lesson devolve os blocos aninhados dentro de cada ramo, e update_brick, move_brick e delete_brick atuam sobre o grupo inteiro. A gramática da condição e as regras (um só nível, nunca em exames nem em bancos) estão em Conteúdo condicional; o manifesto e as mensagens das simulações que lê, em Pacotes incorporados e simulações.

Escolher o brick certo

Para ajudar o assistente a escolher o brick mais apropriado, list_brick_types inclui orientação de "quando usar" por tipo, e o recurso creator://guides/brick-selection é um guia de seleção completo (intenção → bricks recomendados). Ambos são gerados a partir da mesma fonte, pelo que nunca divergem, e ambos funcionam em qualquer cliente MCP.

Temas

Os temas ficam na biblioteca de temas da organização e cada conteúdo usa um. Vários conteúdos podem partilhar o mesmo tema, por isso alterar um tema altera todos os conteúdos que o usam.

FerramentaPara quê
list_themesVer os temas da biblioteca, quantos conteúdos usam cada um e qual é o tema predefinido (o que os conteúdos novos recebem)
get_themeLer um tema por contentId (o que esse conteúdo usa) ou por themeId. Devolve também a sua version e quantos conteúdos o usam
get_theme_schemaVer o que um tema pode conter, sem ler nenhum tema: de cada campo, o caminho exato, a forma que aceita (um comprimento ou até quatro, uma cor como texto —palette:accent— nos estilos dos blocos ou como {"paletteId": "accent"} no resto, opções, intervalos), o valor predefinido ou o campo de onde o tira, o que muda no ecrã e os tipos de bloco que o usam. Sem filtros, enumera as secções e o que o tema não pode mudar (com a alternativa); filtra-se por section, por brickType (p. ex. TIMELINE) ou por texto com search
update_themeAlterar um tema por contentId ou por themeId. Afeta todos os conteúdos que o usam, e a resposta diz quantos (affectedContents). Se passar a version lida e outra pessoa tiver alterado o tema entretanto, nada é guardado e é preciso lê-lo de novo. O que guarda de forma diferente de como chegou, ou com um problema, volta em warnings, campo a campo: um campo que não existe (com o mais parecido), um valor com outra forma (com a que esse campo aceita, a mesma que dá get_theme_schema) ou fora do intervalo, um valor guardado de outra maneira, o que descarta de um tipo de letra próprio (só regular, regularItalic, bold e boldItalic, pesos 400 e 700) e, se as cores mudarem, um «Texto sobre destaque» que não chega ao contraste AA (4,5:1) com o destaque; sem valor próprio, esse texto usa a cor do texto
create_themeCriar um tema: com o aspeto predefinido, a partir de uma predefinição, ou como cópia de outro tema ou do tema de um conteúdo
set_content_themeEscolher o tema de um conteúdo
apply_theme_presetDar a um conteúdo o aspeto de uma predefinição: recebe um tema da biblioteca igual à predefinição, que é criado se não existir nenhum
reset_themeVoltar a pôr num conteúdo o tema predefinido da organização
delete_themeEliminar um tema que nenhum conteúdo usa (nem no lixo) e que não é o tema predefinido

Para alterar o aspeto de um só conteúdo cujo tema é partilhado por outros, copie o seu tema (create_theme com fromContentId), atribua-lhe a cópia com set_content_theme e edite a cópia. Mudar o tema de um conteúdo não altera o que deixa de usar: continua na biblioteca. import_theme_from_content já não existe: usar o tema de outro conteúdo é escolhê-lo com set_content_theme.

Quem pode editar conteúdos na organização pode editar os seus temas.

Carregar ficheiros

O conteúdo do Creator usa ficheiros — imagens, vídeo, áudio, legendas, anexos descarregáveis, tipos de letra personalizados, pacotes de incorporação — e o MCP pode carregá-los. O binário nunca passa pelo MCP (sem base64): a ferramenta gera um URL de carregamento pré-assinado de curta duração e o cliente envia o ficheiro diretamente para o armazenamento, fora de banda.

O fluxo para um recurso de brick:

  1. Chame request_asset_upload com o contentId de destino, o kind (image | video | audio | subtitle | attachment | font) e o contentType do ficheiro (por exemplo, image/png). Para um ficheiro do tema (logótipo, imagem do cabeçalho, ícones, tipos de letra woff2 personalizados), passe themeId em vez de contentId: o ficheiro fica com o tema e não depende de nenhum conteúdo; só aceita image e font. Cada tipo tem uma lista de MIME permitidos, pelo que um tipo incompatível é rejeitado de imediato.
  2. A ferramenta devolve { uploadUrl, path, curlCommand, expiresAt }. Carregue o ficheiro — execute o curlCommand devolvido (substituindo <local-file> pelo caminho real) ou faça um PUT dos bytes para uploadUrl com o Content-Type exato. O URL expira ao fim de 15 minutos.
  3. Coloque o path devolvido no campo de média do brick através de add_brick / update_brick (imagePath, videoPath, audioPath, filePath, posterPath, subtitlesPath, front*/back*/…), ou no tema através de update_theme (logótipo, tipos de letra woff2 personalizados), com o mesmo themeId. A imagem de capa e o título do curso pertencem a cada conteúdo, não ao tema: carregue a imagem com o contentId e defina-a com update_content (coverImagePath; courseTitle para o título do curso); get_content devolve-os. Para substituir a imagem de capa, coloque o novo caminho em coverImagePath: a imagem muda e o título do curso e a camada de cor ficam como estavam; o ficheiro anterior não é apagado, a limpeza de armazenamento recolhe-o. A camada de cor da imagem e a posição e os estilos do título do curso ficam no tema. A imagem dos cabeçalhos de lição também pertence ao conteúdo: defina-a com update_content (lessonHeaderImagePath) e o tema mostra-a com lessonHeader.background.type: image; cada lição pode ter a sua com update_lesson (headerImagePath; null volta a herdar), que prevalece sempre. A camada de cor fica no tema (lessonHeader.image.overlay).

list_content_assets devolve os ficheiros já carregados para um conteúdo, para que um recurso existente possa ser reutilizado em vez de carregado novamente.

As imagens SVG são a exceção: um SVG é código, por isso nunca é carregado por um URL assinado (request_asset_upload rejeita image/svg+xml). Envie-o com upload_svg_image: o SVG viaja na chamada, como texto (svg) ou em base64 (svgBase64), até 5 MB, com contentId ou themeId. O servidor higieniza-o com as mesmas regras do editor (remove scripts, atributos de evento e ligações e recursos externos) e guarda apenas o resultado; o path devolvido serve em qualquer campo de imagem. Se não puder ser lido sem risco, nada é guardado e o erro traz um código estável: [svg_not_svg], [svg_malformed] ou [svg_too_large]. Um SVG é sempre mostrado como imagem, que não carrega nenhum tipo de letra externo: se o texto não incorporar o tipo de letra (ou não estiver convertido em contornos), o resultado traz o aviso svg_text_without_font e o texto sairá com o tipo de letra do dispositivo do formando. Os bancos de imagens e ícones (import_stock_icon, import_stock_image) higienizam os SVG da mesma forma. import_stock_image só aceita um downloadUrl tal como search_stock_images o devolveu, com o mesmo provider, e só guarda imagens: o tipo é lido dos bytes descarregados (PNG, JPEG, WebP, GIF, AVIF ou um SVG higienizado, até 30 MB), nunca do URL nem do Content-Type. O resto não guarda nada e falha com um código estável: [stock_url_not_allowed], [stock_not_image], [stock_too_large], [stock_blocked_target] (um redirecionamento para um endereço sem https ou interno) ou [stock_too_many_redirects].

Bricks de incorporação (um pacote autónomo de index.html + recursos) usam request_embed_upload: carregue cada ficheiro do pacote sob o mesmo folderId, depois defina o embedFolderPrefix devolvido no brick EMBED. Estes ficam alojados no bucket privado embeds com o seu Content-Type fixado e são servidos a quem os vê através de URL efémeros por pasta — nunca a partir de um domínio público. Para que o pacote possa concluir o brick (e assim cumprir o seu bloqueio) ou definir a sua própria altura, carregue também um slxd-embed.json na sua raiz —p. ex. {"protocol":"slxd-embed","version":1,"capabilities":["complete","resize"]}— antes de definir a pasta no brick: é lido nesse momento e fica na propriedade só de leitura embedPackage. add_brick e update_brick avisam (warnings) se o bloqueio não puder ser cumprido. Para uma simulação, declare também state, result e interaction, e escreva no bloco simulationId (único no conteúdo: um repetido é rejeitado), scored e weight — get_brick_type_schema descreve o protocolo e a nota; um bloco escrito antes de o pacote declarar as novas capacidades precisa de voltar a escrever o seu embedFolderPrefix para reler o manifesto. O seu slxd-embed.json pode declarar também as variáveis do seu estado, com o seu tipo ("variables": {"trust": "number", "reused": "boolean"}), para que o conteúdo condicional as leia; grade, score, maxScore, ending e kind são nomes reservados (leem sempre o resultado do pacote) e um pacote que os declare como variáveis não é aceite ao carregá-lo. O manifesto, as mensagens e os seus limites estão explicados em Pacotes incorporados e simulações.

Importações seguem o mesmo padrão pré-assinado:

  • Articulate Rise — start_rise_import (carregar o .zip) → confirm_rise_import → sondar get_rise_import até completed para ler o contentId criado.

A importação de documentos (Importar documento) não é exposta intencionalmente via MCP: o seu passo de análise depende de extração do lado do navegador na aplicação, pelo que o fluxo não pode ser concluído sem interface — faça-o na aplicação.

Todas as ferramentas de carregamento autorizam o conteúdo ou o tema de destino (âmbito + associação à organização; num tema, também a permissão para editar temas) antes de assinar, e o servidor constrói a chave de armazenamento — um cliente nunca fornece um caminho em bruto.

Acessibilidade

O mesmo verificador WCAG 2.2 que alimenta o verificador de acessibilidade do editor é exposto via MCP, para que um assistente possa rever e corrigir um curso de ponta a ponta:

  1. audit_content_accessibility — contagens de erros/avisos por lição num conteúdo. Comece aqui para uma visão geral do curso.
  2. audit_lesson_accessibility — cada problema numa lição: a regra, o critério WCAG, o brick afetado, uma razão e o texto de correção (no idioma do conteúdo), e — quando existe uma correção segura — um descritor autofixes.
  3. apply_accessibility_autofix — aplica um desses descritores (marcar uma imagem como decorativa, corrigir o nível de um título, ativar um cabeçalho de tabela…) ao brick/item exato. Um passo de anulação; as alterações chegam a um editor aberto em tempo real, tal como update_brick.
  4. generate_accessibility_alt_text — para imagens sem uma correção determinística segura, envia a imagem ao modelo de visão de IA configurado e devolve texto alternativo sugerido. Não escreve nada — aplique o resultado com apply_accessibility_autofix (kind: "set-property", ou "set-item-property"/"set-character-property" para imagens de galeria/diálogo). Consome créditos da organização, tal como as outras ferramentas de IA.

Um fluxo típico: chame audit_content_accessibility, escolha uma lição com problemas, chame audit_lesson_accessibility sobre ela, aplique as correções determinísticas, gere e aplique texto alternativo para o resto, depois volte a executar a auditoria da lição para confirmar que está limpa.

Design instrucional

Um assistente pode construir e verificar um design instrucional inteiro; por exemplo, reconstruir um a partir de um ficheiro Excel que lhe dê. As ferramentas começam por design_matrix_. design_matrix_create, design_matrix_get, design_matrix_list, design_matrix_validate e design_matrix_generate_course são de primeiro nível; as restantes alcançam-se com find_tools e run_tool.

FerramentaPara quê
design_matrix_createCriar um design: nome, duração, nível, público, idioma (idioma; por predefinição, o da sua conta) e padrão estrutural (não pode ser alterado depois de escolhido)
design_matrix_getLer o design inteiro numa chamada — ficha, competências, objetivos, árvore de estrutura e atividades — com os ids necessários para qualquer edição
design_matrix_listListar os designs, ou o lixo com inTrash: true
design_matrix_update, design_matrix_delete, design_matrix_restoreEditar a ficha (também o idioma); enviar um design para o lixo e recuperá-lo (eliminá-lo de vez, só na aplicação)
design_matrix_competencia_create, _update, _delete, _reorderCompetências
design_matrix_objetivo_create, _update, _delete, _set_competencias, _reorderObjetivos, com o seu nível de Bloom, o seu código visível (clave, opcional) e as competências a que servem
design_matrix_node_create, _rename, _update_horas, _update_objetivo_general, _set_rol, _reorder, _move, _change_level, _subdivide, _deleteA árvore de estrutura: módulos, unidades, secções e subsecções; _set_rol marca uma secção como introdução ou resumo da sua unidade
design_matrix_node_link_objetivo, design_matrix_node_unlink_objetivoAssociar um objetivo a uma folha da árvore, ou dissociá-lo
design_matrix_aa_*, design_matrix_ae_* (create, update, delete, set_objetivos, reorder)As atividades de aprendizagem (aa, de uma unidade ou de uma secção) e de avaliação (ae, de uma unidade) e os objetivos a que servem
design_matrix_validateExecutar as mesmas verificações do painel de Validação da aplicação e ler cada resultado como uma frase, no idioma do design ou no que pedir (locale) e com o título do elemento a que se refere
design_matrix_exportObter uma ligação de descarga assinada para o livro de Excel (.xlsx), com as etiquetas no idioma do design ou no que pedir (locale); a ligação expira ao fim de cerca de 24 horas
design_matrix_generate_courseCriar os cursos de um design que passa a validação, no idioma do design salvo se pedir outro (locale). Só uma geração de cada vez por design; se uma parar a meio, voltar a pedi-la com o mesmo alcance retoma o que faltava sem duplicar cursos. Com leccionActividades e leccionesEvaluacion (true, false ou "separadas") escolhes, como no diálogo da app, se se criam as lições de atividades e onde vão os questionários
design_matrix_redaccion_statusVer como vai a redação com IA dos cursos gerados e se a geração ainda está em curso, sem gastar créditos
design_matrix_review_contextObter o material para rever a redação e o alinhamento com o modelo de IA do próprio assistente: os mesmos critérios da revisão de IA da aplicação, sem gastar créditos
design_matrix_dictamen_submitRegistar os pareceres do assistente como pendentes, com a etiqueta «Revisão do agente» na secção de revisão de IA da aplicação; nada no design muda até os aceitar lá. Sem gastar créditos
design_matrix_dictamen_listListar os pareceres de um design, da IA da aplicação ou do assistente, e o seu estado

Eliminar um design, um nó, uma competência, um objetivo ou uma atividade exige confirm: true, como qualquer outra ação destrutiva. A revisão de IA da própria aplicação e a redação com IA dos cursos gerados não estão disponíveis por MCP — consomem créditos e precisam da confirmação no ecrã —, por isso faça-as na aplicação; o estado da redação consulta-se com design_matrix_redaccion_status. O seu assistente pode fazer a revisão ele próprio, com o seu modelo de IA e sem gastar créditos: pede o material com design_matrix_review_context e regista os seus pareceres com design_matrix_dictamen_submit. Aparecem na secção Revisão de IA com a etiqueta «Revisão do agente», pendentes até os aceitar, corrigir ou descartar lá.

As ferramentas que substituem um conjunto inteiro de vínculos (design_matrix_objetivo_set_competencias, design_matrix_aa_set_objetivos e design_matrix_ae_set_objetivos) aceitam expectedUpdatedAt, o updatedAt desse elemento tal como design_matrix_get o devolveu: se alguém o tiver alterado entretanto, a chamada é recusada sem escrever nada e o assistente sabe que tem de o voltar a ler.

O updatedAt do design devolvido por design_matrix_get e design_matrix_list muda com qualquer edição do seu conteúdo —competências, objetivos, estrutura, vínculos, atividades ou horas—, não só da ficha: compará-lo diz se algo mudou desde a última leitura.

Colaboração em tempo real

As edições de brick feitas via MCP são fundidas através do servidor de colaboração: se alguém tiver a lição aberta no editor, verá as alterações do assistente aparecer em tempo real, e o trabalho de ninguém é substituído.

Ações destrutivas

Eliminar conteúdo, lições, bricks ou temas, voltar ao tema predefinido, restaurar snapshots e esvaziar o lixo exigem todos um confirm: true explícito. Sem ele, a ferramenta responde com uma pré-visualização do que aconteceria, para que o assistente possa perguntar-lhe primeiro.

Notas de operação

  • O servidor de autorização OAuth faz parte da aplicação (plugin mcp do Better Auth); os tokens vivem nas tabelas oauth_* e expiram ao fim de 1 hora (tokens de atualização: 7 dias).
  • O endpoint tem um limite de taxa por utilizador (120 pedidos/minuto).
  • Quando a faturação está ativada, o acesso MCP é controlado pela funcionalidade apiAccess do plano, tal como as chaves de API.
Servidor MCP