Configurar el cliente

Para la mayoría de la gente, la mejor forma de usar LMS MCP es conectarlo a ChatGPT o Claude: es una configuración de una vez, de un par de minutos, y sin claves de por medio. Las herramientas de línea de comandos y los editores vienen después, para quien los necesite.

Qué método de autenticación admite cada cliente se explica en conectar un asistente.

Antes de empezar: la URL del conector

Cada cliente se conecta a la URL de conector de una conexión Moodle:

https://<tu-organizacion>.slxd.app/mcp/lmsmcp/<conexion>

No hace falta construirla a mano: el panel la muestra con un botón de copiar en la página de la conexión, en Organización → Moodle, tanto justo después de crear la conexión como en cualquier momento posterior. Si tu administrador te provisionó desde el plugin, la URL también te llega por correo junto con tu clave.

Si tu organización tiene varios sitios Moodle, configura un cliente por conexión — la URL es lo que elige el sitio.

ChatGPT

ChatGPT conecta con Iniciar sesión con tu Moodle: no hay clave que copiar.

  1. Abre los ajustes de ChatGPT y ve a la sección de conectores.
  2. En los ajustes avanzados, activa el modo desarrollador si no lo está — es lo que permite añadir conectores MCP personalizados.
  3. Crea un conector nuevo y pega la URL de conector de la conexión.
  4. Cuando se abra la ventana del navegador, elige Iniciar sesión con tu Moodle, entra con tu propia cuenta de Moodle y aprueba.
  5. En una conversación, activa el conector desde el menú de herramientas y pregunta algo sobre tu Moodle.

Los conectores personalizados requieren un plan de pago de ChatGPT, y los nombres exactos de los menús pueden variar un poco entre versiones.

Claude (claude.ai y Claude Desktop)

Los mismos pasos valen para Claude en el navegador (claude.ai) y para la aplicación de escritorio, ambos con Iniciar sesión con tu Moodle:

  1. Abre los ajustes de Claude y ve a Conectores.
  2. Elige Añadir conector personalizado y pega la URL de conector de la conexión.
  3. Al conectar se abre una ventana del navegador: elige Iniciar sesión con tu Moodle, entra en tu Moodle y aprueba.
  4. En una conversación, comprueba que el conector está activado en el menú de herramientas y pregunta algo sobre tu Moodle.

Los conectores personalizados requieren un plan de pago de Claude. El conector queda ligado a tu identidad de Moodle: para conectar como otra persona, elimina el conector y vuelve a autorizar.

Claude Code

Con una clave MCP en una cabecera Bearer:

claude mcp add --transport http moodle \
  https://<tu-organizacion>.slxd.app/mcp/lmsmcp/<conexion> \
  --header "Authorization: Bearer mcpk_..."

Si prefieres no manejar claves, añade el servidor sin la cabecera y autentícate por OAuth cuando Claude Code te lo pida — es el mismo flujo de navegador Iniciar sesión con tu Moodle.

Cursor

En el fichero de configuración MCP de Cursor — .cursor/mcp.json dentro del proyecto, o el global de tu usuario:

{
  "mcpServers": {
    "moodle": {
      "url": "https://<tu-organizacion>.slxd.app/mcp/lmsmcp/<conexion>",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

VS Code

VS Code usa su propio formato, en .vscode/mcp.json dentro del proyecto:

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<tu-organizacion>.slxd.app/mcp/lmsmcp/<conexion>",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

Clientes que solo hablan stdio

Haz de puente con el paquete estándar mcp-remote:

npx mcp-remote https://<tu-organizacion>.slxd.app/mcp/lmsmcp/<conexion> \
  --header "Authorization: Bearer mcpk_..."

Scripts e integración continua

Vale cualquier cliente HTTP: envía la clave en una cabecera Bearer sobre el transporte Streamable HTTP. Para automatizar, emite una clave dedicada: de solo lectura, acotada a las herramientas que necesita y con caducidad. Consulta claves y permisos.

Guarda la clave en tu gestor de secretos, nunca en el repositorio. Si una clave se filtra, revócala en el panel; su siguiente llamada será rechazada.

Comprobar que funciona

Pídele al asistente algo que necesite tu Moodle, como «¿en qué cursos estoy matriculado?». Si dice que no tiene herramientas, casi siempre es porque no ha recargado su configuración MCP: reinicia el cliente o apaga y enciende el conector. Otros síntomas se tratan en la resolución de problemas.

Configurar el cliente