--- title: "Herramientas" description: "Las herramientas que puede usar un agente para crear, modificar y publicar un sitio, y los permisos que necesita cada una." canonical: "https://atelier201.com/docs/es/mcp/standard-tools" updated: "2026-11-06" --- # Herramientas La [cobertura de operaciones generada](/docs/api/surfaces) 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 1. `get_account` y, después, `list_sites` para obtener un `site_id`, o `create_site`. 2. `edit_text` para cualquier texto visible, `set_field` para un campo que conozcas, `save_entry` y `save_entries` para las entradas, `save_singleton theme` para el aspecto. Usa `read_file` y `edit_files` (o `bash` y, después, `commit_workspace`) solo para modificar código. 3. Cada operación de guardado inicia una compilación y devuelve `build`: `get_build` con ese id espera (50 s de forma predeterminada) y responde cuando el estado es `ready` o `failed`. Con `preview: true`, una compilación lista incluye un enlace para abrirla; si no hay navegador, `read_page` permite leer las páginas. `build_site` sirve para compilar una revisión concreta o volver a intentarlo. 4. `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, usa `share_preview` y envíale el enlace. 5. `review_publish` y, 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](/docs/api/overview) o la [CLI](/docs/cli/commands); 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.