Configurar el cliente

Para la mayoría de la gente, la mejor forma de usar MoodleMCP es conectarlo a ChatGPT o a Claude: se configura una vez, en un par de minutos, y sin manejar ninguna clave. Las herramientas de línea de comandos y editores vienen después para quien las necesite.

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

Antes de empezar: tu endpoint

Todos los clientes se conectan al endpoint MCP de tu organización:

https://<tu-organizacion>.moodlemcp.com/mcp

No hace falta que lo construyas a mano: el panel lo muestra con un botón de copiar en Organización → Moodle, tanto al crear la conexión como en cualquier momento después. Si tu administrador te aprovisionó desde el plugin, la URL también llega en el correo junto a tu clave.

ChatGPT

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

Abre los ajustes de ChatGPT y entra en la sección de conectores.
En los ajustes avanzados, activa el modo desarrollador si aún no lo está — es lo que permite añadir conectores MCP personalizados.
Crea un conector nuevo y pega la URL de tu endpoint.
Cuando se abra la ventana del navegador, elige Iniciar sesión con tu Moodle, entra con tu cuenta de tu propio Moodle y aprueba.
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 el nombre exacto de los menús puede variar ligeramente entre versiones.

Claude (claude.ai y Claude Desktop)

Vale tanto para Claude en el navegador (claude.ai) como para la aplicación de escritorio, con los mismos pasos y también con Iniciar sesión con tu Moodle:

Abre los ajustes de Claude y entra en Conectores.
Elige Añadir conector personalizado y pega la URL de tu endpoint.
Al conectar se abrirá una ventana del navegador: elige Iniciar sesión con tu Moodle, entra en tu Moodle y aprueba.
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 vinculado a tu identidad de Moodle: para conectarte 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>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

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

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>.moodlemcp.com/mcp",
      "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>.moodlemcp.com/mcp",
      "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>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

Scripts e integración continua

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

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

Comprobar que funciona

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