AI 代理程式（MCP）

讓 Claude Code 或 Codex 等 AI 程式碼代理程式起草內容並提出合約變更，同時由人員掌控發布。

本頁翻譯自英文。若內容有任何差異，以英文版為準。閱讀英文版

Atlas 提供 Model Context Protocol 端點，讓在您網站程式碼儲存庫中工作的 AI 程式碼代理程式，可以處理遷移中重複性的部分：為網站合約建模、上傳圖片、建立項目與頁面，以及起草翻譯。

代理程式能做與不能做的事

代理程式可以	代理程式一律不可以
讀取合約；驗證並提出變更申請	核准或啟用合約
建立並編輯頁面、項目與全域內容的草稿	在任何環境中發布
起草翻譯	還原或刪除
上傳媒體	以任何方式接觸 Production
建立並編輯聊天機器人草稿	執行 shell 指令、SQL、檔案存取或擷取 URL
	部署任何內容

每份草稿都由人員在 Studio 中審閱並發布。

連接代理程式

在 Studio 中開啟 Integrations → Coding agents → New connection。選擇 Development 環境，以及代理程式所需的權限（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。它應回報您的網站及其 Development 環境。

Studio 的指南包含每個遷移步驟的現成指示範本，並已填入您網站的值。

安全控管

連線只能為 Development 環境建立，並會在 90 天內到期。
在 plans:read 出現之前建立的連線，必須重新建立才能取得此權限。
每次呼叫都會依即時的連線狀態檢查，因此撤銷連線會在下一次呼叫時生效。
呼叫有速率限制（預設每分鐘 120 次），且每次寫入都需要冪等性金鑰（idempotency key）。
代理程式的動作會記錄在稽核記錄中。

工具

權限（Grant）	工具
（一律提供）	`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`（唯讀）

目前沒有適用於字型、資源庫、動畫或設計掃描的代理程式工具，也沒有任何工具可以發布或核准任何內容。