翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Bedrock AgentCore Gateway
<a name="bedrock-agentcore-gateway"></a>

このドキュメントでは、Amazon Bedrock AgentCore Gateway と統合できる API ベースの AI エージェント製品またはツールを一覧表示したい AWS Marketplace 販売者向けの情報を提供します。

**Topics**
+ [概要:](#agentcore-overview)
+ [Bedrock AgentCore Gateway との統合](#bedrock-agentcore-integration)

## 概要:
<a name="agentcore-overview"></a>

Amazon Bedrock AgentCore Gateway は、開発者がツールを大規模に構築、デプロイ、検出、接続するのに役立ちます。このサービスでは、次のことが可能になります。
+ API、Lambda 関数、および既存のサービスをモデルコンテキストプロトコル (MCP) 互換ツールに変換する
+ Gateway エンドポイントを介してエージェントがツールを利用できるようにする
+ フルマネージドサービスで包括的な入出力認証を使用する

AI エージェントは、これらのツールを使用して次のようなタスクを実行します。
+ データベースのクエリ
+ メッセージの送信
+ ドキュメントの分析

詳細については、「[Amazon Bedrock AgentCore デベロッパーガイド](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html)」を参照してください。

## Bedrock AgentCore Gateway との統合
<a name="bedrock-agentcore-integration"></a>

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 サーバーの要件
<a name="gateway-mcp-server-requirements"></a>

MCP サーバーは以下の要件を満たしている必要があります。
+ 次のいずれかの設定による 2 レッグの OAuth 認証。
  + クライアント ID、クライアントシークレット、検出 URL
  + クライアント ID、クライアントシークレット、発行者、認可エンドポイント、トークンエンドポイント。
+ MCP サーバーにはツール機能が必要です。
+ サポートされている MCP プロトコルバージョン: **2025-06-18** および **2025-03-26**。
+ サーバーの指定された URL またはエンドポイントについては、URL をエンコードする必要があります。Gateway は同じ URL を使用してサーバーを呼び出します。

### OpenAPI 仕様要件
<a name="openapi-requirements"></a>

OpenAPI 仕様は次の条件を満たす必要があります。
+ すべてのオペレーションの `operationId` フィールドを含める
+ セマンティックエラーがない
+ サーバー属性に有効なセキュア (https) エンドポイント URL を含める

次の表は、サポートされている OpenAPI 機能とサポートされていない OpenAPI 機能を示しています。


| Category | サポート | サポート外 | 
| --- | --- | --- | 
| バージョン | 3.0 および 3.1 | 2 | 
| スキーマ定義 | 基本的なデータ型 (文字列、数値、ブール値など) | oneOf 仕様 | 
|  | 必須フィールドの検証 | anyOf 仕様 | 
|  | ネストされたオブジェクト |  | 
|  | アイテム仕様の配列 |  | 
|  | 標準の HTTP メソッド |  | 
| メディアタイプ | application/json | カスタムメディアタイプ | 
|  | application/xml | バイナリメディアタイプ | 
|  | マルチパート/フォームデータ |  | 
|  | x-www-form-urlencoded |  | 
| パラメータ | 単純なパスパラメータと、string/number/boolean 型などの基本的なクエリパラメータ | 複雑なパスパラメータのシリアル化 | 
|  |  | 複雑なクエリパラメータ配列 | 
|  |  | ヘッダーパラメータのシリアル化 | 
|  |  | Cookie パラメータのシリアル化 | 
| リクエストとレスポンス | JSON 本文 |  | 
|  | XML 本文 |  | 
|  | 標準 HTTP ステータスコード |  | 
| 検証 | 基本的なフィールド検証 | 正規表現パターンの検証 | 
|  |  | 最小/最大値の検証 | 
| セキュリティ | 該当なし | 仕様レベルでのセキュリティスキーム | 
|  |  | 複数のセキュリティスキーム | 
|  |  | 仕様レベルでの OAuth 2.0 | 
|  |  | 仕様レベルでの API キー | 
|  |  | 仕様レベルでの HTTP 基本認証 | 
| サーバー設定 | 基本 URL |  | 
|  | プレースホルダーを含む URL |  | 

### Bedrock AgentCore Gateway の有効化
<a name="enabling-bedrock-agentcore"></a>

Gateway 統合を有効にする前に、以下のタスクを実行して OpenAPI 仕様または MCP サーバーを Amazon Bedrock AgentCore Gateway でテストします。
+ [ゲートウェイを作成する](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)
+ [Gateway をテストする](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-testing.html)

**Gateway 統合を有効にするには**

1. [AWS Marketplace 管理ポータル](https://aws.amazon.com/marketplace/management)にサインインします。

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. [**Submit**] を選択してください。

送信すると、**[リクエスト]** タブにリクエストステータスが**レビュー中**として表示されます。処理が完了すると、ステータスは**成功**に変わります。