Claude Code로 만든 데이터 분석 에이전트, Amazon Bedrock AgentCore로 프로덕션 배포하기

로컬에서 검증한 Claude Code 에이전트를 조직 서비스로 확장하려면 인증, 권한 관리, 확장성 등 인프라 구축이 필요합니다. 이 글은 코드 로직 변경을 최소화하며 Amazon Bedrock AgentCore의 관리형 서비스로 이전하는 방법을 다룹니다.

AgentCore는 로컬 환경의 세 요소를 프로덕션 서비스로 대응시킵니다.

• stdio MCP 서버: AgentCore Gateway로 전환해 관리형 원격 MCP 엔드포인트와 JWT 인증을 제공합니다.
• 로컬 에이전트 실행: AgentCore Runtime으로 배포해 서버리스 컨테이너와 세션 격리, 자동 확장을 지원합니다.
• 외부 검색: AgentCore Web Search로 별도 API 키 없이 관리형 웹 검색을 연동합니다.

Claude Agent SDK는 로컬과 프로덕션을 잇는 다리 역할을 합니다. SDK는 Claude Code의 프로젝트 설정을 그대로 읽어 비대화형으로 실행하며, stdio MCP와 원격 MCP를 동일하게 처리해 에이전트 로직 재작성을 방지합니다.

예제 시나리오는 6개월치 주문 데이터를 보유한 이커머스 쇼핑몰입니다. 데이터 생성부터 로컬 에이전트 실행, MCP 도구 전환, Runtime 배포, 웹 검색 연동까지 네 단계로 프로덕션 이전 과정을 순서대로 설명합니다. 모든 예제는 us-east-1 리전을 기준으로 하며, Claude Sonnet 4.6 모델 액세스가 필요합니다.