View a markdown version of this page

Guía de configuración del agente - AWS CloudFormation
Trabaje con su agente de codificaciónRequisitos previosLo que se instalaClaude CodeCodexCursorKiroGitHub CopilotWindsurfOpenCodePara todos los demás agentes, compatibles con las habilidades de los agentes y la configuración del servidor MCPQué puede hacer con su agentePermisos de IAMRecursos relacionados

Guía de configuración del agente

El kit de herramientas para agentes de AWS en GitHub proporciona el complemento aws-core y su habilidad agrupada aws-cloudformation. Esta habilidad ayuda a los agentes de codificación de IA a crear y validar plantillas de CloudFormation, solucionar problemas de implementaciones y generar código de AWS CDK. El complemento también configura el servidor MCP de AWS para la búsqueda de documentación y el acceso a la API de 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/agent-setup-guide.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 aws-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.
AWS Servidor 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.

Ejecute el siguiente comando para instalar el complemento desde el marketplace oficial de Claude Code:

/plugin install aws-core@claude-plugins-official

De este modo, se instalan en un solo paso la habilidad aws-cloudformation, otras habilidades principales de AWS, los enlaces de agentes 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 aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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:

GitHub Copilot

Instalación de la habilidad de CloudFormation

npx skills add aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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 aws/agent-toolkit-for-aws/skills --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": "*"
    }
  ]
}