Gateway エンドポイントのカスタムドメイン名の設定

デフォルトでは、ゲートウェイエンドポイントには 形式の AWSマネージドドメイン名が提供されます<gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com。本番稼働環境や、よりユーザーフレンドリなエクスペリエンスを作成するには、ゲートウェイエンドポイントにカスタムドメイン名を使用することをお勧めします。このセクションでは、Amazon CloudFront をリバースプロキシとして使用してカスタムドメイン名を設定する方法について説明します。

前提条件

開始する前に、以下があることを確認してください。

ソリューションの概要

このソリューションには、次のコンポーネントが必要です。

次の手順では、 AWS CDK を使用してこれらのコンポーネントを設定する方法について説明します。

実装手順

ステップ 1: Route 53 ホストゾーンを作成する

まず、カスタムドメインの Route 53 ホストゾーンを作成します。

import { RemovalPolicy } from 'aws-cdk-lib';
import { PublicHostedZone } from 'aws-cdk-lib/aws-route53';

const domainName = 'my.example.com';

const hostedZone = new PublicHostedZone(this, 'HostedZone', {
    zoneName: domainName,
});
this.hostedZone.applyRemovalPolicy(RemovalPolicy.RETAIN);

ステップ 2: DNS 検証済み証明書を作成する

次に、DNS 検証で AWS Certificate Manager (ACM) を使用して、カスタムドメインの SSL/TLS 証明書を作成します。

import { RemovalPolicy } from 'aws-cdk-lib';
import { Certificate, CertificateValidation } from 'aws-cdk-lib/aws-certificatemanager';

const certificate = new Certificate(this, 'SSLCertificate', {
    domainName: domainName, // route53 hosted zone domain name from step 1
    validation: CertificateValidation.fromDns(hostedZone), // route53 hosted zone from step 1
});
this.certificate.applyRemovalPolicy(RemovalPolicy.RETAIN);

DNS 検証は、Route 53 ホストゾーンに必要な検証レコードを自動的に作成します。

ステップ 3: CloudFront ディストリビューションを作成する

ゲートウェイエンドポイントのリバースプロキシとして機能する CloudFront ディストリビューションを作成します。

import {
  AllowedMethods,
  CachePolicy,
  Distribution,
  OriginProtocolPolicy,
  ViewerProtocolPolicy
} from 'aws-cdk-lib/aws-cloudfront';
import { HttpOrigin } from 'aws-cdk-lib/aws-cloudfront-origins';

const bedrockAgentCoreGatewayHostName = '<mymcpserver>.gateway.bedrock-agentcore.<region>.amazonaws.com'
const bedrockAgentCoreGatewayPath = '/mcp' // can also be left undefined, depending on your requirement

const distribution = new Distribution(this, 'Distribution', {
    defaultBehavior: {
        origin: new HttpOrigin(bedrockAgentCoreGatewayHostName, {
            protocolPolicy: OriginProtocolPolicy.HTTPS_ONLY,
            originPath: bedrockAgentCoreGatewayPath,
        }),
        viewerProtocolPolicy: ViewerProtocolPolicy.HTTPS_ONLY,
        cachePolicy: CachePolicy.CACHING_DISABLED, // important since caching is enabled by default and hence is not suitable for a reverse proxy
        allowedMethods: AllowedMethods.ALLOW_ALL,
    },
    domainNames: [domainName], // route53 hosted zone domain name from step 1
    certificate: certificate, // ssl certificate for the route53 domain from step 2
});

をゲートウェイ ID <mymcpserver>に、 を AWS リージョン (例: ) us-east-1 <region>に置き換えます。

ステップ 4: Route 53 A レコードを作成する

カスタムドメインを CloudFront ディストリビューションにポイントする Route 53 A レコードを作成します。

import { ARecord, RecordTarget } from 'aws-cdk-lib/aws-route53';
import { CloudFrontTarget } from 'aws-cdk-lib/aws-route53-targets';

const aRecord = new ARecord(this, 'AliasRecord', {
    zone: hostedZone, // route53 hosted zone from step 1
    recordName: domainName, // route53 hosted zone domain name from step 1
    target: RecordTarget.fromAlias(new CloudFrontTarget(distribution)), // cloudfront distribution from step 3
});

これにより、カスタムドメインを CloudFront ディストリビューションにマッピングするエイリアスレコードが作成されます。

ステップ 5: インフラストラクチャをデプロイする

CDK スタックをデプロイしてリソースを作成します。

cdk deploy

デプロイプロセス、特に証明書の検証と CloudFront ディストリビューションの作成には時間がかかる場合があります。

カスタムドメインのテスト

インフラストラクチャをデプロイしたら、カスタムドメインが正しく設定されていることを確認します。

DNS 解決の検証

dig コマンドを使用して、カスタムドメインが CloudFront ディストリビューションに解決されることを確認します。

dig my.example.com

出力には、ドメインが CloudFront の IP アドレスに解決されたことが示されます。

SSL 証明書の検証

を使用してcurl、SSL 証明書が正しく設定されていることを確認します。

curl -v https://my.example.com

出力には、証明書エラーなしで成功した SSL ハンドシェイクが表示されます。

MCP クライアントの設定

カスタムドメインを設定して検証したら、それを使用するように MCP クライアントを設定できます。

カーソル設定

カーソルの場合は、設定ファイルを更新します。

{
  "mcpServers": {
    "my-mcp-server": {
      "url": "https://my.example.com"
    }
  }
}

その他の MCP クライアント

ストリーミング可能な HTTP をネイティブにサポートしていない MCP クライアントの場合:

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "/path/to/uvx",
        "args": [
            "mcp-proxy",
            "--transport",
            "streamablehttp",
            "https://my.example.com"
        ]
    }
  }
}

その他の考慮事項

トラブルシューティング

結論

Gateway エンドポイントのカスタムドメイン名を設定すると、アプリケーションのプロフェッショナルな外観が向上し、API エンドポイントを柔軟に管理できます。このガイドで説明されているステップに従うことで、CloudFront をリバースプロキシとして使用して、安全で信頼性の高いカスタムドメイン設定を作成できます。

Gateway の機能と機能の詳細については、「Amazon Bedrock AgentCore Gateway: ツールやその他のリソースを Gateway に安全に接続する」を参照してください。