From 3701e6066b6458e568fa60b537d396721d571453 Mon Sep 17 00:00:00 2001 From: Jordan Date: Sat, 28 Mar 2026 21:54:26 +0000 Subject: [PATCH] Update mcp-tools-reference.md --- docs/mcp-tools-reference.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/mcp-tools-reference.md b/docs/mcp-tools-reference.md index adcac3d..1b4c860 100644 --- a/docs/mcp-tools-reference.md +++ b/docs/mcp-tools-reference.md @@ -37,8 +37,11 @@ 1. `create_module` — Crea el directorio con index-base.tpl, style.css, script.js y compila 2. `add_module_to_record` — Añade el módulo a una página (tabla padre, ej: `apartados`) -3. `set_module_config_vars` — Rellena las variables con contenido (textos, colores, opciones). **OBLIGATORIO** — sin esto el módulo no muestra nada -4. Para imágenes: `generate_image` o `upload_record_image` usando el `recordNum` devuelto por set_module_config_vars +3. `set_module_config_vars` — Rellena las variables con contenido (textos, colores, opciones). **OBLIGATORIO** — sin esto el módulo no muestra nada. Devuelve: + - `configVars`: mapa de variables → recordNums + - `uploadFields`: mapa de variables upload → `{ fieldName, recordNum }` — **usa estos directamente** para subir imágenes sin necesidad de leer builder.json + - Para vars multi con uploads: `uploadFields["varName.subVarName"]` es un array con `[{ index, fieldName, recordNum }]` +4. Para imágenes: `generate_image` o `upload_record_image` usando el `recordNum` y `fieldName` del `uploadFields` devuelto en el paso 3 5. Verificar con `check_module` o recargando la página ### Editar un módulo existente @@ -50,6 +53,12 @@ ### Añadir/modificar imágenes de un módulo +**Tras `set_module_config_vars`** (método recomendado — sin pasos extra): +1. El response de `set_module_config_vars` incluye `uploadFields` con los `recordNum` y `fieldName` de cada variable upload +2. `upload_record_image` con `tableName: "builder_custom"`, `recordId` y `fieldName` del `uploadFields` +3. Para uploads dentro de vars multi: `uploadFields["records.imagen"]` devuelve array con `{ index, fieldName, recordNum }` por cada record + +**Sin haber llamado a `set_module_config_vars`**: 1. `get_module_config_vars` — Obtener el `recordNum` de builder_custom 2. Leer `builder.json` del módulo para encontrar el `fieldName` real (ej: `image1`, NO el nombre de la variable) 3. `upload_record_image` con: @@ -57,8 +66,6 @@ - `recordId`: el recordNum del paso 1 - `fieldName`: el campo de relations del builder.json (ej: `image1`) - `imageUrl`: URL accesible desde Docker (ej: `http://localhost/cms/uploads/...`) -4. `list_record_uploads` para verificar -5. `reorder_record_uploads` si necesitas cambiar el orden ### Generar imagen con IA