# Adicionar uma API REST do API Gateway como destino para o Amazon Bedrock AgentCore Gateway.
<a name="mcp-server"></a>

O Amazon Bedrock AgentCore Gateway oferece aos desenvolvedores de agentes de IA uma maneira segura de expor as APIs REST do API Gateway como ferramentas compatíveis com o protocolo de contexto para modelos (MCP). O AgentCore Gateway usa destinos para definir ferramentas. Quando você adiciona seu estágio como um destino, o gateway se torna um único URL do MCP que permite acesso às ferramentas de um agente. Para ter mais informações, consulte [Estágios da API REST do API Gateway como destinos](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-api-gateway.html) no *Guia do desenvolvedor do Amazon Bedrock AgentCore Gateway*.

Os destinos do API Gateway conectam o AgentCore Gateway aos estágios de suas APIs REST. É possível incluir o estágio inteiro como destino ou selecionar recursos. Depois de criar o destino do API Gateway, o AgentCore Gateway converte as solicitações do MCP recebidas em solicitações HTTP e processa a formatação da resposta. Os clientes MCP podem recuperar a documentação da API usando o método `tools/list` e invocar APIs usando o método `tools/call`.

## Considerações
<a name="w2aac15c11c11c34c11b7"></a>

As considerações a seguir podem impactar seu uso ao adicionar um estágio como destino a um AgentCore Gateway:
+ Você já deve ter criado um AgentCore Gateway.
+ Somente as APIs REST públicas são compatíveis.
+ Não é possível desabilitar o endpoint padrão para a API.
+ Cada método da API deve ter um [nome de operação](https://docs.aws.amazon.com/apigateway/latest/api/API_PutMethod.html#apigw-PutMethod-request-operationName) definido para ele ou será necessário criar uma substituição de nome ao adicionar seu estágio como destino. Esse nome é usado como o nome da ferramenta que os agentes usam para interagir com seu método.
+ Você pode usar os tipos de provedor de credenciais `API_KEY`, `NO_AUTH`, ou `GATEWAY_IAM_ROLE` como autenticação de saída para permitir que o gateway acesse a API. O provedor de credenciais `API_KEY` é definido pelo AgentCore Gateway. Você pode usar sua chave de API existente do API Gateway. Para ter mais informações, consulte [Configurar autenticação de saída](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-outbound-auth.html).
+ Se você usa um grupo de usuários do Amazon Cognito ou um autorizador do Lambda para controlar o acesso à API, os clientes MCP não poderão acessá-la.
+ A API deve estar na mesma conta e região do AgentCore Gateway.

## Adicionar um estágio de uma API como destino para um AgentCore Gateway
<a name="mcp-server-api-gateway"></a>

O procedimento a seguir mostra como adicionar um estágio de uma API como um destino para um AgentCore Gateway.

**Como adicionar um estágio de uma API como destino para um AgentCore Gateway**

1. Faça login no console do API Gateway em [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).

1. Escolha uma API REST que esteja implantada em um estágio.

1. No painel de navegação principal, selecione **Estágios**.

1. Escolha **Ações de estágio** e **Criar destino do MCP**.

1. Em **AgentCore Gateway**, selecione um AgentCore Gateway.

1. Em **Nome do destino**, insira um nome para o destino.

1. Em **Descrição do destino**, insira uma descrição.

1. Mantenha a API e o estágio fornecidos.

1. Em **Selecione os recursos da API**, escolha os recursos da API que os agentes que usam o AgentCore Gateway podem acessar.

   Se você não selecionar um recurso, o agente não poderá visualizar a documentação nem invocar o endpoint. 

1. A combinação do recurso e do método são as operações da ferramenta. Se a operação não tiver um nome, crie um nome de substituição.

   Você também pode definir um nome de operação para um método ao criá-lo.

1. Em **Configuração de autenticação de saída**, escolha **Perfil do IAM**, **Sem autorização** ou **Chave de API**.

1. Escolha **Criar destino**.

Para visualizar todos os AgentCore Gateways que têm acesso às suas APIs, escolha a seção **Destinos do MCP** no painel de navegação principal. Nessa seção, é possível criar um destino do MCP para qualquer API em sua região implantada em um estágio. Escolha **Criar destino do MCP** e siga as etapas anteriores.

Também é possível visualizar as ferramentas disponíveis para seu destino e editar o destino no console do AgentCore Gateway. Para ter mais informações, consulte [Adicionar destinos a um AgentCore Gateway existente](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html).