Amazon Bedrock AgentCore Gateway를 활용한 MCP 서버 통합 방법

아마존 Bedrock AgentCore Gateway를 활용한 MCP 서버 통합 가이드

도입

지능형 에이전트(AI Agent)의 상용화가 가속화되면서, 맞춤형 Model Context Protocol(MCP) 서버를 조직 내 다양한 도메인, 팀, 기능에 따라 구축하는 사례가 증가하고 있습니다. 그러나 이러한 MCP 서버를 개별적으로 운영하게 되면 인증, 공유, 유지 보수 측면에서 복잡도가 급증합니다. 이러한 문제를 해결하기 위해 AWS는 Amazon Bedrock AgentCore Gateway에 기존 MCP 서버를 통합할 수 있는 기능을 제공하며, 이에 따라 다양한 서버를 단일 인터페이스를 통해 효율적으로 관리하고 사용할 수 있게 되었습니다.

본 가이드는 AgentCore Gateway에 MCP 서버를 포함하는 방법, 자동화 배포, 인증 연동, 동기화 전략 등을 실전 사례 중심으로 자세히 설명합니다.

본론

1. MCP 서버 통합의 필요성

조직 내 다양한 팀이 독립적으로 MCP 서버를 운영할 경우, 하나의 AI Agent는 수많은 MCP 인터페이스에 개별로 연결해야 하며, 각 서버의 인증 방식까지 따로 고려해야 합니다. AgentCore Gateway는 이러한 서버들을 하나의 타겟 구조로 묶고, 인증, 도구 발견, 호출 절차를 일원화하여 운영 효율성을 높입니다.

실제 전자상거래 예시에서는 쇼핑카트, 제품 검색, 할인 정책 관리를 각각 MCP 서버로 분리하여 접근했지만, 이제는 아래 구조와 같이 단일 게이트웨이로 통합 가능합니다.

2. AgentCore Gateway 아키텍처 개요

• 각 MCP 서버는 이제 REST API, Lambda 함수와 동일하게 게이트웨이의 대상(Target)으로 간주됩니다.
• 인증은 OAuth 2.0 기반으로 구성하며, 대상 MCP 서버의 인증 장치와 무관하게 중앙에서 연결을 제공합니다.
• MCP 서버 내 도구(tool)는 게이트웨이를 통해 동적으로 검색되고 호출됩니다.

3. 배포 가이드: MCP 서버를 Gateway에 추가하는 과정

• STEP 1: AgentCore Gateway 생성

  • boto3 Python SDK를 활용하여 Gateway 생성
  • 사용자 인증용 Cognito Client ID와 Discovery URL 설정

• STEP 2: MCP 서버 구축

  • FastMCP 라이브러리로 서버 예시 구현
  • 예: getOrder, updateOrder, cancelOrder 도구 생성

• STEP 3: AgentCore Runtime에 MCP 서버 배포

  • Starter Toolkit을 이용한 Docker 기반 배포
  • 인증은 별도의 Cognito 구성을 유지 가능

• STEP 4: Gateway에 MCP 서버를 타겟으로 연결

  • Gateway Target 생성 시 OAuth 인증 공급자를 연결
  • MCP 서버 엔드포인트를 지정하여 연동 활성화

• STEP 5: 상태 모니터링

  • get_gateway_target API를 이용해 Target 준비 상태(READY) 확인

4. 동기화 전략: MCP 도구 정의의 최신화 자동화

MCP 서버에서 도구가 변경되거나 추가될 경우, AgentCore Gateway는 SynchronizeGatewayTargets API를 통해 해당 서버의 도구 목록을 갱신할 수 있습니다.

도구 정의가 자주 갱신되지 않는 실무 환경에서는 명시적인 API 호출 전략을 통해 안정성과 성능을 동시에 확보할 수 있습니다.

5. 실제 동작 예시

• AgentCore Gateway 내 ListTools 호출은 동기화된 캐시를 우선 사용하여 성능을 극대화합니다.
• 도구 호출 시 OAuth 인증을 통해 MCP 서버와 실시간 세션을 구성하고 응답을 처리합니다.

6. 검색 기능 활용

• AgentCore Gateway는 MCP 서버 도구에 대해 이름, 설명, 파라미터 등을 임베딩하여 semantic search가 가능합니다.
• 각 도구는 도매인 언어와 상관없이 검색되므로, 에이전트의 활용성을 크게 향상시킵니다.

결론

Amazon Bedrock AgentCore Gateway의 MCP 서버 통합 기능은 에이전트화된 아키텍처의 확장성과 운영 통제를 혁신적으로 향상시킵니다. 각 MCP 서버의 팀별 자율성을 보장하면서도, 중앙 집중형 인증과 도구 관리 기능을 제공함으로써 보안성 및 자동화 효율을 극대화할 수 있습니다. 이 가이드를 통해 조직은 기존 IT 자산을 효율적으로 연결하고, 새로운 에이전트 기반 워크플로우를 빠르게 구축할 수 있습니다.

https://aws.amazon.com/blogs/machine-learning/transform-your-mcp-architecture-unite-mcp-servers-through-agentcore-gateway/