Activar la escritura

Las tools de escritura vienen desactivadas. Una instalación nueva pone allowwrite a 0, y el código lo trata como desactivado si el ajuste nunca se ha guardado.

Activarla

1. Abre Administración del sitio → Extensiones → Plugins locales → Servidor MCP.
2. Marca Permitir herramientas de escritura (local_mcpserver/allowwrite).
3. Guarda.

Mientras está desactivada, las tools de escritura no aparecen en tools/list. Si un cliente llama a una igualmente, recibe «Las herramientas de escritura están desactivadas por el administrador.», incluso con un token de solo lectura.

Qué más necesita una llamada de escritura

• Un token con el alcance write (o admin).
• La capability local/mcpserver:write. Por defecto: profesores con edición y gestores, en los contextos donde tienen ese rol.
• El permiso normal de Moodle para esa acción, el mismo que comprueba la interfaz. Consulta la referencia de tools.
• La propia tool activada en la sección Herramientas de los ajustes.

Las tools con alcance admin cuentan aquí como de escritura, incluidas list_policies y get_policy_acceptances, que solo leen. La excepción es search_users, que funciona con la escritura desactivada. get_conversation_messages es de lectura, pero su opción markAsRead: true necesita el alcance write y la escritura activada.

Borrados

delete_activity y delete_section usan dryRun: true por defecto. Una simulación devuelve el registro que se borraría y no cambia nada. El borrado solo ocurre si la llamada envía a la vez dryRun: false y confirm: true.