AWS가 이번 주 콘솔에 새 카드를 추가했습니다: Agent Toolkit for AWS입니다. 무료이고, 정식 출시 상태이며, Claude Code, Codex, Cursor, Kiro와 함께 동작합니다. 설정 프롬프트 하나로 코딩 에이전트에 AWS API용 MCP 서버, 흔한 작업을 위한 선별된 스킬, IAM 가드레일이 주어집니다. 툴킷 자체도 유용합니다. 하지만 이 툴킷이 인정하는 사실이 더 큽니다: AWS 문서의 주요 독자는 더 이상 사람이 아닙니다.

패키지에 담긴 것

세 개의 레이어로 구성되며, 각각 독립적으로 동작합니다:

  • AWS MCP Server. 에이전트가 mcp-proxy-for-aws를 통해 접근하는 호스팅 엔드포인트(aws-mcp.us-east-1.api.aws)입니다. 에이전트에 AWS API 접근, 샌드박스 스크립트 실행, 실시간 문서 검색을 제공합니다. 자격 증명은 API 호출에만 필요하며, 문서 검색은 자격 증명 없이도 동작합니다.
  • 플러그인. aws-core는 서비스 선택, CDK와 CloudFormation, 서버리스, 컨테이너, 스토리지, 옵저버빌리티, 빌링을 다룹니다. aws-agents는 Bedrock과 AgentCore 스킬을 추가하고, aws-data-analytics와 aws-agents-for-devsecops는 각자의 도메인을 담당합니다. Claude Code에서는 공식 플러그인 마켓플레이스에서 /plugin install 한 번으로 설치됩니다.
  • 스킬. npx skills add aws/agent-toolkit-for-aws/skills로 설치하는 선별된 작업 지침입니다. 온디맨드로 로드됩니다: 에이전트가 현재 작업에 맞는 것만 가져오므로, 실제로 쓰이기 전까지는 아무 비용도 들지 않습니다.

인증은 새로운 브라우저 기반 aws login 흐름으로 진행되며, aws sts get-caller-identity로 검증합니다. 터미널에서 주로 생활하신다면 aws configure agent-toolkit이 AWS CLI를 통해 같은 것을 연결해 줍니다.

설정은 스크립트가 아니라 프롬프트입니다

여기 잠시 멈춰서 볼 만한 디테일이 있습니다. 콘솔은 셸 스크립트를 건네주지 않습니다. 에이전트에 붙여넣을 문장 하나를 건네줍니다:

Set up Agent Toolkit for AWS by following instructions:
https://raw.githubusercontent.com/aws/agent-toolkit-for-aws/refs/heads/main/setup-instructions/setup.md

저 URL은 Markdown 파일입니다. 에이전트가 이 파일을 읽고, OS를 감지하고, AWS CLI가 없으면 설치하고, aws login을 실행하고, MCP 서버를 연결하고, 스킬을 설치합니다. 문서는 기계를 위한 런북처럼 구성되어 있습니다: 번호가 매겨진 단계, 오류 처리 표, 단계마다 붙어 있는 검증 명령. AWS는 의도된 독자가 여러분이 아닌 설치 가이드를 작성한 셈입니다. 여러분은 권한 프롬프트를 승인하기만 하면 됩니다.

주목할 패턴이 바로 이것입니다. 설치 지침은 예전에는 복사할 코드 블록이 딸린, 사람을 위한 산문이었습니다. 이것은 사람이 한 번 훑어보는 산문이 딸린, 에이전트를 위한 코드입니다.

이제 문서를 읽는 것은 에이전트뿐입니다

하나 고백하겠습니다. 수년간 제 주말 독서는 추리소설이나 소설이 아니었습니다. AWS 문서였습니다: 서비스 쿼터, API 엣지 케이스, 아무도 이야기하지 않는 어느 스토리지 클래스의 체인지로그. 그 독서가 저를 빠르게 만들어 준 머릿속 인덱스를 쌓았습니다. 답이 어디에 있는지 아는 것이 일의 대부분이었기 때문입니다.

그 인덱스는 이제 범용재가 되었습니다. 문서 검색을 갖춘 에이전트는 제가 2년 전에 외운 페이지가 아니라 지금의 페이지를 읽고, 그것도 몇 초 만에 읽습니다. 이번 툴킷은 이를 공식화합니다: AWS는 이제 자사 문서를 기계에 공급하는 전용 파이프라인을 운영하며, "최신 문서와 검증된 절차"를 대표 기능으로 내세웁니다. 문서 팀의 가장 중요한 고객은 이제 종 자체가 바뀌었습니다.

범용재가 되지 않는 것은 판단력입니다. 어떤 서비스가 맞는지, 변경의 블라스트 반경이 어디까지인지, 에이전트의 계획이 여러분 계정의 현실과 부딪혀도 살아남을지. AWS의 소개 문구에서 세 번째 단어가 가드레일인 이유가 여기에 있습니다: 동작하는 자격 증명을 가진 에이전트는 여느 프린시펄과 다를 바 없는 프린시펄이고, 여느 프린시펄처럼 최소 권한을 받아야 합니다. 이와 관련해 실무적인 노트 두 가지를 남깁니다:

  • 프록시 버전을 고정하십시오(mcp-proxy-for-aws@1.6.3 방식). AWS의 README도 공급망 리스크에 대비해 이를 권장하며, 옳은 권장입니다.
  • 에이전트의 역할은 기본적으로 읽기 전용으로 범위를 제한하고, 변경을 일으키는 경로는 하나하나 별도로 게이트하십시오. 툴킷의 IAM 가드레일이 도움은 되지만, 정책은 여전히 여러분이 작성해야 합니다.

마무리하며

AWS 개발의 에이전트 시대는 기조연설과 함께 오지 않았습니다. 설정 프롬프트를 제안하는 콘솔의 작은 카드로 왔습니다. AWS는 이제 어떤 프로젝트에서든 여러분의 첫 협업자가 에이전트라고 가정하고, 그 독자를 위해 만든 문서, 절차, 권한 경계를 제공합니다. 제 주말에도 드디어 추리소설 한 권 들어갈 자리가 생길지 모르겠습니다. 문서는 좋은 손에 맡겨졌고, 흥미로운 일, 즉 무엇을 만들지와 에이전트가 무엇을 건드려도 되는지 정하는 일은 어차피 처음부터 인덱싱할 수 없는 부분이었습니다.

이어서 읽기