기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Bedrock AgentCore Gateway
이 문서는 Amazon Bedrock AgentCore Gateway와 통합할 수 있는 API 기반 AI 에이전트 제품 또는 도구를 나열하려는 AWS Marketplace 판매자를 위한 정보를 제공합니다.
**Topics**
+ [개요](#agentcore-overview)
+ [Bedrock AgentCore Gateway와 통합](#bedrock-agentcore-integration)
## 개요
Amazon Bedrock AgentCore Gateway는 개발자가 대규모로 도구를 빌드, 배포, 검색 및 연결하는 데 도움이 됩니다. 서비스를 통해 다음을 수행할 수 있습니다.
+ API, Lambda 함수 및 기존 서비스를 Model Context Protocol(MCP) 호환 도구로 변환
+ 게이트웨이 엔드포인트를 통해 에이전트가 도구를 사용할 수 있도록 설정
+ 완전 관리형 서비스에서 포괄적인 수신 및 송신 인증 사용
AI 에이전트는 이러한 도구를 사용하여 다음과 같은 작업을 수행합니다.
+ 데이터베이스 쿼리
+ 메시지 보내기
+ 문서 분석
자세한 내용은 [Amazon Bedrock AgentCore 개발자 안내서](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html)를 참조하세요.
## Bedrock AgentCore Gateway와 통합
제품에 따라 다음 방법 중 하나로 SaaS API 기반 AI 에이전트 제품에 대해 Amazon Bedrock AgentCore Gateway 통합을 활성화할 수 있습니다.
+ 2각 OAuth 인증을 지원하는 MCP 서버를 나열하는 경우 추가 요구 사항 없이 구매자에게 통합을 제공하도록 옵트인할 수 있습니다. 등록 프로세스의 일부로 제공하는 MCP 서버 엔드포인트가 통합에 사용됩니다. 그러나 MCP 서버가 아래 나열된 요구 사항을 충족하는지 확인해야 합니다. 자세한 내용은 [MCP 서버 대상](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-MCPservers.html)을 참조하세요.
+ 다른 모든 에이전트 또는 도구의 경우 OpenAPI 사양을 제공하여 통합을 활성화할 수 있습니다.
### MCP 서버 요구 사항
MCP 서버는 다음 요구 사항을 충족해야 합니다.
+ 다음 구성 중 하나를 사용한 2각 OAuth 인증:
+ 클라이언트 ID, 클라이언트 보안 암호 및 검색 URL
+ 클라이언트 ID, 클라이언트 보안 암호, 발급자, 권한 부여 엔드포인트 및 토큰 엔드포인트.
+ MCP 서버에는 도구 기능이 있어야 합니다.
+ 지원되는 MCP 프로토콜 버전: **2025-06-18** 및 **2025-03-26**.
+ 해당 서버의 제공된 URL 또는 엔드포인트의 경우, URL을 인코딩해야 합니다. 게이트웨이는 동일한 URL을 사용하여 서버를 간접적으로 호출합니다.
### OpenAPI 사양 요구 사항
OpenAPI 사양은 다음과 같아야 합니다.
+ 모든 작업에 대한 `operationId` 필드 포함
+ 의미 체계 오류 없음
+ 서버 속성에 유효한 보안(https) 엔드포인트 URL 포함
다음 표에는 지원되는 OpenAPI 기능과 지원되지 않는 OpenAPI 기능이 나와 있습니다.
| 카테고리 | 지원됨 | 지원되지 않음 |
| --- | --- | --- |
| 버전 | 3.0 및 3.1 | 2 |
| 스키마 정의 | 기본 데이터 유형(문자열, 숫자, 부울 등) | oneOf 사양 |
| | 필수 필드 검증 | anyOf 사양 |
| | 중첩된 객체 | |
| | 항목 사양을 포함하는 배열 | |
| | 표준 HTTP 메서드 | |
| 미디어 유형 | application/json | 사용자 지정 미디어 유형 |
| | application/xml | 이진 미디어 유형 |
| | multipart/form-data | |
| | x-www-form-urlencoded | |
| 파라미터 | 단순 경로 파라미터 및 string/number/boolean 유형과 같은 기본 쿼리 파라미터 | 복잡한 경로 파라미터 직렬화 |
| | | 복잡한 쿼리 파라미터 배열 |
| | | 헤더 파라미터 직렬화 |
| | | 쿠키 파라미터 직렬화 |
| 요청 및 응답 | JSON 본문 | |
| | XML 본문 | |
| | 표준 HTTP 상태 코드 | |
| 검증 | 기본 필드 검증 | 정규식 패턴 검증 |
| | | 최솟값/최댓값 검증 |
| 보안 | 해당 사항 없음 | 사양 수준의 보안 체계 |
| | | 여러 보안 체계 |
| | | 사양 수준의 OAuth 2.0 |
| | | 사양 수준의 API 키 |
| | | 사양 수준의 HTTP 기본 인증 |
| 서버 구성 | 기본 URL | |
| | 자리 표시자가 있는 URL | |
### Bedrock AgentCore Gateway 활성화
게이트웨이 통합을 활성화하기 전에 다음 작업을 완료하여 Amazon Bedrock AgentCore Gateway로 OpenAPI 사양 또는 MCP 서버를 테스트합니다.
+ [게이트웨이 생성](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building.html)
+ [대상 연결](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html)
+ [게이트웨이 테스트](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-testing.html)
**게이트웨이 통합을 활성화하려면**
1. [AWS Partner Central](https://us-east-1.console.aws.amazon.com/partnercentral/home)에 로그인합니다.
1. [AI 에이전트 및 도구](https://aws.amazon.com/marketplace/management/products/aiagents) 페이지를 엽니다.
1. **AI 에이전트 및 도구 제품** 탭에서 수정할 제품을 선택합니다.
1. **변경 요청** 드롭다운 목록에서 **이행 옵션 업데이트**를 선택합니다.
1. **Amazon Bedrock AgentCore 통합을 위한 도구 활성화**를 선택합니다.
1. OpenAPI 사양을 업로드합니다. 2각 OAuth 지원 MCP Server 제품의 경우 필수는 아니며 MCP 엔드포인트만 필요합니다.
1. **제출**을 선택합니다.
제출한 후에는 **요청** 탭에 요청 상태가 **검토 중**으로 표시됩니다. 처리를 완료하면 상태가 **성공**으로 변경됩니다.