Come abbiamo costruito un agente di changelog settimanale con Quire MCP e Claude Managed Agents

Ultimo aggiornamento: 25 maggio 2026

TL;DR: abbiamo sostituito la nostra riunione di riepilogo del lunedì con un Claude Managed Agent che legge il nostro progetto Quire Dev_Changelog tramite Quire MCP, raggruppa il lavoro completato negli ultimi sette giorni per etichetta e scrive un brief settimanale leggibile dal cliente come nuovo documento Quire. Il runtime è sotto i 30 secondi su Haiku 4.5. La vittoria meno ovvia è stata un filtraggio aggressivo degli strumenti, che ha ridotto i token di input per esecuzione da circa 82.000 a circa 12.000 e ha mantenuto il job entro i rate limit del Tier 1 senza un upgrade dell'API.

È lunedì, 9:04. Qualcuno nel canale del team chiede: "Ehi, riassunto veloce di cosa è stato rilasciato la settimana scorsa?" Tre persone aprono le loro schede, scorrono la bacheca Kanban, provano a ricordare quali delle quaranta attività chiuse fossero davvero significative e tornano venti minuti dopo con due bullet e un'alzata di spalle. La riunione di riepilogo che doveva durare dieci minuti ne dura quaranta. Entro martedì tutti hanno già dimenticato cosa c'era dentro.

Abbiamo sostituito quel ciclo. Abbiamo costruito un agente su Quire MCP e Claude Managed Agents che legge il nostro progetto Dev_Changelog ogni lunedì mattina, trova tutto ciò che è stato completato negli ultimi sette giorni, lo raggruppa per team, traduce il gergo da sviluppatore in qualcosa che un cliente possa leggere e scrive l'intero brief in un nuovo documento Quire. Tempo di esecuzione totale: meno di trenta secondi. Manutenzione continuativa totale: zero.

Questo post è la build completa, incluse le tre cose che si sono rotte lungo la strada e come le abbiamo sistemate. Se hai mai voluto un agente AI che svolga lavoro reale sui dati del tuo progetto invece di limitarsi a chiacchierarne, questa è una ricetta funzionante.

Cosa produce davvero l'agente

Ogni lunedì alle 9 del mattino Pacific, una sessione Claude si sveglia, interroga Quire e crea un nuovo documento nel nostro progetto Dev_Changelog intitolato Weekly Brief: May 15 to May 21, 2026. Il documento ha cinque sezioni, in questo ordine:

• Highlights con i primi tre elementi per impatto utente
• Features Shipped con ogni nuova capacità tradotta in un beneficio per l'utente finale
• Bugs Fixed che descrive cosa stava sperimentando l'utente prima della correzione
• Design Updates focalizzato su ciò che è visibilmente cambiato
• Social and Marketing con numeri di engagement quando la descrizione dell'attività li conteneva

Le sezioni vuote vengono saltate in silenzio. In fondo c'è un riepilogo dei conteggi su una sola riga. Il tutto occupa circa 400 parole e si legge come un digest interno piuttosto che come un changelog di marketing, perché è esattamente ciò che il prompt di sistema richiede.

Vedi gli esempi dal vivo: l'agente legge dal progetto sorgente filtrato Dev_Changelog, e il Weekly Brief: May 15 to May 21, 2026 è il documento effettivo che ha prodotto.

Il team lo legge in due minuti durante lo standup. Nessuno deve scriverlo. Nessuno deve ricordarsi di farlo.

Cosa ti danno Quire MCP e Claude Managed Agents

Quire MCP è un server Model Context Protocol ospitato su https://mcp.quire.app/mcp. Espone la API di Quire come un insieme di strumenti standardizzati che qualsiasi client compatibile con MCP può chiamare. Ce ne sono circa novantacinque che coprono tutto, da search_tasks a create_document a bulk_create_tasks. L'agente non ha bisogno di sapere com'è fatta la REST API di Quire. Vede solo un catalogo di strumenti e chiama ciò di cui ha bisogno.

Claude Managed Agents è il runtime ospitato di Anthropic per agenti autonomi. Definisci un agente (modello + prompt di sistema + configurazione degli strumenti), un ambiente (container in sandbox con politiche di rete) e crei sessioni che fanno effettivamente il lavoro. Anthropic gestisce il sandboxing, il proxy delle credenziali, il ciclo di esecuzione, il log di audit. Niente di tutto questo è codice che devi scrivere tu.

La combinazione conta perché ogni pezzo da solo è solo tubazione. Quire MCP senza un agente è un catalogo di strumenti senza nessuno che li chiami. Claude Managed Agents senza un MCP specifico per il dominio è una sandbox senza nulla da fare. Mettili insieme e ottieni un agente che intraprende azioni reali su dati di produzione reali, con autenticazione e sandboxing adeguati già integrati.

Non sei su Claude Managed Agents? Quire MCP funziona anche con Open Claw, il client MCP open source. Stesso catalogo di strumenti, stesso flusso OAuth, stessi workflow che puoi costruirci sopra. Scegli il runtime più adatto al tuo stack.

Perché è importante: la maggior parte degli strumenti di project management non spedisce ancora un server MCP pubblico. Asana, Monday e ClickUp espongono REST API ma non MCP, quindi dovresti farne il wrapping da solo e gestire l'autenticazione. Notion ha MCP, ma la sua superficie di strumenti è pensata per documenti e pagine, non per la struttura attività-e-subattività di cui l'automazione di progetto ha effettivamente bisogno. Quire MCP è costruito attorno alle unità di lavoro (attività, subattività, stati, etichette, sottoliste) su cui un agente opera, ed è per questo che questa build è stata un pomeriggio e non un trimestre.

La build, passo per passo

L'intera configurazione ha richiesto circa un'ora, la maggior parte della quale spesa a combattere un gotcha di configurazione di cui parlerò tra poco. Ecco la ricetta vera.

1. La definizione dell'agente

L'agente è un singolo file YAML. Il prompt di sistema è la parte più importante perché è ciò che trasforma una sessione Claude generica in un autore di changelog:

name: Dev Changelog Writer
model:
  id: claude-haiku-4-5
  speed: standard
system: |-
  You are the weekly changelog writer for the Quire project
  "Dev_Changelog" (https://quire.io/w/Dev_Changelog).
  When invoked:
  1. Use the Quire MCP to search Dev_Changelog for tasks where status
     is completed and the `toggled` timestamp falls within the last 7
     days. Pull name, description, priority, tags, and subtasks.
  2. Group results by tag: feature, bugfix, design, social. Within
     each group, sort by priority (urgent, high, medium, low).
  3. Translate each task from internal dev shorthand into plain
     language a customer would understand. Features: lead with the
     user-facing benefit. Bugfixes: lead with what the user was
     experiencing. Design: describe what visibly changed. Social:
     include engagement numbers if mentioned.
  4. Create a new document in Dev_Changelog using `create_document`.
     Title: "Weekly Brief: [start date] to [end date]". Sections:
     Highlights, Features Shipped, Bugs Fixed, Design Updates,
     Social and Marketing, plus a footer with item counts.
  5. If zero completed tasks are found, do not create a document.
mcp_servers:
  - name: quire
    type: url
    url: https://mcp.quire.app/mcp

Abbiamo scelto Haiku 4.5 perché il lavoro non richiede molto ragionamento. L'agente raggruppa, filtra e formatta, cosa che Haiku gestisce bene a circa un decimo del costo per token di Sonnet e con rate limit sostanzialmente più alti. Per un'esecuzione settimanale non presidiata, quel margine sui rate limit conta più del guadagno marginale di ragionamento.

2. Il filtraggio degli strumenti, dove sta il vero risparmio

Di default, quando colleghi il server Quire MCP a un agente, tutte le novantacinque definizioni di strumento vengono caricate nel contesto ogni volta che l'agente effettua una chiamata al modello. Sono tantissimi token, e la maggior parte è inutile quando il tuo agente deve solo leggere attività e creare un documento.

Filtra senza pietà:

tools:
  - mcp_server_name: quire
    type: mcp_toolset
    default_config:
      enabled: false
      permission_policy:
        type: always_allow
    configs:
      - name: search_tasks
        enabled: true
      - name: create_document
        enabled: true
      - name: list_tags
        enabled: true
      - name: resolve_quire_url
        enabled: true

default_config.enabled: false significa "niente attivo di default", e il blocco configs abilita esplicitamente i quattro strumenti che l'agente usa davvero. Questa singola modifica ha portato il conteggio dei token di input per esecuzione da circa 82.000 a meno di 12.000, il che ci ha spostati comodamente sotto il rate limit del Tier 1. (Più dettagli nelle storie di guerra qui sotto.)

C'è anche un beneficio di sicurezza. Con solo search_tasks, create_document, list_tags e resolve_quire_url abilitati, l'agente letteralmente non può eliminare, archiviare o modificare alcun dato esistente, nemmeno se un prompt injection ci provasse. Lo strumento bulk_delete_tasks di Quire non è nel suo toolkit, quindi il modello non può chiamarlo.

3. L'ambiente

I Managed Agents eseguono ogni sessione all'interno di una sandbox gVisor con una politica di rete che controlli tu. Il default è "Limited" senza accesso di rete esterno, il che bloccherà il tuo agente dal raggiungere Quire MCP. La soluzione più pulita è il principio del minimo privilegio: mantieni il tipo Limited, ma consenti esplicitamente l'unico hostname che ti serve.

Nella console di Claude: Manage Environments → il tuo env → Networking → abilita Allow MCP server network access → aggiungi mcp.quire.app a Allowed hosts. Lascia disabilitato l'accesso di rete del package manager, perché questo agente non installa nulla.

4. Il credential vault

Quire si autentica tramite OAuth. Nei Managed Agents, i token OAuth vivono in un credential vault che sta fuori dalla sandbox. Quando l'agente chiama Quire MCP, un proxy delle credenziali inietta il token lato server. Il modello stesso non vede mai il token, il che significa che un prompt injection riuscito non può esfiltrarlo.

Crea un vault, clicca su Add credential, puntalo a https://mcp.quire.app/mcp, scegli OAuth come tipo ed esegui il flusso di autorizzazione. Una volta che la credenziale appare come Active, il vault è pronto.

5. Pianificazione

Le sessioni dei Managed Agents sono one-shot. Non si auto-ripetono. Per far girare l'agente ogni lunedì, punta un qualunque scheduler all'endpoint API sessions.create con un'espressione cron 0 9 * * 1. Noi usiamo un semplice Cloudflare Workers Cron Trigger che chiama la API di Anthropic una volta a settimana, ma anche GitHub Actions su schedule funziona altrettanto bene, e così pure qualsiasi piattaforma di cloud function.

Cosa si è rotto, e come ce ne siamo accorti

Tre cose sono andate storte lungo la strada verso un'esecuzione settimanale pulita. Vale la pena nominarle perché se costruisci qualcosa di simile ne incontrerai almeno una.

URL MCP sbagliato. Il prodotto Quire è ospitato su quire.io, ma il server MCP è su quire.app. Abbiamo puntato tutto (agente, host consentiti dell'ambiente, credential vault) a mcp.quire.io/mcp e abbiamo ottenuto un errore OAuth confuso, poi, una volta superato quello, un HTTP 502 dall'upstream. La correzione è banale ma vale la pena segnalarla: ogni riferimento all'MCP deve usare mcp.quire.app, non quire.io. Se anche solo uno dei tre punti ha l'host sbagliato, l'esecuzione fallisce.

Eccesso di strumenti dell'agente. L'agent_toolset_20260401 di default di Anthropic carica nel contesto ogni strumento generico (bash, operazioni su file, ricerca web, esecuzione di codice). Il nostro agente non ha bisogno di nessuno di questi. Lasciare il toolset di default abilitato sopra il server Quire MCP ha spinto il conteggio dei token di input oltre 80.000 per chiamata al modello e abbiamo colpito il rate limit del Tier 1 all'istante. Rimuovere il toolset di default e filtrare gli strumenti di Quire (come mostrato sopra) lo ha portato a circa 12.000. La lezione: ogni strumento nel contesto del tuo agente è una tassa, anche se l'agente non lo chiama mai.

Panico da rate limit. Prima di capire il problema del bloat, la reazione naturale era "dobbiamo fare l'upgrade del tier API". Gli upgrade di tier costano. Il vero problema era che l'agente stava caricando 70.000 token di definizioni di strumenti che non avrebbe mai usato. Controlla sempre cosa c'è nella tua finestra di contesto prima di presumere di aver bisogno di un limite più alto.

Cosa sblocca Quire MCP oltre a un changelog settimanale

Il changelog settimanale è un primo agente utile, ma è soprattutto una prova di concetto. Il pattern (un Managed Agent + Quire MCP + un trigger pianificato) si estende a molto di più.

Alcuni che stiamo prototipando:

• Un brief giornaliero di kickoff sprint che legge le attività spostate in "In Progress" durante la notte e pubblica un riepilogo su Slack
• Un redattore di retrospettive di incidenti che osserva un progetto Quire per le attività incident completate e assembla una bozza di documento di retro con timeline, fattori contribuenti e azioni di follow-up estratte dalle subattività
• Un digest di status per i clienti che gira il venerdì pomeriggio per ogni progetto cliente, riassumendo le consegne della settimana in un linguaggio adatto a essere inoltrato direttamente al cliente

La forma è sempre la stessa. Un trigger pianificato, un agente focalizzato, un piccolo insieme di strumenti Quire MCP, un documento o un messaggio come output. Il lavoro duro (sandboxing, credenziali, ciclo dell'agente) è nei Managed Agents. Il lavoro di dominio (quali dati Quire interrogare, cosa farne) è nel prompt di sistema.

Quando questo non è l'approccio giusto

Un Managed Agent è eccessivo per domande una tantum. Se vuoi un riepilogo una tantum di "cosa è stato rilasciato questo trimestre", chiedere direttamente a Claude in una finestra di chat e incollare i dati di Quire è più veloce che costruire un agente deployato. La forma dell'agente paga solo quando lo stesso lavoro gira ripetutamente senza supervisione.

È anche la forma sbagliata quando il lavoro richiede davvero molto ragionamento, come scrivere una strategia di prodotto ponderata partendo dagli stessi dati. Haiku va bene per "riassumi e formatta". Per "decidi cosa dovremmo fare al riguardo", vuoi Sonnet o Opus, e a quel punto probabilmente vuoi anche un essere umano nel loop.

E se i dati del tuo progetto sono scarsi (diciamo, un paio di attività completate a settimana senza descrizioni), l'agente non ha nulla di utile da riassumere. L'output è buono solo quanto la disciplina che il tuo team ha nello scrivere descrizioni reali delle attività. Lo abbiamo imparato nel modo duro quando una prima esecuzione di test ha prodotto un brief tecnicamente corretto e totalmente non informativo, perché metà dei nomi delle attività erano solo ID di ticket.

Considerazioni finali

L'agente di changelog settimanale è piccolo per ambito e grande per ritorno perché elimina una tassa ricorrente (la riunione di riepilogo del lunedì) senza che nessuno debba ricordarsi di fare nulla. I pezzi che lo hanno fatto funzionare erano specifici: Haiku 4.5 per il margine su costi e rate limit, filtraggio aggressivo degli strumenti per mantenere la finestra di contesto compatta, una politica d'ambiente a minimo privilegio che permette traffico solo verso mcp.quire.app e un credential vault perché l'agente non tocchi mai il vero token OAuth.

La lezione generale è che Quire MCP più Claude Managed Agents è un modo veloce per mettere un agente autonomo davanti ai dati del tuo progetto senza costruire alcuna infrastruttura. Le parti difficili (sandboxing, autenticazione, pianificazione, log di audit) sono già risolte. Quello che porti tu sono il prompt, la selezione degli strumenti e la disciplina di scrivere dati di progetto che valga la pena riassumere in primo luogo.

Domande frequenti

Cos'è Quire MCP?

Quire MCP è un server Model Context Protocol che permette agli agenti AI di leggere e scrivere nel tuo workspace Quire tramite un'interfaccia di strumenti standardizzata. Vive su https://mcp.quire.app/mcp ed espone circa novantacinque strumenti che coprono ricerca, creazione di attività e documenti, operazioni bulk e altro. Qualsiasi client compatibile con MCP (Claude, Cursor, agenti personalizzati costruiti sull'SDK di Anthropic) può connettersi.

Cosa sono i Claude Managed Agents?

Claude Managed Agents è il runtime ospitato di Anthropic per eseguire agenti autonomi di lunga durata nel cloud. Definisci un agente (modello, prompt di sistema, strumenti), un ambiente (container in sandbox con politiche di rete) e crei sessioni che eseguono il lavoro. Anthropic gestisce sandboxing, brokeraggio delle credenziali e ciclo di esecuzione, così non devi costruire tu stesso quell'infrastruttura.

Perché usare Haiku 4.5 invece di Sonnet o Opus per questo tipo di automazione?

Riassumere dati strutturati di attività in un documento non è un compito che richiede molto ragionamento. Si tratta di raggruppare, filtrare e formattare. Haiku 4.5 gestisce quel livello di qualità senza problemi, costa circa un decimo di Sonnet per token e ha rate limit sostanzialmente più alti a ogni tier API. Per un job settimanale che gira senza supervisione, il margine su costi e rate limit conta più del guadagno marginale di ragionamento.

Quanto tempo impiega l'agente a generare un brief settimanale?

Per un progetto con circa venti attività completate nella finestra, l'intera esecuzione richiede meno di trenta secondi end-to-end. Sono inclusi la ricerca in Quire, l'elaborazione dei risultati, la stesura del corpo del documento e la creazione del documento nel progetto. La maggior parte di quel tempo è la chiamata al modello, non i round-trip degli strumenti.

L'agente può modificare o eliminare attività esistenti nel mio progetto?

Solo se concedi esplicitamente quei permessi sugli strumenti. Il server Quire MCP espone circa novantacinque strumenti, ma i Claude Managed Agents ti permettono di abilitare un sottoinsieme per ciascun agente. Per il caso d'uso del changelog abbiamo abilitato solo quattro strumenti di lettura-e-creazione, quindi l'agente non può modificare o eliminare alcun dato esistente nemmeno se un prompt injection tentasse di farglielo fare.

Cosa succede se nessuna attività è stata completata nella settimana in cui l'agente gira?

Il prompt dell'agente include un'istruzione di fallback: se la ricerca restituisce zero attività completate, non crea un documento e registra invece una singola riga che dice che la settimana è stata vuota. Questo evita che venga pubblicato un brief settimanale vuoto o fuorviante quando il team non ha consegnato nulla nella finestra.

Devo avere un piano Quire a pagamento per usare Quire MCP?

Quire MCP funziona con qualsiasi piano che abbia accesso API. Controlla le quote API attuali su quire.io/pricing. Per un agente che gira una volta a settimana e fa una manciata di chiamate agli strumenti per esecuzione, i limiti del tier gratuito o starter sono generalmente sufficienti.

Posso eseguire lo stesso agente su più progetti Quire?

Sì. Il pattern più pulito è una definizione di agente per workflow e una sessione per progetto. L'URL del progetto diventa un parametro al momento della creazione della sessione. Se vuoi un singolo brief settimanale che copra più progetti, ristruttura il prompt per interrogare ciascun progetto in sequenza e combinare i risultati in un unico documento.

Pronto a costruire il tuo agente su Quire MCP?

Inizia la tua prova gratuita di 30 giorni su quire.io/signup ed esplora i documenti per sviluppatori di Quire per vedere il catalogo completo degli strumenti MCP. Nessuna carta di credito, accesso completo.