Ligar um assistente

O seu ponto de acesso

Cada organização tem o seu próprio ponto de acesso MCP, servido pelo seu próprio Moodle, num subdomínio por organização:

https://<a-sua-organizacao>.moodlemcp.com/mcp

Não precisa de construir o URL à mão: o painel mostra-o com um botão de copiar em Organização → Moodle, e se lhe atribuíram acesso a partir do plugin também chega no email junto com a sua chave.

Fala o transporte padrão Streamable HTTP do MCP, pelo que qualquer cliente compatível se pode ligar. As instruções por cliente estão em configurar o cliente.

Duas formas de se autenticar

Escolha consoante o seu cliente. Se usa ChatGPT ou Claude — o caso mais comum — a via é a primeira.

Iniciar sessão com o seu Moodle (OAuth) — recomendada

É a via do ChatGPT e do Claude (tanto o claude.ai no navegador como o Claude Desktop), e a recomendada sempre que o seu cliente a suportar. Adicione o ponto de acesso como conetor MCP remoto; na primeira ligação abre-se uma janela do navegador: escolha Iniciar sessão com o seu Moodle, entre no seu próprio Moodle e aprove.

A partir daí o assistente fica ligado à sua identidade e aos seus papéis no Moodle. Não há nenhuma chave para copiar, guardar ou enviar por email, por isso não há nada que possa fugir. Voltar a autorizar, ou revogar a chave subjacente, corta a ligação.

Uma chave MCP

Para clientes que aceitam um token (Cursor, Claude Code, scripts, CI): envie a chave num cabeçalho Bearer. Proprietários e administradores emitem chaves em Organização → Moodle → Chaves MCP, e o plugin pode enviar uma por email a cada utilizador com acesso atribuído. O valor é mostrado uma única vez.

O que acontece em cada chamada

Seja qual for a via, o servidor MCP executa funções de serviço web do Moodle com o seu token e os seus papéis guardados. A autenticação é verificada em cada pedido, pelo que uma credencial revogada, suspensa ou expirada é cortada na chamada seguinte: não há sessão que expire.

Todas as chamadas, diretas ou através das ferramentas de passagem, passam pelo mesmo cliente Moodle endurecido (ligações fixadas contra SSRF, tempo limite de pedido e teto de tamanho de resposta em streaming) e pelo mesmo controlo de papéis. O que uma chave pode fazer está em chaves e permissões.

Sem cliente? Use o painel

O chat com IA do painel usa o mesmo catálogo de ferramentas sem qualquer configuração, o que é útil para confirmar que a ligação funciona antes de ligar seja o que for.