Ajustes¶
Administración del sitio → Extensiones → Plugins locales → Servidor MCP. La página muestra arriba la URL del endpoint.
| Ajuste | Nombre | Por defecto | Qué hace |
|---|---|---|---|
| Activar el servidor MCP | local_mcpserver/enabled |
Sí | Si está desactivado, el endpoint rechaza todas las peticiones. |
| Permitir herramientas de escritura | local_mcpserver/allowwrite |
No | Activa las tools que crean y cambian cursos. Consulta Activar la escritura. |
| Peticiones por usuario y minuto | local_mcpserver/ratelimit |
60 | 0 desactiva el límite. Consulta Límite de peticiones. |
| Vida del token de acceso (segundos) | local_mcpserver/accesstokenlifetime |
3600 | Se ajusta entre 60 y 86400. |
| Vida del token de refresco (segundos) | local_mcpserver/refreshtokenlifetime |
2592000 (30 días) | Se ajusta entre 1 hora y 365 días. |
| Vida del código de autorización (segundos) | local_mcpserver/codelifetime |
300 | Se ajusta entre 30 y 600. |
| Aceptar tokens de servicio web de Moodle | local_mcpserver/allowwstoken |
No | Acepta un wstoken de Moodle como Authorization: Bearer. |
| Permitir el registro dinámico de clientes | local_mcpserver/enabledcr |
Sí | Los clientes MCP pueden registrarse solos (RFC 7591). |
| Permitir tokens de acceso personal | local_mcpserver/allowpersonal |
Sí | Cada usuario puede crear un token de larga duración desde Preferencias. Se muestra una sola vez y solo se guarda su hash. |
| Caducidad máxima del token personal (días) | local_mcpserver/patmaxdays |
365 | El usuario puede elegir 30, 90 o 365 días; las opciones por encima de este número se ocultan. Se mantiene entre 30 y 365. |
| Permitir documentos de metadatos de client id | local_mcpserver/allowcimd |
Sí | Un cliente puede identificarse con una URL HTTPS de metadatos. Se rechazan direcciones privadas y link-local. |
| Orígenes adicionales permitidos | local_mcpserver/extraorigins |
Vacío | Un Origin de navegador por línea, por ejemplo https://cursor.com. |
Tools¶
Bajo el encabezado Herramientas hay una casilla por tool, 63 en total (local_mcpserver/tool_<nombre>, por ejemplo
local_mcpserver/tool_delete_section). Todas vienen activadas. Una tool desactivada no aparece en tools/list
y no se puede llamar. Todas las tools salvo las 26 con alcance read y search_users, es decir, las 26 write y las otras 10 admin, necesitan además Permitir herramientas de escritura: si está desactivado no aparecen aunque su casilla esté marcada.
Interruptores añadidos de la 0.8.3 a la 0.8.6, todos activados por defecto: tool_get_activity_settings, tool_list_conversations, tool_get_conversation_messages (lectura), tool_update_course, tool_set_course_image, tool_set_course_completion, tool_set_availability, tool_create_forum_discussion, tool_reply_forum_post, tool_send_private_message, tool_reply_conversation (escritura) y tool_set_site_policy_handler, tool_create_policy, tool_update_policy, tool_list_policies, tool_get_policy_acceptances (administración).
Comprobación de Origin¶
La URL del sitio siempre está permitida. Las peticiones sin cabecera Origin (clientes de escritorio y de servidor)
se aceptan. Un Origin presente pero desconocido recibe HTTP 403.