Configurar o cliente

Para a maioria das pessoas, a melhor forma de usar o MoodleMCP é ligá-lo ao ChatGPT ou ao Claude: configura-se uma vez, em poucos minutos, e sem mexer em nenhuma chave. As ferramentas de linha de comandos e os editores vêm depois, para quem precisar delas.

Que método de autenticação cada cliente suporta está explicado em ligar um assistente.

Antes de começar: o seu ponto de acesso

Todos os clientes ligam-se ao ponto de acesso MCP da sua organização:

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

Não precisa de o construir à mão: o painel mostra-o com um botão de copiar em Organização → Moodle, tanto ao criar a ligação como em qualquer momento depois. Se o seu administrador lhe atribuiu acesso a partir do plugin, o URL também chega no email junto com a sua chave.

ChatGPT

O ChatGPT liga-se com Iniciar sessão com o seu Moodle: não há nenhuma chave para copiar.

Abra as definições do ChatGPT e entre na secção de conetores.
Nas definições avançadas, ative o modo de programador se ainda não estiver ativo — é o que permite adicionar conetores MCP personalizados.
Crie um conetor novo e cole o URL do seu ponto de acesso.
Quando a janela do navegador abrir, escolha Iniciar sessão com o seu Moodle, entre com a sua conta do seu próprio Moodle e aprove.
Numa conversa, ative o conetor no menu de ferramentas e pergunte algo sobre o seu Moodle.

Os conetores personalizados exigem um plano pago do ChatGPT, e o nome exato dos menus pode variar ligeiramente entre versões.

Claude (claude.ai e Claude Desktop)

Serve tanto para o Claude no navegador (claude.ai) como para a aplicação de ambiente de trabalho, com os mesmos passos e também com Iniciar sessão com o seu Moodle:

Abra as definições do Claude e entre em Conetores.
Escolha Adicionar conetor personalizado e cole o URL do seu ponto de acesso.
Ao ligar abre-se uma janela do navegador: escolha Iniciar sessão com o seu Moodle, entre no seu Moodle e aprove.
Numa conversa, confirme que o conetor está ativo no menu de ferramentas e pergunte algo sobre o seu Moodle.

Os conetores personalizados exigem um plano pago do Claude. O conetor fica ligado à sua identidade do Moodle: para se ligar como outra pessoa, remova o conetor e volte a autorizar.

Claude Code

Com uma chave MCP num cabeçalho Bearer:

claude mcp add --transport http moodle https://<a-sua-organizacao>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

Se preferir não mexer em chaves, adicione o servidor sem o cabeçalho e autentique-se por OAuth quando o Claude Code o pedir — o fluxo é o mesmo Iniciar sessão com o seu Moodle do navegador.

Cursor

No ficheiro de configuração MCP do Cursor — .cursor/mcp.json dentro do projeto, ou o global do seu utilizador:

{
  "mcpServers": {
    "moodle": {
      "url": "https://<a-sua-organizacao>.moodlemcp.com/mcp",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

VS Code

O VS Code usa o seu próprio formato, em .vscode/mcp.json dentro do projeto:

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<a-sua-organizacao>.moodlemcp.com/mcp",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

Clientes que só falam stdio

Faça a ponte com o pacote padrão mcp-remote:

npx mcp-remote https://<a-sua-organizacao>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

Scripts e integração contínua

Serve qualquer cliente HTTP: envie a chave num cabeçalho Bearer sobre o transporte Streamable HTTP. Para automatizações, emita uma chave dedicada: apenas de leitura, limitada às ferramentas necessárias e com validade. Veja chaves e permissões.

Guarde a chave no seu gestor de segredos, nunca no repositório. Se uma chave fugir, revogue-a no painel: a chamada seguinte é recusada.

Confirmar que funciona

Peça ao assistente algo que precise do seu Moodle, como «em que cursos estou inscrito?». Se disser que não tem ferramentas, quase sempre é porque não recarregou a sua configuração MCP: reinicie o cliente ou desative e reative o conetor. Outros sintomas estão na resolução de problemas.