View a markdown version of this page

Guía de configuración del agente - AWS CloudFormation

Guía de configuración del agente

Los agentes de codificación de inteligencia artificial pueden acelerar el desarrollo de la infraestructura al proporcionar asistencia inteligente para la creación de plantillas de CloudFormation, la validación previa a la implementación, la solución de problemas de implementación y la generación de código CDK. Al configurar su agente con la habilidad de CloudFormation y el servidor MCP de IaC de AWS, lo dota de la experiencia necesaria para crear y administrar la infraestructura como código en AWS.

Trabaje con su agente de codificación

Como referencia de inicio rápido, se puede colocar este enlace directamente en el contexto del agente:

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

Elija el método de instalación que se adapte a su entorno de desarrollo.

Requisitos previos

Asegúrese de que se encuentren implementados los siguientes requisitos previos:

  • uv instalado en el sistema.

  • Node.js (versión 18 o superior) instalado en su sistema (necesario para la instalación de habilidades).

  • (Opcional) Una cuenta de AWS con las credenciales de IAM configuradas en la máquina local. Se requieren credenciales para las herramientas que ejecutan llamadas a la API de AWS (validación de plantillas, solución de problemas de implementación), pero no para la búsqueda de documentación. Si no ha configurado las credenciales, consulte Configuración de la CLI de AWS para obtener instrucciones detalladas.

Lo que se instala

Componente Qué proporciona
Habilidad de CloudFormation Creación de plantillas con valores predeterminados seguros, canalización de validación de 3 capas (cfn-lint, cfn-guard, conjuntos de cambios) y diagnóstico de la causa raíz de las pilas con errores mediante eventos de CloudFormation y la correlación de CloudTrail.
AWSServidor MCP de IaC Búsqueda de documentación (CloudFormation y CDK), validación de plantillas, comprobaciones de conformidad, solución de problemas de implementación y prácticas recomendadas de CDK, y todo de forma local en su máquina.

Claude Code

Instale el complemento aws-core del kit de herramientas para agentes de AWS

Utilice el siguiente comando para instalar el complemento:

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

De este modo, las habilidades de agente se instalan en un solo paso, incluidas la habilidad CloudFormation de AWS, los enlaces de agente y la configuración del servidor MCP de AWS.

Instalación del servidor MCP de IaC de AWS

Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

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

Instalación de la habilidad de CloudFormation

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

Instalación del servidor MCP de IaC de AWS

Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

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

Cursor

Instalación de la habilidad de CloudFormation

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

Instalación del servidor MCP de IaC de AWS

Añada lo siguiente a .cursor/mcp.json en "mcpServers". Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

"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

Instalación de la habilidad de CloudFormation en la CLI de Kiro

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

Instalación del servidor MCP de IaC de AWS

Añada lo siguiente a ~/.kiro/settings/mcp.json en "mcpServers". Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

"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 }

Instale la capacidad de Kiro Pwers (desde IDE de Kiro)

Instale la siguiente capacidad de Kiro, que proporciona contextos y herramientas especializados a los agentes de Kiro bajo demanda:

Copiloto de GitHub

Instalación de la habilidad de CloudFormation

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

Instalación del servidor MCP de IaC de AWS

Añada lo siguiente a .vscode/mcp.json en "mcpServers". Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

"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

Instalación de la habilidad de CloudFormation

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

Instalación del servidor MCP de IaC de AWS

Añada lo siguiente a /.codeium/windsurf/mcp_config.json en "mcpServers". Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

"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

Instalación de la habilidad de CloudFormation

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

Instalación del servidor MCP de IaC de AWS

Añada lo siguiente a /.config/opencode/opencode.jsonc en "mcpServers". Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

"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" } }

Para todos los demás agentes, compatibles con las habilidades de los agentes y la configuración del servidor MCP

Para cualquier otro agente que admita el formato de habilidades de agente de código abierto y la configuración del servidor MCP, siga estos pasos:

Instalación de la habilidad de CloudFormation

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

Instalación del servidor MCP de IaC de AWS

Agregue el servidor MCP de IaC de AWS al archivo de configuración del cliente MCP de su agente, que se encuentra en "mcpServers". Sustituya AWS_PROFILE por el nombre de su perfil de AWS local.

"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" } }

Qué puede hacer con su agente

Una vez configurado, su agente puede ayudarlo con lo siguiente:

Tarea Mensaje de ejemplo
Creación de una plantilla “Crear una plantilla de CloudFormation de una VPC con subredes públicas y privadas”
Validación antes de implementar “Validar mi plantilla en ./template.yaml y verificación de problemas de seguridad”
Solución de problemas de un error “Mi pila ‘my-app’ en us-east-1 no se pudo implementar. ¿Qué ha pasado?”
Search documentation (Buscar documentación) “¿Qué propiedades admite AWS::ECS::Service?”
Guía de CDK “Mostrarme las prácticas recomendadas de codificación para las funciones de Lambda”
Comprobaciones de conformidad “Comprobar si mi plantilla cumple con las mejores prácticas de seguridad”

Permisos de IAM

El servidor MCP requiere los siguientes permisos de AWS para funcionar plenamente:

Para la validación y el cumplimiento de las plantillas: no se requieren permisos de AWS (solo para la validación local).

Para la solución de problemas de las implementaciones:

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