mas

docs/mcp-tools-reference.md

@@ -11,7 +11,7 @@
 | `acai-glob` | Archivos | Busca rutas de archivos por patrón |
 | `acai-grep` | Archivos | Busca texto en archivos del proyecto |
 | `acai-line-replace` | Archivos | Reemplaza un bloque concreto en un archivo existente |
-| `acai-write` | Archivos | Crea o reescribe un archivo completo. Antes de usarlo, lee la doc correspondiente según el tipo de archivo (`module-creation-guide`, `css-js-conventions`, `hooks-and-api`) |
+| `acai-write` | Archivos | Crea o reescribe un archivo completo. Antes de usarlo, lee la doc correspondiente según el tipo de archivo (`module-creation-guide`, `builder-fields`, `css-js-conventions`, `hooks-and-api`) |
 | `acai-delete` | Archivos | Borra un archivo del proyecto |
 | `list_page_modules` | Registros | Lista módulos de una página |
 | `add_module_to_record` | Registros | Añade módulo a una página |
@@ -86,13 +86,13 @@ Reglas:
    - `tableName`: `"builder_custom"` (siempre sin cms_)
    - `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/...`)
+   - `imageUrl`: usa la URL recomendada por la tool que generó/subió la imagen. En Forge, si `generate_image` devuelve `uploadUrl` o `fullUrl`, priorízala frente a `dockerUrl`
 
 ### Generar imagen con IA
 
 1. `generate_image` con prompt descriptivo + style (photographic, digital-art, minimalist...)
-2. La imagen se guarda en `cms/uploads/generated/` y devuelve `dockerUrl`
-3. Usar esa `dockerUrl` con `upload_record_image` para asignarla a un módulo
+2. La imagen se guarda en `cms/uploads/generated/` y devuelve una URL local de preview (`dockerUrl`) y, cuando aplica, una URL recomendada para subida (`uploadUrl` / `fullUrl`)
+3. Para `upload_record_image`, usa la URL recomendada por la tool. En Forge, prioriza `uploadUrl` o `fullUrl` si están presentes
 
 ### Gestionar registros de una tabla