Prerequisiti e chiavi

“Non puoi cucinare finché gli ingredienti non sono sul piano di lavoro. Raccogli prima le chiavi, o ti bloccherai a metà del cablaggio.”

1. Una chiave API Anthropic (per la via automatizzata)

Dove: la Console Anthropic → API keys. A cosa serve: l'assemblaggio n8n chiama Claude tramite la Messages API, che richiede una chiave. Nota: l'assemblaggio MCP interattivo usa invece il tuo abbonamento Claude Desktop e non ha bisogno di una chiave API, quindi se esegui solo il Capitolo 3 puoi saltare questo passaggio. La documentazione dell'API ora vive su platform.claude.com (i vecchi URL docs.anthropic.com reindirizzano lì).

2. Una chiave API Brave Search

Dove: la dashboard della Brave Search API (api-dashboard.search.brave.com). A cosa serve: l'accesso al web dell'agente. Perché Brave: ha un piano gratuito usabile e una API JSON pulita. Il piano gratuito "Free" è documentato a 1 query al secondo e 2.000 query al mese, più che sufficiente per un brief mattutino. Una carta è richiesta per la verifica dell'identità ma non viene addebitata sul piano gratuito.

3. Un'istanza n8n (per la via automatizzata)

Dove: n8n Cloud, o self-hosted. A cosa serve: lo scheduler e l'orchestratore. Il modo più rapido per partire in locale è eseguirlo con npx; per qualcosa che resti attivo, usa Docker. L'interfaccia vive su http://localhost:5678.

# Quickest local trial, no install:
npx n8n
# UI at http://localhost:5678

# Stays up (recommended for a daily schedule):
docker run -it --rm --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="America/Toronto" \
  -e TZ="America/Toronto" \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Imposta il fuso orario adesso. Un brief mattutino che scatta all'ora sbagliata è l'errore più comune in assoluto qui: lo Schedule Trigger usa il fuso orario dell'istanza, quindi `GENERIC_TIMEZONE` (o l'impostazione del fuso orario di n8n Cloud) deve corrispondere a dove ti svegli.

4. Un vault Obsidian (o qualsiasi cartella)

Dove: ovunque viva il tuo vault sul disco, p. es. `/Users/you/ObsidianVault`. A cosa serve: la destinazione dell'output. Obsidian è solo file markdown in una cartella, ed è per questo che funziona: scrivere `2026-05-25 Brief.md` nella cartella del vault lo fa comparire in Obsidian senza alcuna integrazione. Decidi una sottocartella per i brief (p. es. `ObsidianVault/Briefings`) e annota il suo percorso assoluto: consegnerai all'agente esattamente quel percorso e nient'altro.

5. Node / npx (per i server MCP)

A cosa serve: i server MCP di Brave e Filesystem girano tramite `npx`, quindi ti serve un Node.js recente installato. Verifica con `node --version` e `npx --version`. È tutto ciò che serve per il Capitolo 3.