Configurar o cliente

Para a maioria das pessoas, a melhor forma de usar o LMS MCP é ligá-lo ao ChatGPT ou ao Claude: uma configuração única, de dois minutos, e sem quaisquer chaves. As ferramentas de linha de comandos e os editores vêm a seguir, para quem precise delas.

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

Antes de começar: o URL do conector

Cada cliente liga-se ao URL do conector de uma ligação Moodle:

https://<a-sua-organizacao>.slxd.app/mcp/lmsmcp/<ligacao>

Não precisa de o construir à mão: o painel mostra-o com um botão de copiar na página da ligação, em Organização → Moodle, tanto logo a seguir a criar a ligação como em qualquer momento posterior. Se o seu administrador o provisionou a partir do plugin, o URL também lhe chega por email junto com a chave.

Se a sua organização tem vários sites Moodle, configure um cliente por ligação — é o URL que escolhe o site.

ChatGPT

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

  1. Abra as definições do ChatGPT e vá à secção connectors.
  2. Nas definições avançadas, ative o modo de programador se ainda não estiver — é o que permite adicionar conectores MCP personalizados.
  3. Crie um conector novo e cole o URL do conector da ligação.
  4. Quando abrir a janela do navegador, escolha Iniciar sessão com o seu Moodle, autentique-se com a sua própria conta Moodle e aprove.
  5. Numa conversa, ative o conector no menu de ferramentas e pergunte algo sobre o seu Moodle.

Os conectores personalizados exigem um plano pago do ChatGPT, e os nomes exatos dos menus podem variar ligeiramente entre versões.

Claude (claude.ai e Claude Desktop)

Os mesmos passos servem para o Claude no navegador (claude.ai) e para a aplicação de secretária, ambos com Iniciar sessão com o seu Moodle:

  1. Abra as definições do Claude e vá a Connectors.
  2. Escolha Adicionar conector personalizado e cole o URL do conector da ligação.
  3. Ao ligar abre-se uma janela do navegador: escolha Iniciar sessão com o seu Moodle, autentique-se no seu Moodle e aprove.
  4. Numa conversa, verifique que o conector está ativo no menu de ferramentas e pergunte algo sobre o seu Moodle.

Os conectores personalizados exigem um plano pago do Claude. O conector fica preso à sua identidade no Moodle: para ligar como outra pessoa, remova o conector e volte a autorizar.

Claude Code

Com uma chave MCP num cabeçalho Bearer:

claude mcp add --transport http moodle \
  https://<a-sua-organizacao>.slxd.app/mcp/lmsmcp/<ligacao> \
  --header "Authorization: Bearer mcpk_..."

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

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>.slxd.app/mcp/lmsmcp/<ligacao>",
      "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>.slxd.app/mcp/lmsmcp/<ligacao>",
      "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>.slxd.app/mcp/lmsmcp/<ligacao> \
  --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 automatizar, emita uma chave dedicada: só de leitura, limitada às ferramentas necessárias e com prazo de validade. Veja chaves e permissões.

Guarde a chave no seu cofre de segredos, nunca no repositório. Se uma chave fugir, revogue-a no painel; a chamada seguinte será 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 configuração MCP: reinicie o cliente ou desligue e volte a ligar o conector. Outros sintomas estão na resolução de problemas.

Configurar o cliente