Saltar para o conteúdo principal
Documentação

Guia rápido

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. Uma organização corresponde a uma instalação do Moodle e é a unidade dona da ligação, das chaves e da faturação. Inclui 30 dias de período experimental sem cartão.

2. Ligue o seu site Moodle

No painel, abra Organização → Moodle e introduza o URL do seu Moodle. Vai receber uma chave de licença e um segredo do painel — mostrados uma única vez: copie-os antes de sair da página — junto com o URL do seu ponto de acesso MCP. Os detalhes estão em ligar o seu site.

3. Instale o plugin

Instale o local_mcpconnector no seu Moodle a partir de Administração do site → Plugins → Instalar plugins, abra MCP Connector → Licença e cole os quatro valores que o painel mostra: o URL do painel, a chave de licença, o segredo e o URL do ponto de acesso MCP. Clique em Validar licença. Veja o plugin do Moodle.

4. Atribua acesso a um utilizador e obtenha uma chave

Na secção Utilizadores do plugin, associe um utilizador a um serviço conforme o seu papel. O plugin gera 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.

Proprietários e administradores também podem emitir chaves diretamente em Organização → Moodle → Chaves MCP.

5. Ligue o seu assistente

Aponte o assistente ao ponto de acesso da sua organização:

https://<a-sua-organizacao>.moodlemcp.com/mcp
  • ChatGPT ou Claude (claude.ai ou Claude Desktop): adicione-o como conetor remoto e escolha Iniciar sessão com o seu Moodle. Não há nenhuma chave para colar.
  • Cursor, VS Code, Claude Code, scripts: envie a chave MCP num cabeçalho Bearer.

Os passos 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 entrega nas próximas duas semanas?»

Se preferir não configurar nenhum cliente, abra o chat com 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 ou no URL do site. Veja a resolução de problemas.