Agenti IA (MCP)

Consenta a un agente IA di programmazione come Claude Code o Codex di scrivere bozze di contenuti e proporre modifiche al contratto, mentre le persone mantengono il controllo della pubblicazione.

Questa pagina è stata tradotta dall'inglese. In caso di differenze, fa fede la versione inglese. Leggi in inglese

Atlas espone un endpoint Model Context Protocol in modo che un agente IA di programmazione che lavora nel repository del Suo sito web possa svolgere le parti ripetitive di una migrazione: modellare il contratto del sito, caricare immagini, creare voci e pagine e preparare bozze di traduzioni.

Che cosa può e non può fare un agente

Gli agenti possono	Gli agenti non possono mai
Leggere il contratto; convalidare e proporre modifiche	Approvare o attivare un contratto
Creare e modificare bozze di pagine, voci e contenuti globali	Pubblicare, in qualsiasi ambiente
Preparare bozze di traduzioni	Ripristinare o eliminare
Caricare media	Toccare la Produzione in alcun modo
Creare e modificare bozze di chatbot	Eseguire comandi shell, SQL, accedere a file o recuperare URL
	Distribuire alcunché

Una persona esamina ogni bozza in Studio e la pubblica.

Collegare un agente

In Studio apra Integrations → Coding agents → New connection. Scelga l’ambiente di Sviluppo e i permessi (grant) di cui l’agente ha bisogno:
- contract:read, contract:propose
- content:draft
- media:upload
- bots:draft
- plans:read (Read website plans: blueprint approvati dell’assistente, palette e design token; novità di questa versione)
Solo gli amministratori del sito e dell’organizzazione possono creare connessioni. Faccia clic su Create connection.
Copi il token. Inizia con amc_ e viene mostrato una sola volta.

Aggiunga il server al Suo agente. L’endpoint usa Streamable HTTP:

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

Conservi il token in una variabile d’ambiente, mai in un file sottoposto a commit.

Chieda all’agente di chiamare atlas.connection.get. Dovrebbe riportare il Suo sito e il relativo ambiente di Sviluppo.

Le Guides di Studio contengono brief già pronti per ogni passaggio della migrazione, con i valori del Suo sito già inseriti.

Controlli di sicurezza

Le connessioni possono essere create solo per ambienti di Sviluppo e scadono entro 90 giorni.
Le connessioni create prima dell’introduzione di plans:read devono essere ricreate per ottenerlo.
Ogni chiamata viene verificata rispetto alla connessione attiva, quindi la revoca di una connessione ha effetto dalla chiamata successiva.
Le chiamate sono soggette a limiti di frequenza (120 al minuto per impostazione predefinita) e ogni scrittura richiede una chiave di idempotenza.
Le azioni degli agenti vengono registrate nel registro di audit.

Strumenti

Grant	Strumenti
(sempre)	`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` (sola lettura)

Non esistono strumenti per agenti relativi a font, libreria, animazioni o scansioni del design, e nessuno strumento può pubblicare o approvare alcunché.