AgentCore Gateway와 API Gateway 연동으로 REST API 기반 AI 자동화 구축하기

AWS AgentCore Gateway와 API Gateway 연동으로 에이전트 기반 AI 툴 자동화 환경 구성하기

AI 도입이 활발해짐에 따라, 다양한 기업에서는 기존 시스템과 대규모 언어 모델(LLM)을 연결하여 자동화된 에이전트 기반 애플리케이션을 구축하고자 합니다. 이러한 흐름 속에서 Amazon은 AgentCore Gateway를 통해 Model Context Protocol (MCP)과 API Gateway의 연동을 지원하며, 기존 API 자산을 손쉽게 새로운 AI 체계에 통합할 수 있게 되었습니다.

이 글에서는 AgentCore Gateway와 API Gateway의 통합 개요, 실제 활용 사례, 설정 방법, 자동화 및 관측 기능 등을 상세히 소개합니다.

AgentCore Gateway와 API Gateway 통합의 핵심

이제는 MCP를 지원하는 AgentCore Gateway가 Amazon API Gateway를 타겟으로 연결할 수 있어, 기존 RESTful API 자산을 자연스럽게 에이전트 기반의 워크플로우에 활용할 수 있게 되었습니다. 간단한 CLI 명령이나 콘솔 항목 추가만으로도 기존 API를 대상 타겟으로 설정할 수 있으며, IAM 또는 API Key 기반 인증도 제공합니다.

이는 OpenAPI 스펙으로 내보내거나 수동으로 명세를 등록하지 않아도 되어, 자동화된 에이전트 기능 배포 시 소요되는 시간을 획기적으로 줄여줍니다.

활용 사례: REST API 기반 AI 응답 자동화

예를 들어, API Gateway를 통해 제공되고 있는 반려동물 조회/등록 API를 AgentCore Gateway를 통해 MCP 연동 툴로 선언하면, AI 에이전트는 사용자 질문에 따라 아래와 같은 자동 응답을 생성할 수 있습니다.

• “등록된 반려동물을 모두 보여줘” → 자동 GET /pets 호출
• “고양이 가격이 얼마야?” → 자동 GET /pets/{petId} 호출
• “내 주문 상태 알려줘” → 자동 GET /orders/{orderId} 호출

이를 통해 고객 서비스, 쇼핑 도우미, 헬프데스크 챗봇 등에서 사람처럼 작동하는 에이전트를 신속하게 배포할 수 있습니다.

배포 가이드: 통합 설정 절차

1. AgentCore Gateway 생성
   Amazon Cognito 또는 커스텀 JWT 인증자를 활용한 인증 구성 후, MCP 프로토콜 기반 게이트웨이를 생성합니다.

2. API Gateway를 대상으로 하는 타겟 생성
   REST API의 ID, 스테이지, 노출할 경로(method/path)와 설명을 포함한 toolFilters 및 toolOverrides 설정을 정의합니다.

3. 인증 구성
   IAM Role을 사용하는 GATEWAY_IAM_ROLE 방식이나, API Key를 사용하는 API_KEY 방식을 선택할 수 있으며, 무인증(NO_AUTH)은 권장되지 않습니다.

4. 테스트
   MCP 클라이언트(예: Strands Agent Framework)를 이용해 구성한 MCP 툴에 대해 listTools, invoke 기능 테스트를 수행합니다.

5. 관측(Observability) 설정
   AWS CloudWatch, CloudTrail, X-Ray 통합으로 REST API 호출, 파라미터, 응답 및 오류를 분석할 수 있습니다.

자동화 측면의 이점

• REST API 등록 자동화: boto3 및 AWS CLI를 통한 일괄 등록 가능
• 인증 연동 자동화: 권한 부여 정책 및 API Key 매핑 자동 구성
• 관측 기능 일괄 설정: 로그 및 추적 자동 수집
• 워크플로우 반복 실행 지원: MCP 호출 기반 구성으로 동일한 API 반복 사용

이러한 기능들은 기업이 기존 시스템을 통째로 교체하지 않고도 효율적인 AI 도입을 가능케 하며, MCP 기반 접근을 통해 보안성과 유지보수성까지 강화합니다.

구성 마무리 후에는 비용을 방지하기 위한 리소스 제거(delete 명령)도 반드시 수행해야 합니다.

맺음말

AgentCore Gateway의 API Gateway 통합을 통해, 기업은 기존 REST API 자산을 그대로 활용하면서도 차세대 에이전트 기반 AI 애플리케이션에 즉시 활용할 수 있는 인프라 환경을 마련할 수 있습니다. 이를 통해 AI 도입과 도구 자동화, API 활용도를 동시에 높일 수 있습니다.

현대적인 시스템 연동에 관심 있으신 분들은 AgentCore 공식 문서와 샘플 워크숍 리포지토리를 참고하여 곧바로 실습 가능합니다.

https://aws.amazon.com/blogs/machine-learning/streamline-ai-agent-tool-interactions-connect-api-gateway-to-agentcore-gateway-with-mcp/