AWS ha aggiunto una nuova card alla console questa settimana: Agent Toolkit for AWS. È gratuito, generalmente disponibile e funziona con Claude Code, Codex, Cursor e Kiro. Un solo prompt di setup fornisce al tuo coding agent un server MCP per le API AWS, skill curate per i task più comuni e guardrail IAM. Il toolkit in sé è utile. Quello che ammette è più grande: il lettore principale della documentazione AWS non è più una persona.

Cosa c'è nella scatola

Tre livelli, e funzionano in modo indipendente l'uno dall'altro:

  • L'AWS MCP Server. Un endpoint hosted (aws-mcp.us-east-1.api.aws) che il tuo agente raggiunge tramite mcp-proxy-for-aws. Dà all'agente accesso alle API AWS, esecuzione di script in sandbox e ricerca nella documentazione in tempo reale. Le credenziali servono solo per le chiamate API; la ricerca nella documentazione funziona anche senza.
  • Plugin. aws-core copre la scelta dei servizi, CDK e CloudFormation, serverless, container, storage, observability e billing. aws-agents aggiunge le skill per Bedrock e AgentCore, aws-data-analytics e aws-agents-for-devsecops coprono i rispettivi domini. Su Claude Code si installano dal plugin marketplace ufficiale con un singolo /plugin install.
  • Skill. Istruzioni curate per i task, installate con npx skills add aws/agent-toolkit-for-aws/skills. Caricate on demand: l'agente richiama solo quelle che corrispondono al task corrente, quindi non costano nulla finché non vengono usate.

L'autenticazione passa dal nuovo flusso browser-based aws login, verificato con aws sts get-caller-identity. Se vivi nel terminale, aws configure agent-toolkit collega la stessa cosa attraverso la AWS CLI.

Il setup è un prompt, non uno script

Ecco il dettaglio su cui vale la pena fermarsi. La console non ti consegna uno script shell. Ti consegna una sola frase da incollare nel tuo agente:

Set up Agent Toolkit for AWS by following instructions:
https://raw.githubusercontent.com/aws/agent-toolkit-for-aws/refs/heads/main/setup-instructions/setup.md

Quell'URL è un file Markdown. Il tuo agente lo legge, rileva il tuo sistema operativo, installa la AWS CLI se manca, esegue aws login, configura il server MCP e installa le skill. Il documento è strutturato come un runbook per una macchina: passaggi numerati, tabelle di gestione degli errori, comandi di verifica dopo ogni fase. AWS ha scritto una guida di installazione il cui destinatario previsto non sei tu. Tu approvi solo i prompt di autorizzazione.

È questo il pattern da notare. Le istruzioni di installazione erano prosa per umani con blocchi di codice da copiare. Questo è codice per agenti con prosa che l'umano scorre una volta sola.

Nessuno legge più la documentazione, tranne gli agenti

Ammetto una cosa. Per anni la mia lettura del weekend non sono stati i gialli o la narrativa. Era la documentazione AWS: service quota, casi limite delle API, il changelog di qualche storage class di cui nessuno parla. Quella lettura ha costruito l'indice mentale che mi rendeva veloce, perché sapere dove vive la risposta era gran parte del lavoro.

Quell'indice ora è una commodity. Un agente con la ricerca nella documentazione legge la pagina attuale, non quella che ho memorizzato due anni fa, e la legge in pochi secondi. Il toolkit lo rende ufficiale: AWS mantiene ora una pipeline dedicata per dare in pasto la propria documentazione alle macchine, con "up-to-date documentation and tested procedures" come feature di punta. Il cliente più importante del team documentazione ha cambiato specie.

Quello che non diventa una commodity è il giudizio. Quale servizio è adatto, qual è il blast radius di una modifica, se il piano dell'agente sopravvive al contatto con le realtà del tuo account. Per questo la terza parola nel pitch di AWS è guardrail: un agente con credenziali funzionanti è un principal come qualsiasi altro, e riceve least privilege come qualsiasi altro. Due note pratiche su questo fronte:

  • Blocca la versione del proxy (stile mcp-proxy-for-aws@1.6.3). Lo raccomanda lo stesso README di AWS contro il rischio di supply chain, e hanno ragione.
  • Imposta il ruolo dell'agente in sola lettura di default e proteggi separatamente ogni percorso che modifica lo stato. I guardrail IAM del toolkit aiutano, ma la policy resta tua da scrivere.

In chiusura

L'era agentica dello sviluppo su AWS non è arrivata con un keynote. È arrivata come una piccola card nella console che offre un prompt di setup. AWS ora dà per scontato che il tuo primo collaboratore su qualsiasi progetto sia un agente, e pubblica documentazione, procedure e permission boundary costruiti per quel lettore. I miei weekend potrebbero finalmente avere spazio per un romanzo giallo. La documentazione è in buone mani, e il lavoro interessante, decidere cosa costruire e cosa un agente può toccare, è sempre stato la parte che comunque non si poteva indicizzare.

Leggi questo dopo