本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 新增 API Gateway REST API 做為 Amazon Bedrock AgentCore Gateway 的目標
<a name="mcp-server"></a>

Amazon Bedrock AgentCore Gateway 為 AI 代理程式開發人員提供了一種安全的方式，將您的 API Gateway REST APIs 公開為模型內容協定 (MCP) 相容工具。AgentCore 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 APIs的階段。您可以包含整個階段做為目標，或選取資源。建立 API Gateway 目標之後，AgentCore Gateway 會將傳入的 MCP 請求轉譯為 HTTP 請求，並處理回應格式。MCP 用戶端可以使用 `tools/list`方法擷取 API 文件，並使用 `tools/call`方法叫用 APIs。

## 考量事項
<a name="w2aac15c11c11c34c11b7"></a>

下列考量事項可能會影響您使用將階段新增為 AgentCore Gateway 的目標：
+ 您必須已經有 AgentCore Gateway。
+ 僅支援公有 REST APIs。
+ 無法停用 API 的預設端點。
+ API 的每個方法都必須有為其定義的[操作名稱](https://docs.aws.amazon.com/apigateway/latest/api/API_PutMethod.html#apigw-PutMethod-request-operationName)，或者當您將階段新增為目標時，需要建立名稱覆寫。此名稱用作代理程式用來與您的 方法互動的工具名稱。
+ 您可以使用傳出身分驗證的 `NO_AUTH`、 `API_KEY`或 `GATEWAY_IAM_ROLE`登入資料提供者類型，以允許閘道存取您的 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. 在以下網址登入 API Gateway 主控台：[https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway)。

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 目標**區段。 APIs 在本節中，您可以為部署到階段的區域中的任何 API 建立 MCP 目標。選擇**建立 MCP 目標**，然後遵循先前的步驟。

您也可以在 AgentCore Gateway 主控台中檢視目標的可用工具，並編輯目標。如需詳細資訊，請參閱[將目標新增至現有的 AgentCore Gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html)。