Agentes de IA (MCP)

Permita que un agente de programación con IA como Claude Code o Codex redacte contenido y proponga cambios en el contrato, mientras las personas conservan el control de la publicación.

Esta página fue traducida del inglés. Si hay alguna diferencia, prevalece la versión en inglés. Leer en inglés

Atlas expone un endpoint de Model Context Protocol para que un agente de programación con IA que trabaja en el repositorio de su sitio web pueda encargarse de las partes repetitivas de una migración: modelar el contrato del sitio, subir imágenes, crear entradas y páginas y redactar traducciones.

Qué puede y qué no puede hacer un agente

Los agentes pueden	Los agentes nunca pueden
Leer el contrato; validar y proponer cambios	Aprobar o activar un contrato
Crear y editar borradores de páginas, entradas y globales	Publicar, en ningún entorno
Redactar traducciones	Revertir o eliminar
Subir medios	Tocar Producción de ninguna manera
Crear y editar borradores del chatbot	Ejecutar comandos de shell, SQL, acceso a archivos u obtener URL
	Desplegar nada

Una persona revisa cada borrador en Studio y lo publica.

Conectar un agente

En Studio abra Integrations → Coding agents → New connection. Elija el entorno de Desarrollo y los permisos (grants) que necesita el agente:
- contract:read, contract:propose
- content:draft
- media:upload
- bots:draft
- plans:read (Read website plans: planos aprobados del asistente, paletas y tokens de diseño; novedad de esta versión)
Solo los administradores del sitio y de la organización pueden crear conexiones. Haga clic en Create connection.
Copie el token. Empieza por amc_ y se muestra una sola vez.

Añada el servidor a su agente. El endpoint usa Streamable HTTP:

{
  "mcpServers": {
    "atlas": {
      "type": "http",
      "url": "https://mcp.atlas.example/mcp",
      "headers": { "Authorization": "Bearer ${ATLAS_MCP_TOKEN}" }
    }
  }
}

Mantenga el token en una variable de entorno, nunca en un archivo incluido en el repositorio.

Pida al agente que llame a atlas.connection.get. Debería informar de su sitio y de su entorno de Desarrollo.

La sección Guides de Studio contiene instrucciones listas para cada paso de la migración, con los valores de su sitio ya rellenados.

Controles de seguridad

Las conexiones solo pueden crearse para entornos de Desarrollo y caducan en un máximo de 90 días.
Las conexiones creadas antes de que existiera plans:read deben volver a crearse para obtenerlo.
Cada llamada se comprueba contra la conexión activa, de modo que revocar una conexión surte efecto en la siguiente llamada.
Las llamadas tienen límite de frecuencia (120 por minuto de forma predeterminada) y toda escritura necesita una clave de idempotencia.
Las acciones de los agentes se registran en el registro de auditoría.

Herramientas

Grant	Herramientas
(siempre)	`atlas.connection.get`
`contract:read`	`atlas.contract.get`, `atlas.contract.list`, `atlas.contract.proposal.get`
`contract:propose`	`atlas.contract.validate`, `atlas.contract.propose`, `atlas.contract.proposal.withdraw`
`content:draft`	`atlas.pages.list`, `.get`, `.createFromType`, `.sections.update`; `atlas.entries.list`, `.get`, `.upsertDraft`; `atlas.globals.list`, `.get`, `.updateDraft`; `atlas.translations.get`, `.updateDraft`
`media:upload`	`atlas.media.list`, `atlas.media.asset.get`, `atlas.media.uploadSlot.create`
`bots:draft`	`atlas.bots.list`, `.get`, `.create`, `.updateDraft`
`plans:read`	`atlas.helper.projects.list`, `atlas.helper.blueprint.get`, `atlas.brand.palettes.get`, `atlas.brand.designTokens.get` (solo lectura)

No hay herramientas de agente para fuentes, la biblioteca, animaciones ni análisis de diseño, y ninguna herramienta puede publicar ni aprobar nada.