AI 智能体（MCP）

让 Claude Code 或 Codex 等 AI 编程智能体起草内容并提出契约更改，同时由人员掌控发布。

本页面由英文翻译而来。如有任何差异，以英文版本为准。阅读英文版

Atlas 提供一个 Model Context Protocol 端点，使在您网站代码仓库中工作的 AI 编程智能体可以完成迁移中的重复性部分：为站点契约建模、上传图片、创建条目和页面，以及起草译文。

智能体能做什么，不能做什么

智能体可以	智能体永远不能
读取契约；验证并提出更改	批准或激活契约
创建和编辑页面、条目和全局内容的草稿	在任何环境中发布
起草译文	回滚或删除
上传媒体	以任何方式接触生产环境
创建和编辑聊天机器人草稿	运行 shell 命令、SQL、访问文件或获取 URL
	部署任何内容

每份草稿都由人员在 Studio 中审阅并发布。

连接智能体

在 Studio 中打开 Integrations → Coding agents → New connection。选择开发环境以及智能体所需的权限（grants）：
- contract:read、contract:propose
- content:draft
- media:upload
- bots:draft
- plans:read（Read website plans：已批准的助手蓝图、配色方案和设计令牌；本次发布新增）
只有站点管理员和组织管理员可以创建连接。点击 Create connection。
复制令牌。它以 amc_ 开头，只显示一次。

将该服务器添加到您的智能体。该端点使用 Streamable HTTP：

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

请将令牌保存在环境变量中，切勿放入会被提交的文件。

让智能体调用 atlas.connection.get。它应报告您的站点及其开发环境。

Studio 的 Guides 中包含针对每个迁移步骤的现成说明，并已填入您站点的值。

安全控制

连接只能为开发环境创建，并在 90 天内过期。
在 plans:read 出现之前创建的连接必须重新创建才能获得该权限。
每次调用都会对照实时连接进行检查，因此撤销连接会在下一次调用时生效。
调用有速率限制（默认每分钟 120 次），并且每次写入都需要幂等键。
智能体的操作会记录在审计日志中。

工具

权限	工具
（始终）	`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`（只读）

目前没有用于字体、创意库、动画或设计扫描的智能体工具，也没有任何工具可以发布或批准任何内容。