기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Bedrock AgentCore Gateway
이 문서는 Amazon Bedrock AgentCore Gateway와 통합할 수 있는 API 기반 AI 에이전트 제품 또는 도구를 나열하려는 AWS Marketplace 판매자를 위한 정보를 제공합니다.
개요
Amazon Bedrock AgentCore Gateway는 개발자가 대규모로 도구를 빌드, 배포, 검색 및 연결하는 데 도움이 됩니다. 서비스를 통해 다음을 수행할 수 있습니다.
-
API, Lambda 함수 및 기존 서비스를 Model Context Protocol(MCP) 호환 도구로 변환
-
게이트웨이 엔드포인트를 통해 에이전트가 도구를 사용할 수 있도록 설정
-
완전 관리형 서비스에서 포괄적인 수신 및 송신 인증 사용
AI 에이전트는 이러한 도구를 사용하여 다음과 같은 작업을 수행합니다.
-
데이터베이스 쿼리
-
메시지 보내기
-
문서 분석
자세한 내용은 Amazon Bedrock AgentCore 개발자 안내서를 참조하세요.
Bedrock AgentCore Gateway와 통합
제품에 따라 다음 방법 중 하나로 SaaS API 기반 AI 에이전트 제품에 대해 Amazon Bedrock AgentCore Gateway 통합을 활성화할 수 있습니다.
-
2각 OAuth 인증을 지원하는 MCP 서버를 나열하는 경우 추가 요구 사항 없이 구매자에게 통합을 제공하도록 옵트인할 수 있습니다. 등록 프로세스의 일부로 제공하는 MCP 서버 엔드포인트가 통합에 사용됩니다. 그러나 MCP 서버가 아래 나열된 요구 사항을 충족하는지 확인해야 합니다. 자세한 내용은 MCP 서버 대상을 참조하세요.
다른 모든 에이전트 또는 도구의 경우 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 서버를 테스트합니다.
게이트웨이 통합을 활성화하려면
-
AWS Marketplace Management Portal
에 로그인합니다. -
AI 에이전트 및 도구
페이지를 엽니다. -
AI 에이전트 및 도구 제품 탭에서 수정할 제품을 선택합니다.
-
변경 요청 드롭다운 목록에서 이행 옵션 업데이트를 선택합니다.
-
Amazon Bedrock AgentCore 통합을 위한 도구 활성화를 선택합니다.
-
OpenAPI 사양을 업로드합니다. 2각 OAuth 지원 MCP Server 제품의 경우 필수는 아니며 MCP 엔드포인트만 필요합니다.
-
제출을 선택합니다.
제출한 후에는 요청 탭에 요청 상태가 검토 중으로 표시됩니다. 처리를 완료하면 상태가 성공으로 변경됩니다.