AgentCore CLI 実践 — Gateway で外部MCPサーバーを接続する

1. agentcore create --no-agent    # エージェントなしでプロジェクト作成
2. agentcore add gateway          # Gateway を追加
3. agentcore add gateway-target   # ターゲットを追加
4. agentcore add agent            # エージェントを追加（Gateway 自動統合）
5. agentcore deploy               # デプロイ

agentcore create --name AgentCoreGwTest --no-agent --skip-git
cd AgentCoreGwTest

agentcore add gateway --name my-gateway --json

{"success": true, "gatewayName": "my-gateway"}

{
  "agentCoreGateways": [
    {
      "name": "my-gateway",
      "description": "Gateway for my-gateway",
      "targets": [],
      "authorizerType": "NONE",
      "enableSemanticSearch": true,
      "exceptionLevel": "NONE"
    }
  ]
}

agentcore add gateway-target \
  --type mcp-server \
  --name exa-search \
  --endpoint https://mcp.exa.ai/mcp \
  --gateway my-gateway \
  --json

{"success": true, "toolName": "exa-search"}

agentcore add agent \
  --name GwAgent \
  --framework Strands \
  --model-provider Bedrock \
  --language Python \
  --memory none \
  --json

{"success": true, "agentName": "GwAgent"}

import os
import logging
from mcp.client.streamable_http import streamablehttp_client
from strands.tools.mcp.mcp_client import MCPClient
 
logger = logging.getLogger(__name__)
 
 
def get_my_gateway_mcp_client() -> MCPClient | None:
    """Returns an MCP Client connected to the my-gateway gateway."""
    url = os.environ.get("AGENTCORE_GATEWAY_MY_GATEWAY_URL")
    if not url:
        logger.warning("AGENTCORE_GATEWAY_MY_GATEWAY_URL not set — my-gateway gateway tools unavailable")
        return None
    return MCPClient(lambda: streamablehttp_client(url))
 
def get_all_gateway_mcp_clients() -> list[MCPClient]:
    """Returns MCP clients for all configured gateways."""
    clients = []
    client = get_my_gateway_mcp_client()
    if client:
        clients.append(client)
    return clients

from mcp_client.client import get_all_gateway_mcp_clients
 
# ...
mcp_clients = get_all_gateway_mcp_clients()

ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
 
cat > agentcore/aws-targets.json << EOF
[
  {
    "name": "default",
    "description": "Tokyo (ap-northeast-1)",
    "account": "${ACCOUNT_ID}",
    "region": "ap-northeast-1"
  }
]
EOF

agentcore deploy -y

✓ Deployed to 'default' (stack: AgentCore-AgentCoreGwTest-default)
 
Outputs:
  McpGatewayMyGatewayUrlOutput: https://agentcoregwtest-my-gateway-XXXXXXXXXX.gateway.bedrock-agentcore.ap-northeast-1.amazonaws.com/mcp

agentcore status --json

{
  "success": true,
  "projectName": "AgentCoreGwTest",
  "targetName": "default",
  "targetRegion": "ap-northeast-1",
  "resources": [
    {
      "resourceType": "agent",
      "name": "GwAgent",
      "deploymentState": "deployed",
      "detail": "READY"
    },
    {
      "resourceType": "gateway",
      "name": "my-gateway",
      "deploymentState": "local-only",
      "detail": "1 target"
    }
  ]
}

agentcore invoke \
  "Search the web for 'AgentCore CLI latest version' and tell me what you find." \
  --stream \
  --agent GwAgent

Based on my web search, I found information about two different "AgentCore CLI" tools:
 
## 1. AWS AgentCore CLI (Primary Result)
 
**Latest Version:** v0.3.0-preview.5.1 (Released March 12, 2026)
- **Status:** Preview/Prerelease
- **Repository:** https://github.com/aws/agentcore-cli
- **Language:** TypeScript (97.3%)
- **License:** Apache License 2.0
 
This is the official CLI for Amazon Bedrock AgentCore, which helps developers
create, develop locally, and deploy AI agents to AWS.

AGENTCORE_GATEWAY_MY_GATEWAY_URL=https://{gateway-id}.gateway.agentcore.{region}.amazonaws.com
AGENTCORE_GATEWAY_MY_GATEWAY_AUTH_TYPE=NONE

# プロジェクト内のリソース定義をすべて削除
agentcore remove all --force
 
# AWS リソースを削除
agentcore deploy -y
 
# CLI のアンインストール（不要な場合）
npm uninstall -g @aws/agentcore