Inicio rápido¶

Todos los clientes usan la misma URL:

https://moodle.example.edu/local/mcp/server.php

Cursor (o cualquier cliente con discovery OAuth)¶

Añade el servidor a la configuración MCP del proyecto o del usuario:

{
  "mcpServers": {
    "moodle": {
      "url": "https://moodle.example.edu/local/mcp/server.php"
    }
  }
}

El cliente recibe un 401 cuya cabecera WWW-Authenticate lleva una URL resource_metadata. A partir de ahí lee los metadatos del servidor de autorización y abre la página de consentimiento de Moodle. Entras con tu cuenta normal de Moodle y apruebas read, write o admin.

Con un token emitido de antemano¶

Si has emitido un token con la CLI, envíalo como cabecera bearer:

{
  "mcpServers": {
    "moodle": {
      "url": "https://moodle.example.edu/local/mcp/server.php",
      "headers": {
        "Authorization": "Bearer TU_TOKEN_DE_ACCESO"
      }
    }
  }
}

MCP Inspector (CLI)¶

Listar las tools:

npx @modelcontextprotocol/inspector --cli \
  https://moodle.example.edu/local/mcp/server.php \
  --transport http \
  --header "Authorization: Bearer TU_TOKEN_DE_ACCESO" \
  --method tools/list

Llamar a site_info con la revisión actual del protocolo:

npx @modelcontextprotocol/inspector --cli \
  https://moodle.example.edu/local/mcp/server.php \
  --transport http --protocol-era modern \
  --header "Authorization: Bearer TU_TOKEN_DE_ACCESO" \
  --method tools/call --tool-name site_info

Versiones del protocolo¶

Con sesión: initialize, notifications/initialized, ping, tools/list, tools/call, cabecera Mcp-Session-Id opcional y DELETE para cerrar la sesión. Versiones 2025-03-26, 2025-06-18 y 2025-11-25.
Revisión sin estado 2026-07-28: server/discover, tools/list, tools/call, _meta por petición y las cabeceras MCP-Protocol-Version, Mcp-Method y Mcp-Name.

Consejo

Las tools de escritura no aparecen en tools/list hasta que un administrador activa la escritura.