# API Gateway REST API를 Amazon Bedrock AgentCore Gateway의 대상으로 추가
<a name="mcp-server"></a>

Amazon Bedrock AgentCore Gateway는 AI 에이전트 개발자에게 API Gateway REST API를 Model Context Protocol(MCP) 호환 도구로 노출할 수 있는 안전한 방법을 제공합니다. AgentCore Gateway는 대상을 사용하여 도구를 정의합니다. 스테이지를 대상으로 추가하면 Gateway는 에이전트의 도구에 액세스할 수 있는 단일 MCP URL이 됩니다. 자세한 내용은 *Amazon Bedrock AgentCore Gateway 개발자 안내서*의 [API Gateway REST API 스테이지를 대상으로 지정](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-api-gateway.html)을 참조하세요.

API Gateway 대상은 AgentCore Gateway를 REST API의 스테이지에 연결합니다. 전체 스테이지를 대상으로 포함하거나 리소스를 선택할 수 있습니다. API Gateway 대상을 생성하면 AgentCore Gateway는 수신 MCP 요청을 HTTP 요청으로 변환하고 응답 형식을 처리합니다. MCP 클라이언트는 `tools/list` 메서드를 사용하여 API 설명서를 검색하고 `tools/call` 메서드를 사용하여 API를 간접적으로 호출할 수 있습니다.

## 고려 사항
<a name="w2aac15c11c11c34c11b7"></a>

다음 고려 사항은 AgentCore Gateway에 대상으로 스테이지를 추가하는 사용에 영향을 미칠 수 있습니다.
+ AgentCore Gateway가 이미 있어야 합니다.
+ 공개 REST API만 지원됩니다.
+ API의 기본 엔드포인트를 비활성화할 수 없습니다.
+ API의 모든 메서드에는 [작업 이름](https://docs.aws.amazon.com/apigateway/latest/api/API_PutMethod.html#apigw-PutMethod-request-operationName)이 정의되어 있거나 스테이지를 대상으로 추가할 때 이름 재정의를 생성해야 합니다. 이 이름은 에이전트가 메서드와 상호 작용하는 데 사용하는 도구 이름으로 사용됩니다.
+ 아웃바운드 인증에 `API_KEY`, `NO_AUTH` 또는 `GATEWAY_IAM_ROLE` 자격 증명 공급자 유형을 사용하여 Gateway가 API에 액세스하도록 허용할 수 있습니다. `API_KEY` 자격 증명 공급자는 AgentCore Gateway에서 정의합니다. 기존 API Gateway API 키를 사용할 수 있습니다. 자세한 내용은 [아웃바운드 인증 설정](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-outbound-auth.html)을 참조하세요.
+ Amazon Cognito 사용자 풀 또는 Lambda 권한 부여자를 사용하여 API에 대한 액세스를 제어하는 경우 MCP 클라이언트는 액세스할 수 없습니다.
+ API는 AgentCore Gateway와 동일한 계정 및 리전에 있어야 합니다.

## API의 스테이지를 AgentCore Gateway의 대상으로 추가
<a name="mcp-server-api-gateway"></a>

다음 절차에서는 API의 스테이지를 AgentCore Gateway의 대상으로 추가하는 방법을 보여줍니다.

**API의 스테이지를 AgentCore Gateway의 대상으로 추가하려면**

1. [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway)에서 API Gateway 콘솔에 로그인합니다.

1. 스테이지에 배포된 REST API를 선택합니다.

1. 기본 탐색 창에서 **스테이지**를 선택합니다.

1. **스테이지 작업**, **MCP 대상 생성**을 차례대로 선택합니다.

1. **AgentCore Gateway**에서 AgentCore Gateway를 선택합니다.

1. **대상 이름**에 대상 이름을 입력합니다.

1. **대상 설명**에 설명을 입력합니다.

1. 제공된 API와 스테이지를 유지합니다.

1. **API 리소스 선택**에서 AgentCore Gateway를 사용하는 에이전트가 액세스할 수 있는 API의 리소스를 선택합니다.

   리소스를 선택하지 않으면 에이전트가 설명서를 보거나 엔드포인트를 간접 호출할 수 없습니다.

1. 리소스와 메서드의 조합은 도구의 작업입니다. 작업에 이름이 없는 경우 이름 재정의를 생성합니다.

   메서드를 생성할 때 메서드의 작업 이름을 정의할 수도 있습니다.

1. **아웃바운드 인증 구성**에서 **IAM 역할**, **권한 부여 없음** 또는 **API 키**를 선택합니다.

1. **대상 생성**을 선택합니다.

API에 액세스할 수 있는 모든 AgentCore Gateway를 보려면 기본 탐색 창에서 **MCP 대상** 섹션을 선택합니다. 이 섹션에서는 스테이지에 배포된 리전의 모든 API에 대해 MCP 대상을 생성할 수 있습니다. **MCP 대상 생성**을 선택하고 이전 단계를 따릅니다.

AgentCore Gateway 콘솔에서 대상에 사용할 수 있는 도구를 보고 대상을 편집할 수도 있습니다. 자세한 내용은 [기존 AgentCore Gateway에 대상 추가](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html)를 참조하세요.