Update builder-fields.md

docs/builder-fields.md

@@ -424,3 +424,34 @@ Manejo automático de validación, almacenamiento en BD y envío de emails.
 5. **c-for tabla:** El nombre de tabla va sin prefijo `cms_`
 6. **Enlace:** Ya incluye barras, no añadir extras
 7. **Checkbox:** Valores `1` o `0`, no `true`/`false`
+
+---
+
+## MCP Tools: Config Vars e Imágenes de Módulos
+
+### Leer variables de un módulo
+Antes de modificar cualquier módulo, usar `get_module_config_vars` para conocer el estado actual:
+- **tableName**: tabla del registro padre (ej: `apartados`), SIN prefijo `cms_`
+- **recordNum**: campo `num` del registro padre (ej: `2`)
+- **sectionId**: el `section_id` de la instancia del módulo (ej: `6c6d8`)
+
+### Escribir variables de un módulo
+Usar `set_module_config_vars` con los mismos tableName, recordNum y sectionId. La respuesta incluye `configVars` con el `recordNum` del registro `builder_custom` creado/actualizado.
+
+### Subir imágenes a un módulo
+El nombre del campo de imagen viene de `builder.json` → `vars.NOMBRE.relations.builder_custom` (ej: `"image1"`). NO es el nombre de la variable (ej: NO `"imagenes"`).
+
+**Flujo correcto:**
+1. `get_module_config_vars` → obtener el `recordNum` en builder_custom de la variable de imagen
+2. `upload_record_image` con:
+   - `tableName`: `"builder_custom"` (siempre, sin prefijo cms_)
+   - `recordId`: el `recordNum` del paso 1 (ej: `"778"`)
+   - `fieldName`: el campo de relations del builder.json (ej: `"image1"`)
+   - `imageUrl`: URL completa accesible desde Docker
+3. `reorder_record_uploads` si es necesario — pasar array de upload IDs en el orden deseado
+4. `list_record_uploads` para verificar
+
+**Errores comunes a evitar:**
+- NO usar el sectionId como recordId — usar el `num` de builder_custom
+- NO usar el nombre de la variable como fieldName — usar el campo de relations del builder.json (ej: `image1`, no `imagenes`)
+- NO poner prefijo `cms_` en tableName