Saltar para o conteúdo principal
Documentação

O que é o MoodleMCP

Visão geral

O MoodleMCP liga o seu site Moodle a assistentes de IA. Depois de ligado, pode perguntar coisas como «que alunos ainda não entregaram o ensaio?» ou «cria uma atividade SCORM no curso de acolhimento a partir deste pacote», e o assistente lê — e, quando o autorizar, escreve — no seu próprio Moodle.

Tudo assenta no Model Context Protocol (MCP), a norma aberta que os assistentes de IA usam para falar com sistemas externos. Qualquer cliente que fale MCP se pode ligar: Claude, ChatGPT, Cursor, Claude Code e outros.

As três peças

PeçaOnde correO que faz
O painelAqui, em moodlemcp.comOnde regista o seu Moodle, gere as chaves de acesso e vê a utilização.
O pluginDentro do seu MoodleLiga o seu site ao painel e atribui acesso por utilizador. Instala-se uma vez.
O servidor MCPAlojado por nósO ponto de acesso a que o seu assistente se liga. Executa chamadas aos serviços web do Moodle em seu nome.

Como funciona o acesso

O MoodleMCP nunca recebe uma palavra-passe. O acesso assenta nos tokens de serviço web e nos papéis do próprio Moodle:

  1. O plugin gera um token do Moodle para um utilizador, limitado ao seu papel.
  2. O painel guarda esse token cifrado e devolve uma chave MCP — a credencial que o assistente realmente apresenta.
  3. Cada pedido do assistente corre como esse utilizador do Moodle, com as suas permissões. A chave de um docente nunca verá o que esse docente não pode ver.

Como a chave é uma credencial separada, pode suspendê-la ou revogá-la a qualquer momento sem mexer na conta do Moodle — e o corte aplica-se logo na chamada seguinte do assistente.

O que pode fazer

  • Consultar os seus cursos: inscrições, conteúdos, participantes, grupos, notas, prazos, atividade nos fóruns, mensagens.
  • Criar e alterar conteúdos: testes, pacotes SCORM, atividades H5P, recursos de ficheiro, medalhas, cópias de segurança e restauros, importação de perguntas.
  • Usar o chat integrado: o painel traz o seu próprio chat com IA e as mesmas ferramentas, pelo que pode começar sem configurar qualquer cliente.

As operações de escrita pedem sempre a sua aprovação explícita no chat, e uma chave pode ser restringida a apenas leitura, a um subconjunto de ferramentas ou a cursos específicos.

Por onde continuar

  • É novo por aqui? Siga o guia rápido: site ligado e um assistente a responder em cerca de quinze minutos.
  • Quer confirmar se o seu Moodle serve? Veja os requisitos.
  • Já ligado e quer configurar um cliente concreto? Veja ligar um assistente.