Pular para o conteúdo

Ferramentas · Cursos

Ferramentas MCP para cursos: listar e ver cursos com módulos e aulas, montar um curso inteiro com o produto que o vende, editar e excluir o curso, acrescentar, editar, mover e excluir módulos e aulas, e o lado do aluno: matrícula e progresso.

Montar e manter cursos: um curso inteiro numa chamada (espaço, módulos, aulas e o produto de venda), a capa e o status, e depois os módulos e as aulas: acrescentar, renomear, mudar de ordem, levar uma aula para outro módulo e excluir. Quem é aluno se matricula e marca o progresso pela conversa. O conteúdo de cada aula (texto, vídeo) ainda entra pelo painel.

Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.

Em resumo

FerramentaO que fazPapel mínimoTipo
list_coursesCursos da comunidadeQualquerSó consulta
get_courseUm curso com módulos e aulasQualquerSó consulta
create_courseEspaço, curso, módulos, aulas e o produto, de uma vezAdministradorAltera
update_courseEdita um curso, a capa e o statusAdministradorAltera
create_course_moduleAcrescenta um módulo a um cursoAdministradorAltera
create_lessonAcrescenta uma aula a um móduloAdministradorAltera
update_course_moduleRenomeia um módulo ou muda a posiçãoAdministradorAltera
update_lessonMuda uma aula, ou a leva para outro móduloAdministradorAltera
delete_course_moduleExclui um módulo com as aulasAdministradorPede confirmação
delete_lessonExclui uma aulaAdministradorPede confirmação
delete_courseExclui um cursoAdministradorPede confirmação
enroll_in_courseMatricula você num curso publicadoMembro (não o financeiro)Altera
complete_lessonRegistra o seu progresso numa aulaMembro (não o financeiro)Altera

list_courses

Só consulta

Listar cursos. Os cursos da comunidade. Papel mínimo: qualquer.

ParâmetroTipoObrigatórioDescrição
space_ididNãoSó os cursos de um espaço de cursos

Devolve: os cursos, com id, slug, título, nível e status.

Peça assim: "Que cursos já existem?"

get_course

Só consulta

Ver curso com módulos e aulas. Um curso com a estrutura completa. Papel mínimo: qualquer.

ParâmetroTipoObrigatórioDescrição
coursetextoSimO id ou o slug do curso

Devolve: o curso, os módulos (com o id que create_lesson pede) e as aulas de cada módulo.

Peça assim: "Mostre a estrutura do curso Excel do Zero."

create_course

Altera

Criar curso completo. Espaço de Cursos → curso → módulos → aulas → (opcional) o produto que libera o espaço. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
titletexto, até 255SimO título do curso
descriptiontexto simplesNãoSem formatação: marcas de Markdown são tiradas
levelbeginner, intermediate, advancedNãoPadrão: beginner
space_ididNãoUm espaço de Cursos que já existe
section_ididNãoOnde criar o espaço, se space_id não vier
space_titletextoNãoPadrão: o título do curso
iconum dos ícones da listaNãoO ícone do espaço criado. Ver Ícones
image_urllinkNãoA capa do curso. Ver Imagens
moduleslista, até 30NãoCada um com title (obrigatório) e lessons
saleobjetoNãoO produto que vende o curso (veja abaixo)
idempotency_keytexto, até 100Não

Cada módulo tem title e lessons, uma lista de até 50, e cada aula tem title (obrigatório), type (text, video, link, image; padrão text) e duration (ex.: 12 min).

A venda (e o ingresso, no create_event):

CampoTipoDescrição
pricenúmero, em reaisObrigatório
titletexto, de 3 a 255Padrão: o título do curso (ou Ingresso — título do evento)
typeONE_TIME, INSTALLMENT, SUBSCRIPTIONPadrão: ONE_TIME (avulso)
intervalMONTHLY, YEARLYSó em SUBSCRIPTION
max_installments1 a 12Até quantas vezes no cartão
stocknúmeroQuantidade à venda
direct_linksim ou nãoVendável por link direto
publishsim ou nãoPôr à venda já. Padrão: rascunho

Devolve: o espaço (e se foi criado agora), o curso (id, título, slug, status), os módulos com as aulas, e o produto (id, título, preço, status), se houver.

Peça assim: "Monte o curso Excel do Zero no espaço de cursos, com os módulos Fundamentos, Fórmulas e Tabelas dinâmicas, 3 aulas de vídeo em cada, e um produto de R$ 297 em até 10×, em rascunho."

Notas: as aulas guardam título, tipo e duração; o conteúdo entra pelo painel. O produto libera o espaço do curso para quem compra.

update_course

Altera

Editar curso. Muda título, descrição, nível, status (draft, published, archived) e a capa. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
courseid, slug ou linkSim
title, descriptiontextoNão
levelbeginner, intermediate, advancedNão
statusdraft, published, archivedNão
image_url ou image_base64link ou arquivoNãoA capa nova

Peça assim: "Publique o curso Excel do Zero e troque a capa por esta."

Notas: módulos e aulas mudam com update_course_module, update_lesson e as ferramentas de exclusão.

create_course_module

Altera

Adicionar módulo a um curso. Acrescenta um módulo ao fim de um curso que já existe. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
course_ididSimDe list_courses ou create_course
titletextoSim

Devolve: o módulo criado, com o id que create_lesson pede.

Peça assim: "Acrescente o módulo Gráficos ao curso Excel do Zero."

Notas: para renomear ou mudar a posição depois, update_course_module.

create_lesson

Altera

Adicionar aula a um módulo. Acrescenta uma aula ao fim de um módulo. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
module_ididSimDe get_course
titletextoSim
typetext, video, link, imageNãoPadrão: text
durationtextoNãoEx.: 12 min

Devolve: a aula criada.

Peça assim: "No módulo Gráficos, crie as aulas Gráfico de linhas (8 min) e Gráfico de pizza (6 min), as duas de vídeo."

Notas: a aula guarda título, tipo e duração. O conteúdo (o texto, o vídeo) ainda não é gravado pelo MCP: entra pelo painel.

update_course_module

Altera

Editar módulo do curso. Renomeia um módulo ou muda a posição dele. Só o que for enviado muda. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
module_ididSimDe get_course
titletexto, até 255Não
ordernúmero, a partir de 0NãoA posição no curso

Peça assim: "Renomeie o módulo Fórmulas para Fórmulas essenciais e ponha ele em segundo."

update_lesson

Altera

Editar aula. Muda o título, o tipo, a duração ou a posição de uma aula, ou a leva para outro módulo do mesmo curso. Só o que for enviado muda. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
lesson_ididSimDe get_course
titletexto, até 255Não
typetext, video, link, imageNão
durationtextoNãoEx.: 12 min
ordernúmero, a partir de 0NãoA posição no módulo
module_ididNãoLeva a aula para este módulo (do mesmo curso). Sem order, ela vai para o fim

Peça assim: "Passe a aula Gráfico de pizza para o módulo Fundamentos, como última aula."

Notas: o conteúdo da aula continua entrando pelo painel.

delete_course_module

Pede confirmação

Excluir módulo do curso. Exclui um módulo e todas as aulas dele. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
module_ididSimDe get_course
courseid, slug ou linkNãoO curso, para o resumo mostrar o nome do módulo e das aulas

Notas: o progresso de quem já assistiu fica guardado.

delete_lesson

Pede confirmação

Excluir aula. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
lesson_ididSimDe get_course
courseid, slug ou linkNãoO curso, para o resumo mostrar o nome da aula

Notas: o progresso de quem já assistiu fica guardado.

delete_course

Pede confirmação

Excluir curso. O curso é arquivado e sai do feed. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
courseid, slug ou linkSim

Devolve: na primeira chamada, o título, quantos módulos e quantas matrículas o curso tem, e o código de confirmação.

enroll_in_course

Altera

Matricular-se no curso. Matricula você num curso publicado. Papel: proprietário, administrador, moderador ou membro.

ParâmetroTipoObrigatórioDescrição
courseid, slug ou linkSim

Peça assim: "Me matricule no curso Excel do Zero."

complete_lesson

Altera

Registrar progresso na aula. Marca uma aula como concluída, ou registra uma porcentagem, num curso em que você está matriculado. Papel: proprietário, administrador, moderador ou membro.

ParâmetroTipoObrigatórioDescrição
courseid, slug ou linkSim
lesson_ididSimDe get_course
completedsim ou nãoNãoPadrão sim
progress_percentde 0 a 100Não

Peça assim: "Marque como vista a aula Fórmulas básicas."

Relacionados