Kit de Ferramentas de Agentes para AWS na Prática (1) - Claude Code

Parte 1 da série "Kit de Ferramentas do Agente para AWS na Prática."

O Kit de Ferramentas do Agente para AWS oferece ao seu agente de codificação duas coisas que normalmente faltam: conhecimento curado de como os serviços da AWS devem ser usados e uma maneira de realmente chamá-los. A configuração é um comando.

Este guia aborda a instalação, duas tarefas de verificação contra uma conta real e três coisas que vale a pena saber antes de confiar nele. Cada comando e saída abaixo é de uma execução real no macOS com Claude Code.

O que você está instalando

Duas peças independentes. Saber qual é qual economiza tempo quando algo não funciona corretamente.

Eles funcionam de forma independente. As habilidades não requerem o servidor MCP, e o servidor MCP não serve suas habilidades instaladas localmente.

Uma habilidade é um diretório com um SKILL.md e frequentemente uma pasta references/:

aws-storage/
├── SKILL.md
├── .aws-skill-metadata      # {"version": "v1"}
└── references/
    ├── s3-general-purpose-knowledge.md
    ├── ebs-knowledge.md
    └── ...

A parte frontal do description é o que o agente usa para decidir se uma habilidade se aplica — e explica para o que a habilidade não serve, o que impede que habilidades irrelevantes sejam carregadas:

---
name: aws-storage
description: >-
  Seleciona, investiga e compara serviços de armazenamento de objetos, arquivos e blocos da AWS
  ... Não aplicável para mecanismos de consulta SQL (Athena, Spark, Redshift,
  EMR), ETL (Glue), streaming (Kafka, MSK, Kinesis) ou serviços de banco de dados gerenciados
  (RDS, Aurora, DynamoDB).
version: 1
---

O corpo contém regras comportamentais. Uma do aws-storage explica por que o kit de ferramentas vale a pena: ele exige que o agente verifique os números atuais em vez de se lembrar deles, cite a página de preços para qualquer reivindicação de custo e nomeie um valor que não conseguiu verificar em vez de adivinhar. Isso se emparelha diretamente com as ferramentas de documentação do servidor MCP — a habilidade exige verificação, o servidor fornece os meios.

As habilidades são de código aberto em aws/agent-toolkit-for-aws (Apache-2.0), então você pode lê-las antes de instalar.

Pré-requisitos

aws --version    # precisa de 2.35.0 ou superior
uv --version     # necessário — o proxy MCP funciona através do uvx
node --version   # v22+ para Claude Code

uv é fácil de esquecer. Nada na saída da configuração menciona isso, mas o servidor MCP não se conectará sem ele. Veja o guia de instalação do uv.

Se seu AWS CLI for mais antigo que 2.35, atualize reinstalando o pacote — não há autoatualização:

curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
sudo installer -pkg AWSCLIV2.pkg -target /
rm AWSCLIV2.pkg

aws --version
# aws-cli/2.36.40 Python/3.14.6 Darwin/25.6.0 exe/arm64

Instalação

aws configure agent-toolkit --region us-east-1

Por que a flag de região? O Kit de Ferramentas do Agente é servido apenas de us-east-1. Exemplos oficiais a omitem, o que funciona se essa já for sua padrão. O meu é us-west-2, e sem a flag o assistente completa a detecção do agente e a tela de seleção, depois falha na busca:

Buscando habilidades padrão da AWS...
aws: [ERRO]: AgentToolkit está disponível apenas em us-east-1

Verifique aws configure get region primeiro.

O assistente detecta agentes instalados, oferece uma lista de verificação (tudo selecionado por padrão), instala habilidades e configura a conexão do servidor MCP:

Detectando agentes de codificação AI instalados...
  ✓ Claude Code — ~/.claude/skills
  ✓ Codex — ~/.agents/skills/
  ✓ Cursor — ~/.cursor/skills
  ✓ Kiro — ~/.kiro/skills

Instalar 23 habilidades padrão da AWS? [Y/n]: Y
Configurar conexão do servidor MCP da AWS? [Y/n]: Y

Reinicie seu agente depois para pegar a configuração — se Claude Code já estiver aberto, saia com /exit e inicie-o novamente.

O que você obteve

ls -1 ~/.claude/skills | wc -l
# 23

Esses 23 são da categoria aws-core do catálogo — cobrindo IaC, serviços principais, bancos de dados, redes, armazenamento, segurança, observabilidade, mensagens, SDKs e gerenciamento de custos. Eles são instalados como uma cópia completa por agente, não links simbólicos.

O catálogo contém mais, com granularidade mais fina, que você adiciona por conta própria:

aws agent-toolkit search-skills --search-query "dynamodb" --region us-east-1

Isso revela habilidades de serviço único como amazon-dynamodb — enumeração de padrões de acesso, seleção de chave de partição e GSI, decisões de tabela única versus múltipla, estimativa de custo — muito além do que o aws-database de nível de domínio cobre.

Verifique se funciona

Caminho de leitura: consulte sua fatura

Inicie o Claude Code a partir do diretório em que deseja trabalhar:

claude

Na primeira execução em um projeto, ele pede que você habilite o servidor MCP. Pressione Enter para aceitar — pressionar Esc rejeita, e o servidor permanece silenciosamente desativado sem mais solicitações.

Uma vez que você esteja no prompt, verifique a conexão digitando:

/mcp

aws-mcp · ✔ conectado · 8 ferramentas

Isso é sucesso. Agora peça algo real: