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:
-
CloudFormation y CDK: se instalan mediante el enlace de capacidad de Kiro
.
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": "*" } ] }