AgentCore 上の MCP サーバーにおける2つのデプロイモードを実証するエンドツーエンドの概念実証:
スタンドアロン — Cognito JWT 認証を直接使用するランタイム（ゲートウェイなし）
ゲートウェイ — Cognito PKCE インバウンド認証と IAM アウトバウンド認証を備えた AgentCore Gateway の背後にあるランタイム
どちらのモードもパブリック Cognito クライアント（client_secret なし）を PKCE によるユーザー認証に使用します。
Claude Code / Kiro
│ PKCE → Cognito Hosted UI → browser
│ Bearer JWT
▼
AgentCore Runtime (CUSTOM_JWT validates token)
│
▼
MCP Server (FastMCP, Python)Claude Code / Kiro
│ PKCE → Cognito Hosted UI → browser
│ Bearer JWT
▼
AgentCore Gateway (CUSTOM_JWT validates token)
│ SigV4 (gateway IAM role)
▼
AgentCore Runtime (AWS_IAM auth)
│
▼
MCP Server (FastMCP, Python)ゲートウェイモードでは以下を提供します:
集中認証（ゲートウェイがすべての JWT 検証を処理）
複数ターゲットにわたるツール検出とセマンティック検索
プロトコルレベルの MCP ルーティング
関心の分離（ランタイムはユーザー認証を認識する必要がない）
Related MCP server: local-kms-mcp-server
.
├── server/
│ ├── cognitopocmcp/ # Runtime deployed via agentcore CLI
│ │ ├── app/cognito_poc_mcp/
│ │ │ └── main.py # FastMCP server with sample tools
│ │ └── agentcore/ # agentcore CLI config
│ ├── mcp_server.py # MCP server source (standalone mode)
│ └── requirements.txt
├── src/
│ ├── config.mjs # Shared config (project name, region, helpers)
│ ├── auth.mjs # PKCE auth module (no secrets!)
│ ├── mcp-server.mjs # Stdio MCP server (proxy mode)
│ └── test-auth.mjs # Standalone auth flow test
├── scripts/
│ ├── setup-cognito.mjs # Creates Cognito pool + public client + user
│ ├── deploy.sh # Deploys runtime (standalone mode, with JWT auth)
│ ├── deploy-infrastructure.mjs # Creates gateway + IAM role + target (gateway mode)
│ ├── test-gateway.mjs # Tests gateway end-to-end
│ ├── test-deployed.mjs # Tests standalone runtime end-to-end
│ └── teardown-cognito.mjs # Deletes all infrastructure
├── .env # Generated by setup (Cognito config)
├── .mcp.json # Generated by deploy-infra (gateway URL + OAuth)
├── claude-mcp-config.json # Same as .mcp.json (for copying to Claude/Kiro)
└── package.json# AWS CLI + credentials configured
aws sts get-caller-identity
# Node.js 20+
node --version
# AgentCore CLI
npm install -g @aws/agentcore
# Python 3.10+ (for the MCP server)
python3 --versionnpm installnpm run setupシークレットなしのパブリックアプリクライアント、ホスト型 UI、テストユーザー（testuser / TestPass123!）を備えた Cognito ユーザープールを作成します。設定は .env に保存されます。
npm run deploy-runtimeagentcore CLI を使用して MCP サーバーを AgentCore Runtime にデプロイします。ランタイムはデフォルトの IAM 認証を使用します（ゲートウェイがユーザーを認証します）。
npm run deploy-infra以下を作成します:
ゲートウェイ用の IAM ロール（ランタイムを呼び出す権限を持つ）
CUSTOM_JWT インバウンド認証を備えた AgentCore Gateway（Cognito PKCE）
GATEWAY_IAM_ROLE（SigV4）を介してランタイムを指すゲートウェイターゲット
.mcp.json と claude-mcp-config.json をゲートウェイ URL で更新します。
npm run test-gatewayテストユーザーを使用して Cognito 経由で非対話的に認証し、以下を確認します:
未認証リクエストが拒否されること（401）
MCP セッションの初期化
検出されたツールの一覧表示
ツールの呼び出し（greet_user、add_numbers、get_server_info）
生成された設定をコピーします:
# For Kiro — .mcp.json is already in the project root
# For Claude Code
cp claude-mcp-config.json ~/.claude/mcp.json設定は次のようになります:
{
"mcpServers": {
"cognito-poc": {
"type": "http",
"url": "https://<gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com/mcp",
"oauth": {
"clientId": "<public-client-id>",
"callbackPort": 8976
}
}
}
}最初のツール呼び出し時に、Claude/Kiro は Cognito ログイン用のブラウザを開きます。その後、トークンはキャッシュされ、自動的に更新されます。
ゲートウェイが不要で、ランタイムに JWT 認証を直接処理させたい場合:
npm run setup # Create Cognito pool
npm run deploy # Deploy runtime with CUSTOM_JWT auth
npm run test-deployed # Test via PKCE (opens browser)スクリプト | 説明 |
| Cognito ユーザープール + パブリッククライアント + テストユーザーを作成 |
| agentcore CLI を使用して MCP ランタイムをデプロイ（IAM 認証、ゲートウェイ用） |
| Control Plane API を使用してゲートウェイ + IAM ロール + ターゲットを作成 |
| 直接 JWT 認証でランタイムをデプロイ（スタンドアロン、ゲートウェイなし） |
| ゲートウェイをエンドツーエンドでテスト（非対話型） |
| ブラウザベースの PKCE ログインでゲートウェイをテスト |
| デプロイ済みランタイムを PKCE でテスト |
| PKCE 認証フローのみをテスト（ブラウザを開く） |
| MCP サーバーをローカルで開発実行 |
| すべてのインフラストラクチャを削除（ゲートウェイ、IAM ロール、Cognito ユーザープール） |
サンプル MCP サーバーは以下を公開します:
ツール | 説明 |
| 2つの数値を加算します |
| 2つの数値を乗算します |
| 名前でユーザーに挨拶します |
| デプロイ情報とバージョン情報を返します |
| テキストを分析し基本統計を返します |
ゲートウェイ経由でアクセスする場合、ツール名にはターゲット名がプレフィックスとして付きます: mcp-runtime___add_numbers。
npm run teardownこれにより以下が削除されます:
AgentCore Gateway（ターゲット + ゲートウェイ）
ゲートウェイ IAM ロール
Cognito ユーザープール
ローカルファイル（.env、.mcp.json、claude-mcp-config.json）
AgentCore Runtime は削除されません（agentcore CLI で個別に管理）。削除するには:
cd server/cognitopocmcp && agentcore destroyCognito パブリッククライアント: GenerateSecret: false — クライアントシークレットは存在しません
PKCE（code_challenge + code_verifier）が共有シークレットなしでリクエスターを証明します
client_id のみがローカルに保存されます（公開識別子であり、資格情報ではありません）
トークンはメモリ内に保持され、1時間の有効期限と自動更新が設定されます
ゲートウェイは独自の IAM ロール（SigV4）を使用してランタイムに対して認証します。これにより、ゲートウェイとランタイム間の OAuth マシン間フローの複雑さが回避されます。IAM ロールには、ランタイム ARN にスコープされた bedrock-agentcore:* 権限があります。
すべての環境固有の値は実行時に導出されます:
AWS アカウント ID: STS.GetCallerIdentity で解決
ゲートウェイ URL: .mcp.json から読み取り（deploy-infra で生成）
ランタイム ARN: agentcore のデプロイ状態から読み取り
プロジェクト定数: src/config.mjs に集中管理
別のアカウント/リージョンにデプロイするには、AWS 認証情報を設定してセットアップ手順を再実行するだけです。
セキュリティ問題の報告については、CONTRIBUTING を参照してください。
このライブラリは MIT-0 ライセンスの下でライセンスされています。LICENSE ファイルを参照してください。
This server cannot be deployed
Self-hosted federated MCP gateway: one OAuth 2.1 MCP server in front of N apps, user-level scopes.
Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
MCP-first control plane for ProAgentStore agents and private instances.
The Stytch MCP server is a reference implementation that demonstrates remote MCP server authentication and authorization using Stytch Connected Apps. It provides OAuth 2.1-compliant authorization (including PKCE), Dynamic Client Registration, and validates Stytch-issued access tokens to enable AI agents to securely interact with external services through permissioned access, supporting scopes like openid, email, profile, and manage:project_data.
