Antes de começar
Reveja os requisitos: Moodle 4.2 ou superior, acessível publicamente por HTTPS, serviços web ativos e permissões de administrador do site.
1. Crie a sua organização
Registe-se e crie uma organização. A organização é dona dos membros, da faturação e das ligações Moodle; inclui 30 dias de período experimental sem cartão.
2. Crie uma ligação Moodle
No painel, abra Organização → Moodle e preencha Ligar um site Moodle:
- um slug da ligação — letras minúsculas, dígitos e hífenes, por exemplo main-campus. Identifica este Moodle no URL do conector, por isso escolha algo reconhecível.
- o URL do Moodle do site, por HTTPS.
O painel responde com uma chave de licença e um segredo do painel, mostrados uma única vez: copie-os antes de sair da página. Pode criar tantas ligações quantas o seu plano permitir — a página indica quantos lugares restam. Os detalhes estão em ligar o seu site.
3. Instale o plugin nesse Moodle
Abra a ligação a partir da lista e use Transferir o plugin (.zip). Instale-o no seu Moodle em Administração do site → Plugins → Instalar plugins, abra MCP Connector → Licença e cole os quatro valores: o URL do painel, a chave de licença, o segredo do painel e o URL do conector desta ligação. Clique em Validar licença. Veja o plugin do Moodle.
De volta ao painel, Verificar agora, na página da ligação, pergunta em direto ao Moodle se o serviço web responde e se o plugin está instalado.
4. Provisione um utilizador e obtenha uma chave
Na secção Utilizadores do plugin, atribua um utilizador a um serviço conforme o seu papel. O plugin emite um token do Moodle, o painel transforma-o numa chave MCP (mcpk_…) e o utilizador recebe-a por email. O valor é mostrado uma única vez.
Os proprietários e administradores também podem emitir chaves diretamente em Organização → Moodle → Chaves MCP, escolhendo a que ligação pertence a chave. Uma chave só funciona na sua própria ligação.
5. Ligue o seu assistente
Cada ligação tem o seu próprio URL de conector, com esta forma:
https://<a-sua-organizacao>.slxd.app/mcp/lmsmcp/<ligacao>
Não o escreva à mão: a página da ligação mostra-o em URL do conector com um botão de copiar, e a lista de ligações também.
- ChatGPT ou Claude (claude.ai ou Claude Desktop): adicione-o como conector remoto e escolha Iniciar sessão com o seu Moodle. Não há chave para colar.
- Cursor, VS Code, Claude Code, scripts: envie a chave MCP num cabeçalho Bearer.
As instruções passo a passo por cliente estão em configurar o cliente.
6. Pergunte alguma coisa
Experimente uma destas para confirmar que está tudo ligado:
- «Em que cursos estou inscrito?»
- «Lista os participantes do curso de Introdução à Biologia.»
- «Que trabalhos têm prazo nas próximas duas semanas?»
Se preferir não configurar nenhum cliente, abra o chat de IA do painel: usa as mesmas ferramentas sem qualquer configuração.
Se algo não funcionar
A maioria dos problemas iniciais está na validação da licença, no URL do site ou numa chave apontada à ligação errada. Veja a resolução de problemas.