エージェントセットアップガイド

AI コーディングエージェントは、CloudFormation テンプレートの作成、デプロイ前検証、デプロイのトラブルシューティング、CDK コード生成にインテリジェントな支援を提供することで、インフラストラクチャ開発を加速できます。エージェントに CloudFormation スキルと AWS IaC MCP サーバーを設定することで、AWS で Infrastructure as Code を構築および管理するために必要な専門知識を取得できます。

コーディングエージェントを操作する

クイックスタートリファレンスでは、このリンクをエージェントのコンテキストに直接ドロップできます。

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/samples/aws-cloudformation-agent-setup.md

開発環境に一致するインストール方法を選択します。

前提条件

以下の前提条件が満たされていることを確認してください。

インストールされるもの

Claude Code

Agent Toolkit for AWS から aws-core プラグインをインストールする

プラグインをインストールするには、次のコマンドを実行します。

/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-core@agent-toolkit-for-aws

これにより、AWS CloudFormation スキル、エージェントフック、AWS MCP サーバー設定などのエージェントスキルが 1 つのステップでインストールされます。

AWS IaC MCP サーバーをインストールする

AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

claude mcp add awslabs-aws-iac-mcp \
  -e AWS_PROFILE=default \
  -e AWS_REGION=us-east-1 \
  -e FASTMCP_LOG_LEVEL=ERROR \
  --scope user \
  -- uvx awslabs.aws-iac-mcp-server@latest

Codex

CloudFormation スキルをインストールする

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

AWS IaC MCP サーバーをインストールする

AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

codex mcp add awslabs-aws-iac-mcp \
  --env AWS_PROFILE=default \
  --env AWS_REGION=us-east-1 \
  --env FASTMCP_LOG_LEVEL=ERROR \
  -- uvx awslabs.aws-iac-mcp-server@latest

カーソル

CloudFormation スキルをインストールする

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

AWS IaC MCP サーバーをインストールする

次のコードを "mcpServers" 内の .cursor/mcp.json に追加します。AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Kiro

Kiro CLI に CloudFormation スキルをインストールする

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

AWS IaC MCP サーバーをインストールする

次のコードを "mcpServers" 内の ~/.kiro/settings/mcp.json に追加します。AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  },
  "disabled": false
}

Kiro パワーをインストールする (Kiro IDE から)

Kiro エージェントにオンデマンドで特殊な CloudFormation コンテキストとツールを提供する次の Kiro パワーをインストールします。

GitHub コパイロット

CloudFormation スキルをインストールする

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

AWS IaC MCP サーバーをインストールする

次のコードを "mcpServers" 内の .vscode/mcp.json に追加します。AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Windsurf

CloudFormation スキルをインストールする

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

AWS IaC MCP サーバーをインストールする

次のコードを "mcpServers" 内の /.codeium/windsurf/mcp_config.json に追加します。AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

OpenCode

CloudFormation スキルをインストールする

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

AWS IaC MCP サーバーをインストールする

次のコードを "mcpServers" 内の /.config/opencode/opencode.jsonc に追加します。AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

エージェントスキルおよび MCP サーバー設定と互換性のある他のすべてのエージェントの場合

オープンソースのエージェントスキル形式と MCP サーバー設定をサポートする他のエージェントについては、次の手順に沿って操作します。

CloudFormation スキルをインストールする

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-cloudformation --yes --global

AWS IaC MCP サーバーをインストールする

"mcpServers" にあるエージェントの MCP クライアント設定ファイルに AWS IaC MCP サーバーを追加します。AWS_PROFILE をローカル AWS プロファイル名に置き換えます。

"awslabs.aws-iac-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-iac-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

エージェントでできること

設定が完了すると、エージェントは以下を支援します。

IAM アクセス許可

MCP サーバーの完全な機能を使用するには、次の AWS アクセス許可が必要です。

テンプレートの検証とコンプライアンスの場合: 必要な AWS アクセス許可はありません (ローカル検証のみ)。

デプロイのトラブルシューティングを行う場合:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:DescribeStacks",
        "cloudformation:DescribeStackEvents",
        "cloudformation:DescribeStackResources",
        "cloudtrail:LookupEvents"
      ],
      "Resource": "*"
    }
  ]
}

関連リソース