Agentes de IA (MCP)

Deixe um agente de codificação com IA, como o Claude Code ou o Codex, criar rascunhos de conteúdo e propor alterações no contrato, enquanto as pessoas mantêm o controle da publicação.

Esta página foi traduzida do inglês. Se houver qualquer diferença, vale a versão em inglês. Ler em inglês

O Atlas expõe um endpoint do Model Context Protocol para que um agente de codificação com IA que trabalha no repositório do seu site possa fazer as partes repetitivas de uma migração: modelar o contrato do site, enviar imagens, criar entradas e páginas e criar rascunhos de traduções.

O que um agente pode e não pode fazer

Agentes podem	Agentes nunca podem
Ler o contrato; validar e propor alterações	Aprovar ou ativar um contrato
Criar e editar rascunhos de páginas, entradas e globais	Publicar, em qualquer ambiente
Criar rascunhos de traduções	Reverter ou excluir
Enviar mídia	Tocar no Production de qualquer forma
Criar e editar rascunhos de chatbot	Executar comandos de shell, SQL, acessar arquivos ou buscar URLs
	Fazer deploy de qualquer coisa

Uma pessoa revisa cada rascunho no Studio e o publica.

Conecte um agente

No Studio, abra Integrations → Coding agents → New connection. Escolha o ambiente Development e as permissões (grants) de que o agente precisa:
- contract:read, contract:propose
- content:draft
- media:upload
- bots:draft
- plans:read (Read website plans: blueprints, paletas e design tokens aprovados do helper; novo neste release)
Somente administradores do site e da organização podem criar conexões. Clique em Create connection.
Copie o token. Ele começa com amc_ e é exibido uma única vez.

Adicione o servidor ao seu agente. O endpoint usa Streamable HTTP:

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

Mantenha o token em uma variável de ambiente, nunca em um arquivo versionado.

Peça ao agente que chame atlas.connection.get. Ele deve informar o seu site e o ambiente Development dele.

Os Guides do Studio contêm briefings prontos para cada etapa da migração, com os valores do seu site preenchidos.

Controles de segurança

As conexões só podem ser criadas para ambientes Development e expiram em até 90 dias.
As conexões criadas antes de existir o plans:read precisam ser recriadas para recebê-lo.
Cada chamada é verificada contra a conexão ativa, então revogar uma conexão vale já na chamada seguinte.
As chamadas têm limite de taxa (120 por minuto por padrão), e toda escrita exige uma chave de idempotência.
As ações dos agentes são registradas no log de auditoria.

Ferramentas

Grant	Ferramentas
(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` (somente leitura)

Não há ferramentas de agente para fontes, a biblioteca, animações ou verificações de design, e nenhuma ferramenta pode publicar ou aprovar qualquer coisa.