Resolução de problemas
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. Se renovou as credenciais, o plugin ainda tem o par antigo: cole o novo. Se só copiou um dos valores antes de sair da página, renove para obter um par novo.
«O URL não corresponde» — o site que está a chamar não corresponde ao URL registado no painel. É comum quando o Moodle está atrás de um proxy e o $CFG-wwwroot difere do nome de anfitrião público, ou depois de uma mudança de domínio. Atualize o URL em Organização → Moodle e valide de novo.
O plugin não chega ao painel — o seu Moodle precisa de saída HTTPS. Verifique curl https://moodlemcp.com a partir do servidor e as definições de proxy do Moodle.
O site não pode ser ligado
«URL não permitido» — o URL tem de ser público, com HTTPS e certificado válido. localhost, os intervalos privados e os anfitriões só acessíveis por VPN são recusados por desenho. Um site de testes serve se for publicamente acessível.
Erros de certificado — um certificado autoassinado ou expirado não passa a validação. Corrija o certificado; não há forma de contornar.
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 subdomínio da sua organização e terminar em /mcp.
- 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 conetor e volte a autorizar.
O assistente não vê nada no Moodle
A chave funciona, mas o utilizador do Moodle associado não tem acesso ao que está a pedir. Os papéis são o limite exterior: uma chave de aluno não consegue listar os participantes de um curso. Verifique para que utilizador a chave foi emitida e se está restringida a apenas leitura, a ferramentas concretas ou a cursos concretos. Veja chaves e permissões.
As chamadas falham depois de terem funcionado
- A chave foi suspensa ou revogada, no painel ou no plugin.
- As credenciais foram renovadas 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.
Organização → Moodle → Utilização mostra os erros por chave e por ferramenta, o que normalmente localiza o problema em segundos.
Um ficheiro não é enviado
O URL tem de devolver o ficheiro, não uma página que o envolve. Teste com curl -IL url de fora da sua rede. O Google Drive, a Dropbox e o GitHub precisam cada um de uma forma concreta de URL: veja enviar ficheiros. Se a ferramenta não aparecer, o seu plugin é demasiado antigo: atualize-o.
O chat não aparece ou não responde
- Não há nenhuma chave MCP selecionada como identidade do chat em Organização → Moodle.
- 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. Enquanto está bloqueada nada é eliminado.
Continua sem resolver
Anote o erro exato, os 4 últimos caracteres da chave (nunca a chave inteira) e a hora, e abra um problema em github.com/studiolxd/moodle-local_mcpconnector/issues.