View a markdown version of this page

Guide de configuration de l'agent - AWS CloudFormation
Travaillez avec votre agent de codageConditions préalablesQu'est-ce qui est installéClaude CodeCodexCurseurKiroGitHub CopiloteWindsurfOpenCodePour tous les autres agents compatibles avec les compétences des agents et la configuration du serveur MCPCe que vous pouvez faire avec votre agentAutorisations IAMRessources connexes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Guide de configuration de l'agent

L'Agent Toolkit for AWS on GitHub fournit le aws-core plugin et ses aws-cloudformation compétences groupées. Cette compétence aide les agents de codage IA à créer et à valider des CloudFormation modèles, à résoudre les problèmes liés aux déploiements et à générer AWS CDK du code. Le plugin configure également le serveur AWS MCP pour la recherche de documentation et l'accès à AWS l'API.

Travaillez avec votre agent de codage

Pour une référence rapide, vous pouvez insérer ce lien directement dans le contexte de votre agent :

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

Choisissez la méthode d'installation qui correspond à votre environnement de développement.

Conditions préalables

Assurez-vous que les prérequis suivants sont en place :

  • UV installé sur votre système.

  • Node.js(v18+) installé sur votre système (requis pour l'installation de Skills).

  • (Facultatif) Un AWS compte avec des informations d'identification IAM configuré sur votre machine locale. Les informations d'identification sont requises pour les outils qui exécutent des appels d' AWS API (validation des modèles, résolution des problèmes de déploiement), mais pas pour la recherche de documentation. Si vous n'avez pas configuré d'informations d'identification, consultez Configuration de l' AWS interface de ligne de commande pour obtenir des instructions détaillées.

Qu'est-ce qui est installé

Composant Ce qu'il fournit
aws-cloudformationcompétence Création de modèles avec des valeurs par défaut sécurisées, un pipeline de validation à 3 couches (cfn-lint, cfn-guard, change sets) et un diagnostic des causes premières des piles défaillantes à l'aide d'événements et de corrélations. CloudFormation CloudTrail
AWS Serveur IaC MCP Recherche de documentation (CloudFormation et CDK), validation de modèles, contrôles de conformité, résolution des problèmes de déploiement et meilleures pratiques du CDK, le tout s'exécutant localement sur votre machine.

Claude Code

Installez le plugin aws-core

Exécutez la commande suivante pour installer le plugin depuis la place de marché officielle de Claude Code :

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

Cela permet d'installer la aws-cloudformation compétence, les autres AWS compétences de base, les hooks d'agent et la configuration du serveur AWS MCP en une seule étape.

Installation AWS Serveur IaC MCP

AWS_PROFILERemplacez-le par le nom AWS de votre profil 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

Installer la CloudFormation compétence

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Installation AWS Serveur IaC MCP

AWS_PROFILERemplacez-le par le nom AWS de votre profil 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

Curseur

Installer la CloudFormation compétence

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Installation AWS Serveur IaC MCP

Ajoutez ce qui suit .cursor/mcp.json ci-dessous"mcpServers". AWS_PROFILERemplacez-le par le nom AWS de votre profil 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

Installer la CloudFormation compétence dans la CLI Kiro

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Installation AWS Serveur IaC MCP

Ajoutez ce qui suit ~/.kiro/settings/mcp.json ci-dessous"mcpServers". AWS_PROFILERemplacez-le par le nom AWS de votre profil 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
}

Installation des pouvoirs Kiro (depuis Kiro IDE)

Installez la puissance Kiro suivante qui fournit un CloudFormation contexte et des outils spécialisés aux agents Kiro à la demande :

GitHub Copilote

Installer la CloudFormation compétence

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Installation AWS Serveur IaC MCP

Ajoutez ce qui suit .vscode/mcp.json ci-dessous"mcpServers". AWS_PROFILERemplacez-le par le nom AWS de votre profil 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

Installer la CloudFormation compétence

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Installation AWS Serveur IaC MCP

Ajoutez ce qui suit /.codeium/windsurf/mcp_config.json ci-dessous"mcpServers". AWS_PROFILERemplacez-le par le nom AWS de votre profil 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

Installer la CloudFormation compétence

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Installation AWS Serveur IaC MCP

Ajoutez ce qui suit /.config/opencode/opencode.jsonc ci-dessous"mcpServers". AWS_PROFILERemplacez-le par le nom AWS de votre profil 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"
  }
}

Pour tous les autres agents compatibles avec les compétences des agents et la configuration du serveur MCP

Pour tout autre agent prenant en charge le format open source de compétences d'agent et la configuration du serveur MCP, procédez comme suit :

Installer la CloudFormation compétence

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-cloudformation --yes --global

Installation AWS Serveur IaC MCP

Ajoutez le serveur AWS IaC MCP au fichier de configuration du client MCP de votre agent sous. "mcpServers" AWS_PROFILERemplacez-le par le nom AWS de votre profil 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"
  }
}

Ce que vous pouvez faire avec votre agent

Une fois configuré, votre agent peut vous aider à :

Sous-tâche Exemple d’invite
Créez un modèle « Créer un CloudFormation modèle pour un VPC avec des sous-réseaux publics et privés »
Validez avant le déploiement « Validez mon modèle sur. /template.yaml et vérifiez s'il y a des problèmes de sécurité »
Résoudre une panne « Ma pile « my-app » dans us-east-1 n'a pas pu être déployée. Que s'est-il passé ? »
Rechercher dans la documentation « Quelles sont les propriétés prises en charge par AWS : :ECS : :Service ? »
Conseils sur le CDK « Montrez-moi les meilleures pratiques du CDK pour les fonctions Lambda »
Contrôles de conformité « Vérifier si mon modèle est conforme aux meilleures pratiques de sécurité »

Autorisations IAM

Le serveur MCP nécessite les AWS autorisations suivantes pour bénéficier de toutes ses fonctionnalités :

Pour la validation et la conformité des modèles : aucune AWS autorisation n'est requise (validation locale uniquement).

Pour résoudre les problèmes liés au déploiement : 

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