Herramientas
Las herramientas que puede usar un agente para crear, modificar y publicar un sitio, y los permisos que necesita cada una.
La cobertura de operaciones generada relaciona REST, CLI y MCP.
Para descubrir las operaciones, consulta atelier201://operations y, después,
atelier201://operations/{operation_id} para ver el contrato completo de una operación. El documento completo
es atelier201://openapi. Los argumentos de herramientas desconocidos se rechazan en lugar de
ignorarse silenciosamente.
get_workspace lee los archivos sin confirmar y el diff sin ejecutar bash. Usa
el mismo permiso sites:write que el endpoint REST del espacio de trabajo y no modifica
ni el borrador ni el sitio publicado.
Las herramientas están diseñadas para el trabajo que realiza un agente, no para los endpoints. Sus descripciones se redactan a mano, porque el modelo las interpreta como toda su interfaz: cada una indica qué modifica, si los visitantes pueden verlo y qué herramienta debe usarse a continuación.
Solo se ofrecen las herramientas permitidas por los permisos de tu credencial, así que una conexión
sin sites:publish nunca verá publish_site. Hay una herramienta que consume créditos:
generate_media, y solo está disponible con el permiso media:generate.
Orden de trabajo
get_accounty, después,list_sitespara obtener unsite_id, ocreate_site.edit_textpara cualquier texto visible,set_fieldpara un campo que conozcas,save_entryysave_entriespara las entradas,save_singleton themepara el aspecto. Usaread_fileyedit_files(obashy, después,commit_workspace) solo para modificar código.- Cada operación de guardado inicia una compilación y devuelve
build:get_buildcon ese id espera (50 s de forma predeterminada) y responde cuando el estado esreadyofailed. Conpreview: true, una compilación lista incluye un enlace para abrirla; si no hay navegador,read_pagepermite leer las páginas.build_sitesirve para compilar una revisión concreta o volver a intentarlo. show_site: en un host que muestra aplicaciones (Claude, ChatGPT), el propietario ve el borrador en directo en una tarjeta, con el botón Publish. En otros casos, usashare_previewy envíale el enlace.review_publishy, solo después de que el propietario lo apruebe,publish_site.
Sitios y contenido
| Herramienta | Permiso | Función |
|---|---|---|
list_sites, get_site | sites:read | Consultar los sitios del espacio de trabajo. |
create_site | sites:write | Crear un sitio a partir de la plantilla inicial e iniciar su primera compilación. |
rename_site | sites:write | Cambiar el nombre que se muestra en Atelier201. |
get_content_model | sites:read | Consultar las colecciones y los elementos singleton con sus esquemas JSON. |
list_entries, get_entry | sites:read | Consultar las entradas de una colección. |
save_entry | sites:write | Guardar una entrada con validación. Las entradas nuevas se crean como borradores. |
delete_entry | sites:write | Eliminar una entrada del borrador. |
get_singleton | sites:read | Consultar los datos de la empresa, el tema o la navegación. |
save_singleton | sites:write | Sustituir un singleton completo, con validación. |
set_field | sites:write | Cambiar un campo mediante su dirección data-atelier201-field. |
apply_site_plan | sites:write | Crear una primera versión o realizar una remodelación amplia en una sola llamada: datos de la empresa, tema, navegación, entradas e imágenes, todo validado conjuntamente. |
place_image | sites:write | Añadir una imagen a un campo de imagen (con una descripción de archivo de stock, un resultado elegido o un archivo del sitio) e incluir su texto alternativo, todo en una sola llamada. |
edit_text | sites:write | Cambiar un texto donde aparezca (en el contenido o el código), indicando cómo se lee en la página. |
Archivos, historial y conjuntos de cambios
| Herramienta | Permiso | Función |
|---|---|---|
list_files, read_file, read_files, search_files | sites:read | Consultar el proyecto. read_file devuelve el hash que debe enviarse como expected_hash; read_files permite leer hasta 30 archivos en una sola llamada. |
edit_files | sites:write | Aplicar operaciones de escritura, eliminación y movimiento como una sola entrada del historial. |
get_workspace | sites:write | Leer los archivos sin confirmar y su diff sin ejecutar ningún comando. |
open_changeset, stage_changes, commit_changeset, abandon_changeset | sites:write | Crear una entrada del historial a partir de varias llamadas. |
list_history, compare_revisions | sites:read | Consultar el historial. |
restore_revision | sites:write | Igualar el borrador a una revisión anterior mediante una nueva entrada. |
Contenido multimedia
| Herramienta | Permiso | Función |
|---|---|---|
list_media | sites:read | Consultar los archivos subidos y el espacio de almacenamiento restante. |
upload_media | sites:write | Subir un archivo codificado en base64, de hasta 5 MB mediante MCP. |
delete_media | sites:write | Eliminar un archivo de las próximas compilaciones. |
search_stock_media | sites:read | Buscar fotos y vídeos de archivo gratuitos (Pixabay). |
import_stock_media | sites:write | Copiar un resultado al contenido multimedia del sitio e incluir su crédito. |
list_media_models | sites:read | Consultar los modelos de IA para imágenes y vídeos y sus precios en créditos. |
generate_media | media:generate | Crear una imagen o un vídeo con IA. Consume créditos: primero estimate_only y, después, max_credits. |
get_media_generation | sites:read | Consultar el estado de una generación y acceder al archivo cuando esté listo. |
Compilación y vista previa
| Herramienta | Permiso | Función |
|---|---|---|
build_site | sites:write | Compilar el borrador. Devuelve inmediatamente una compilación en estado queued. |
list_builds, get_build, get_build_log | sites:read | Consultar las compilaciones y el registro de una que haya fallado. get_build acepta wait (responde cuando termina la compilación) y preview (un enlace a una compilación lista; requiere sites:write). |
read_page | sites:read | Leer una página de una compilación tal como la vería un visitante, con los problemas que detectaría una revisión rápida; para agentes sin navegador. |
show_site | sites:read | Abrir la tarjeta del sitio, una aplicación MCP: muestra el borrador en directo (se recarga automáticamente después de cada compilación), una imagen de la página de inicio si el host no puede mostrarla en un marco, el botón Publish (Go live, Publish changes) y Comment, que envía a la conversación el comentario «change this» sobre un elemento. Sin sites:write, la tarjeta solo muestra la imagen. |
share_preview | sites:write | Crear un enlace privado a una compilación, válido 7 días de forma predeterminada. |
list_previews | sites:read | Consultar los enlaces de vista previa. |
revoke_preview | sites:write | Desactivar un enlace de vista previa. |
Publicación y dominios
Estas acciones cambian lo que ven los visitantes. Pregunta antes al propietario.
| Herramienta | Permiso | Función |
|---|---|---|
review_publish | sites:read | Mostrar qué se publicaría, qué lo impide y el valor de expected_generation. |
publish_site | sites:publish | Publicar una compilación. |
rollback_site | sites:publish | Volver a servir una publicación anterior. |
unpublish_site | sites:publish | Dejar el sitio fuera de línea. |
delete_site | sites:publish | Eliminar un sitio de forma permanente. confirm_name debe ser su nombre o slug; para un sitio publicado, se necesita delete_published: true. Esta acción no se puede deshacer. |
list_publications | sites:read | Consultar el historial de publicaciones. |
get_site_analytics | sites:read | Consultar las cifras de visitantes de un sitio durante un periodo. |
list_domains | sites:read | Consultar los dominios y los registros DNS que aún necesita cada uno. |
add_domain, check_domain | domains:write | Conectar un dominio y comprobar sus registros DNS. |
remove_domain | domains:write | Desconectar un dominio. |
set_main_domain | domains:write | Redirigir las demás direcciones a una y volver a compilar. |
Para publicar, revertir, dejar un sitio fuera de línea o cambiar dominios también hace falta ser administrador del espacio de trabajo. La importación y exportación de proyectos binarios se realiza mediante la API REST o la CLI; los agentes MCP leen y modifican archivos individuales.
Cuenta
| Herramienta | Permiso | Función |
|---|---|---|
get_account | account:read | Consultar el espacio de trabajo, el plan y los permisos de esta credencial. |
get_credit_balance | account:read | Consultar el saldo de créditos y cada concesión. |
get_usage | usage:read | Consultar el uso de créditos a lo largo del tiempo. |
list_skills | none | Consultar las guías: cómo crear un sitio, editar contenido, cambiar el diseño, importar datos, corregir una compilación y publicar. Úsalo antes de compilar. |
get_skill | none | Leer una guía completa en Markdown. |
send_feedback | none | Informar de un problema o una carencia de la API, la CLI o el servidor MCP. |
Escritura segura
Envía el hash de read_file como expected_hash cada vez que modifiques un archivo. Si
alguien lo ha cambiado entretanto, se rechaza todo el cambio con un error conflict y
no se escribe nada. Vuelve a leer los archivos, aplica los cambios sobre la versión actual y reinténtalo.
publish_site recibe el valor expected_generation de review_publish y se
rechaza si el sitio se ha publicado desde entonces.