A validação da licença falha
«Credenciais inválidas» — a chave de licença e o segredo do painel têm de ser o par emitido em conjunto para essa ligação. Se rodou as credenciais, o plugin continua com o par antigo: cole o novo. Se só copiou um dos valores antes de sair da página, rode para obter um par novo. Se gere vários Moodle, confirme que não colou o par de outra ligação.
«O URL não corresponde» — o site que chama não corresponde ao URL registado para a ligação. É comum quando o Moodle está atrás de um proxy e o $CFG-wwwroot difere do nome público, ou depois de uma mudança de domínio. Atualize o URL a partir da linha da ligação em Organização → Moodle e valide outra vez.
O plugin não chega sequer ao painel — o seu Moodle precisa de saída HTTPS. Teste curl https://lmsmcp.slxd.app a partir do servidor e reveja as definições de proxy no Moodle.
O site não pode ser ligado
«URL não permitido» — o URL tem de ser HTTPS público com certificado válido. localhost, as gamas privadas e os anfitriões acessíveis apenas por VPN são recusados por desenho. Um site de pré-produção serve, desde que seja acessível publicamente.
Erros de certificado — um certificado autoassinado ou expirado não passa a validação. Corrija o certificado; não há como contornar.
Sem lugares de ligação — o seu plano limita quantos sites Moodle uma organização pode ligar; a página de ligações diz quantos restam. Elimine uma ligação que já não use ou mude de plano em Organização → Faturação.
O assistente diz que não tem ferramentas
- O cliente não recarregou a configuração MCP. Reinicie-o.
- O URL está errado: tem de ser o URL do conector dessa ligação — o subdomínio da sua organização, depois /mcp/lmsmcp/ e o slug da ligação. Copie-o da página da ligação em vez de o escrever.
- Com chave Bearer: confirme que o cabeçalho é exatamente Authorization: Bearer mcpk_… e que a chave não está suspensa, revogada nem expirada.
- Com OAuth: remova o conector e volte a autorizar.
O assistente responde sobre o Moodle errado, ou é recusado
Cada chave pertence a uma ligação e só funciona no URL do conector dessa ligação. Usar a chave de um Moodle no URL de outro é rejeitado. Confirme, na página da ligação, que a chave que apresenta está listada aí.
A ligação aparece como «Sem plugin» ou «Sem resposta»
Verificar agora, na página da ligação, pergunta em direto ao seu Moodle:
- Sem plugin — o Moodle respondeu, mas o plugin do conector não está lá instalado. Transfira-o com Transferir o plugin (.zip) e instale-o.
- Sem resposta — o Moodle não respondeu: o site está em baixo, o URL mudou, ou o token da chave usada na verificação já não é válido no Moodle.
- Sem chave ativa — a verificação precisa de um token, por isso crie primeiro uma chave para essa ligação.
O assistente não vê nada no Moodle
A chave funciona, mas o utilizador do Moodle subjacente não tem acesso ao que está a perguntar. Os papéis são o limite exterior — a chave de um estudante não consegue listar os participantes de um curso. Verifique para que utilizador a chave foi emitida e se está limitada a leitura, a ferramentas específicas ou a cursos específicos. Veja chaves e permissões.
«Access control exception» ao criar ou editar
O papel de uma chave é verificado uma vez, ao nível do site; o Moodle verifica as permissões por curso. Uma chave de professor com permissão de edição tem a ferramenta permitida, mas o Moodle recusa-a num curso onde esse utilizador não é professor com edição. Verifique se o utilizador para quem a chave foi emitida:
- está inscrito nesse curso com um papel que conceda a capacidade moodle/course:manageactivities (criar e editar atividades);
- consegue ver o curso, caso esteja oculto.
Inscrevê-lo no curso, ou dar-lhe um papel com essa capacidade, resolve o erro. Veja chaves e permissões.
As chamadas começaram a falhar depois de funcionarem
- A chave foi suspensa ou revogada, no painel ou a partir do plugin.
- As credenciais da ligação foram rodadas e o plugin não foi atualizado.
- O utilizador do Moodle perdeu o papel de que a chave depende, ou foi eliminado.
- O token foi apagado no Moodle em Administração do site → Servidor → Serviços web → Gerir tokens.
A página da ligação mostra a utilização e os erros por chave e por ferramenta, e Organização → Moodle → Utilização mostra a organização inteira; entre as duas costuma localizar-se em segundos.
Um ficheiro não carrega
O URL tem de devolver o ficheiro, não uma página à volta dele. Teste com curl -IL url a partir de fora da sua rede. O Google Drive, a Dropbox e o GitHub exigem cada um uma forma de URL específica — veja carregar ficheiros. Se a ferramenta nem sequer aparece, o seu plugin é demasiado antigo; atualize-o.
O chat não aparece ou recusa responder
- Não há nenhuma chave MCP escolhida como identidade do chat de IA em Organização → Moodle. O chat responde sobre a ligação da chave escolhida.
- O saldo de créditos não cobre a mensagem — carregue em Organização → Créditos.
- Atingiu o limite de 10 mensagens por minuto. Espere um momento.
A organização está bloqueada
O período experimental terminou ou um pagamento falhou. Subscreva ou corrija o método de pagamento em Organização → Faturação. Nada é eliminado enquanto está bloqueada.
Continua sem resolver
Anote o erro exato, os 4 últimos carateres da chave (nunca a chave inteira) e a hora a que aconteceu, e abra um problema em github.com/studiolxd/moodle-local_mcpconnector/issues.