# Guía de configuración del agente
<a name="agent-setup-guide"></a>

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
<a name="agent-setup-work-with-agent"></a>

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
<a name="agent-setup-prerequisites"></a>

Asegúrese de que se encuentren implementados los siguientes requisitos previos:
+ [uv](https://docs.astral.sh/uv/) instalado en el sistema.
+ [Node.js](https://nodejs.org/) (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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) para obtener instrucciones detalladas.

## Lo que se instala
<a name="agent-setup-what-gets-installed"></a>


| 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
<a name="agent-setup-claude-code"></a>

### Instale el complemento aws-core del kit de herramientas para agentes de AWS
<a name="agent-setup-claude-code-plugin"></a>

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
<a name="agent-setup-claude-code-mcp"></a>

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
<a name="agent-setup-codex"></a>

### Instalación de la habilidad de CloudFormation
<a name="agent-setup-codex-skill"></a>

```
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 name="agent-setup-codex-mcp"></a>

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
<a name="agent-setup-cursor"></a>

### Instalación de la habilidad de CloudFormation
<a name="agent-setup-cursor-skill"></a>

```
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 name="agent-setup-cursor-mcp"></a>

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
<a name="agent-setup-kiro"></a>

### Instalación de la habilidad de CloudFormation en la CLI de Kiro
<a name="agent-setup-kiro-skill"></a>

```
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 name="agent-setup-kiro-mcp"></a>

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)
<a name="agent-setup-kiro-powers"></a>

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](https://kiro.dev/powers/aws-iac).

## Copiloto de GitHub
<a name="agent-setup-github-copilot"></a>

### Instalación de la habilidad de CloudFormation
<a name="agent-setup-github-copilot-skill"></a>

```
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 name="agent-setup-github-copilot-mcp"></a>

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
<a name="agent-setup-windsurf"></a>

### Instalación de la habilidad de CloudFormation
<a name="agent-setup-windsurf-skill"></a>

```
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 name="agent-setup-windsurf-mcp"></a>

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
<a name="agent-setup-opencode"></a>

### Instalación de la habilidad de CloudFormation
<a name="agent-setup-opencode-skill"></a>

```
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 name="agent-setup-opencode-mcp"></a>

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
<a name="agent-setup-other-agents"></a>

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
<a name="agent-setup-other-agents-skill"></a>

```
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 name="agent-setup-other-agents-mcp"></a>

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
<a name="agent-setup-what-you-can-do"></a>

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
<a name="agent-setup-iam-permissions"></a>

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": "*"
    }
  ]
}
```

## Recursos relacionados
<a name="agent-setup-related-resources"></a>
+ [Servidor MCP de IaC de AWS en GitHub](https://github.com/awslabs/mcp/tree/main/src/aws-iac-mcp-server)
+ [Kit de herramientas para agentes para AWS](https://github.com/aws/agent-toolkit-for-aws)
+ [Guía del usuario de CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/)
+ [Guía para desarrolladores de AWS](https://docs.aws.amazon.com/cdk/v2/guide/)
+ [Presentamos el servidor MCP de IaC de AWS (blog)](https://aws.amazon.com/blogs/devops/introducing-the-aws-infrastructure-as-code-mcp-server-ai-powered-cdk-and-cloudformation-assistance/)