AI 에이전트 (MCP)

Claude Code나 Codex 같은 AI 코딩 에이전트가 콘텐츠 초안을 작성하고 계약 변경을 제안하게 하면서, 게시는 사람이 계속 통제하세요.

이 페이지는 영어에서 번역되었습니다. 내용이 다를 경우 영어 버전이 우선합니다. 영어로 읽기

Atlas는 Model Context Protocol 엔드포인트를 제공하므로, 웹사이트 저장소에서 작업하는 AI 코딩 에이전트가 마이그레이션의 반복 작업을 처리할 수 있습니다. 사이트 계약 모델링, 이미지 업로드, 항목과 페이지 생성, 번역 초안 작성 등입니다.

에이전트가 할 수 있는 것과 없는 것

에이전트가 할 수 있는 것	에이전트가 절대 할 수 없는 것
계약 읽기, 변경 검증 및 제안	계약 승인 또는 활성화
페이지, 항목, 글로벌의 초안 생성 및 수정	어떤 환경에서든 게시
번역 초안 작성	롤백 또는 삭제
미디어 업로드	어떤 방식으로든 프로덕션에 접근
챗봇 초안 생성 및 수정	셸 명령, SQL, 파일 접근, URL 가져오기 실행
	무엇이든 배포

모든 초안은 사람이 Studio에서 검토하고 게시합니다.

에이전트 연결

Studio에서 Integrations → Coding agents → New connection을 엽니다. 개발 환경과 에이전트에 필요한 권한(grant)을 선택합니다.
- contract:read, contract:propose
- content:draft
- media:upload
- bots:draft
- plans:read (Read website plans: 승인된 helper 블루프린트, 팔레트, 디자인 토큰. 이번 릴리스에서 추가됨)
연결은 사이트 관리자와 조직 관리자만 만들 수 있습니다. 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` (읽기 전용)

글꼴, 라이브러리, 애니메이션, 디자인 스캔용 에이전트 도구는 없으며, 어떤 도구도 게시하거나 승인할 수 없습니다.