Una bacheca di attività per Claude Code: configurazione vera in due minuti con MCP

Per dare a Claude Code una bacheca di attività, esegui un solo comando, claude mcp add --transport http weft https://letsweft.com/api/mcp, poi accedi a Weft nel browser la prima volta che Claude Code si collega. Non c’è nessuna chiave da copiare e niente da incollare in un file di configurazione. Dopo, un breve blocco in CLAUDE.md fa sì che Claude Code prenda in carico un’attività prima di modificare il codice, riferisca i progressi mentre lavora e lasci una ricevuta quando finisce.

Weft lo facciamo noi. Le informazioni sugli altri prodotti vengono dalle loro pagine ufficiali, verificate il 27 ottobre 2026.

Cosa dà una bacheca a Claude Code che il terminale non dà?

Claude Code conosce il repository che ha davanti, non chi altro sta lavorando o quale attività aveva iniziato una sessione andata in crash. Una bacheca tiene quello stato fuori da ogni singola sessione, così una persona, una seconda finestra di Claude Code e una chat di ChatGPT vedono la stessa cosa.

Non ne serve una per ogni repository. Una persona, una sessione breve e una lista di TODO spesso bastano. La bacheca comincia a ripagare quando il lavoro attraversa più sessioni o più agenti, o quando una persona deve guardare i risultati prima che contino.

Come collego Claude Code a Weft in due minuti?

1. Crea un account gratuito su letsweft.com. Una nuova bacheca parte con quattro colonne: Backlog, Todo, Doing e Done.
2. Nel terminale, esegui claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code salva il server per il progetto corrente; aggiungi --scope user se lo vuoi in ogni progetto (vedi la documentazione MCP di Claude Code di Anthropic).
3. Avvia claude. La prima volta che usi Weft si apre una finestra del browser per OAuth. Se non si apre, digita /mcp, scegli weft e autenticati da lì.
4. Nella schermata di consenso di Weft, scegli cosa può fare questa connessione: completo, scrittura (tutto tranne i tre strumenti distruttivi) o lettura. Puoi cambiarlo più tardi in Impostazioni → Client IA collegati.
5. Tornato in Claude Code, chiedi: “Cosa c’è sulla mia bacheca?”

L’endpoint parla MCP su Streamable HTTP ed espone 32 strumenti. Weft rilascia refresh token, quindi il client rinnova l’accesso da solo. Se usi un client che non supporta OAuth, funziona anche un token di accesso personale, ma a Claude Code non serve. La pagina di configurazione completa è su letsweft.com/claude-code.

Come verifico che funzioni senza fargli cambiare niente?

Fai in modo che il primo prompt sia in sola lettura. Ti dice che gli strumenti sono caricati e che l’accesso ha raggiunto lo spazio di lavoro giusto, e sulla bacheca non si muove nulla:

Elenca la mia bacheca Weft: colonne, cosa c’è in Doing e cosa aspetta me.
Non cambiare niente.

Claude Code dovrebbe chiamare get_board_state o get_my_work. Sono entrambi strumenti di sola lettura. Se vuoi un margine di sicurezza mentre ci prendi la mano, imposta la connessione su lettura nella schermata di consenso: le chiamate di scrittura vengono rifiutate, e le chiamate rifiutate non contano nella tua quota mensile.

Un costo onesto: le definizioni dei 32 strumenti occupano circa 18.000 token del contesto di Claude Code.

Com’è fatta un’attività presa in carico?

Metti in Todo un’attività piccola e reale, per esempio “sistemare il test instabile sulle date”, e chiedi a Claude Code di prenderla. Un’esecuzione fatta bene va così:

1. get_my_work restituisce cosa è già di questo client, cosa aspetta te e se c’è spazio per iniziare qualcosa.
2. start_task prende in carico l’attività, la sposta in Doing e restituisce un runId e un leaseToken. La risposta dice anche all’agente di rinnovare ogni 300 secondi.
3. Claude Code lavora nel repository come al solito. Ogni pochi minuti chiama report_progress, che rinnova il lease.
4. Se arriva a una decisione che solo tu puoi prendere, chiama request_input con delle opzioni. Claude Code mostra la domanda con le sue schede di scelta native; la risposta torna indietro tramite submit_answer.
5. complete_task chiude l’esecuzione con un esito, artifacts come l’hash del commit e l’output dei test, e ciò che non ha fatto.

Per impostazione predefinita un’attività completata va direttamente in Done. Si ferma invece nella tua Inbox quando richiede una revisione o un controllo di verifica fallisce. Lì scegli Accetta, Rifai, Più tardi o Scarta. Se l’agente ha passato un nextStep, come “fare il merge della PR #12”, Accetta approva esattamente quel passo, che torna all’agente da eseguire.

Il ciclo completo, con ogni rifiuto e ogni campo, è nella guida al ciclo di presa in carico.

Cosa devo mettere in CLAUDE.md?

Le descrizioni degli strumenti contengono già queste regole; qualche riga in CLAUDE.md le trasforma in un’abitudine del repository. Incolla e adatta:

## Bacheca attività Weft

Weft (server MCP "weft") è la bacheca condivisa di questo repository. La leggono
anche altri client IA e delle persone, quindi tienila veritiera.

- All’inizio di una sessione, chiama get_my_work. Lavora su ciò che restituisce;
  non scegliere attività a memoria.
- Prima di modificare qualsiasi file per un’attività, chiama start_task con il suo id.
  Conserva il runId e il leaseToken che restituisce.
  - already_claimed: ce l’ha qualcun altro. Non duplicare; scegline un’altra.
  - attention_queue_full: non riprovare. Fai ciò che suggerisce la risposta
    (finisci o chiarisci il lavoro esistente).
- Mentre lavori, chiama report_progress con runId e leaseToken circa ogni
  5 minuti, e a ogni vero traguardo (test verdi, PR aperta).
- Chiama request_input solo per le decisioni che spettano alla persona: tutto ciò che è
  irreversibile (produzione, soldi, pubblicazione, eliminazione di dati) o un vero bivio
  senza un’opzione predefinita sensata. Fornisci delle opzioni. Non chiedere mai il permesso di continuare.
- Quando hai finito, chiama complete_task con:
  - outcome: una o due frasi su cosa è cambiato
  - artifacts: hash del commit, URL della PR, comando dei test e relativo risultato
  - notDone: cosa hai saltato o lasciato per dopo
  - unknowns: cosa non hai potuto verificare
  - nextStep: l’unico passo che faresti se la persona accetta
- Se ti fermi senza finire, dillo e lascia l’attività in Doing.

Gli artifacts trasformano un “fatto” in qualcosa che puoi controllare. La chiamata non fallisce mai per mancanza di prove, perché perdere lavoro finito è peggio che registrarlo non verificato.

Cosa succede quando una sessione di Claude Code muore a metà attività?

Nessuno deve rimettere in ordine dopo. La presa in carico è un lease, non un flag. start_task concede 20 minuti, e ogni report_progress li rinnova. Una sessione che va in crash, perde la rete o viene chiusa non può riferire, quindi il silenzio è il segnale.

• Dopo 20 minuti senza segnali di vita, l’esecuzione viene marcata come scaduta, il lease token viene cancellato e l’attività torna non assegnata.
• Un controllo gira ogni 10 minuti, e l’attività viene liberata subito anche quando un altro client prova a prenderla in carico.
• Un’esecuzione in attesa della tua risposta mantiene la presa in carico per 60 minuti. Dopo, il lease cade ma la domanda resta aperta nella tua Inbox.
• Le prese in carico le decide il database, quindi due finestre di Claude Code in gara per la stessa attività non possono vincere entrambe. Chi perde riceve already_claimed con l’id e il titolo dell’attività.

L’uso di più agenti insieme è trattato in più agenti IA su una sola bacheca.

Posso vedere la stessa bacheca da ChatGPT o dal telefono?

Sì. È una sola bacheca dietro un solo endpoint. Weft è un’app pubblicata in ChatGPT su ogni piano, gratuito compreso (configurazione), quindi puoi chiedere a ChatGPT cosa ha finito Claude Code durante la notte. Cursor si installa con un clic (configurazione) e Codex usa una voce di configurazione più codex mcp login weft (configurazione). Su claude.ai e Claude Desktop, Weft si aggiunge come connettore personalizzato.

Weft ha anche app per iOS e Android. Quando un’attività arriva nella tua coda, il telefono riceve una notifica push, al massimo una per spazio di lavoro ogni 10 minuti, così una domanda di Claude Code ti raggiunge anche lontano dalla scrivania. Ogni client OAuth è un attore a sé, e la bacheca mostra il nome con cui si è registrato.

Per rileggere cosa ha fatto un agente, vedi cosa ha fatto il mio agente IA?

Cosa può andare storto, e come si risolve?

Accesso non effettuato

Se Claude Code segnala che weft richiede l’autenticazione, digita /mcp, seleziona weft e autenticati. Se hai scollegato il client in Impostazioni → Client IA collegati di Weft, i suoi vecchi token vengono rifiutati alla chiamata successiva, quindi accedi di nuovo nello stesso modo.

Gli strumenti di Weft non compaiono

Esegui claude mcp list e verifica che weft ci sia con l’URL https://letsweft.com/api/mcp. Il server vale per progetto, a meno che tu non l’abbia aggiunto con --scope user, quindi in un’altra cartella potrebbe mancare.

already_claimed

È una risposta, non un errore. Un altro client ha un lease attivo su quell’attività. L’agente dovrebbe scegliere un altro lavoro. Se sai che l’altra sessione è morta, aspetta: il lease scade entro 20 minuti e l’attività viene liberata.

attention_queue_full

C’è troppo lavoro finito o bloccato che aspetta te: 5 elementi in uno spazio di lavoro di una persona o 10 in un team, oppure 45 minuti di revisione stimata, quale arriva prima. Contano anche le domande. start_task rifiuta finché non svuoti un po’ la Inbox. La risposta elenca cosa può ancora fare l’agente (report_progress, get_my_work, get_board_state, search), così può finire o mettere in ordine invece di iniziare altro.

Le chiamate si fermano sul piano gratuito

Il gratuito include 200 chiamate IA al mese, e le prime 48 ore dopo la registrazione non vengono conteggiate. Una sessione lunga con un segnale di vita ogni cinque minuti consuma chiamate di continuo. Pro toglie il tetto; vedi i prezzi.

Come si confronta con un TODO.md, GitHub Issues o Hypertask?

Le informazioni su GitHub rimandano alla documentazione e alla pagina dei prezzi di GitHub; quelle su Hypertask alla loro documentazione. Per una tabella più ampia, vedi task manager MCP a confronto.

Un TODO.md è la risposta giusta per uno sviluppatore su un repository: versionato con il codice, nessun account, nessuna autenticazione. Non regge più quando due sessioni lo modificano, o quando vuoi rispondere a una domanda dal telefono.

GitHub Issues è la casa naturale quando il tuo lavoro è già fatto di issue e pull request e tutto il team vive su GitHub. Weft non ha un’integrazione con GitHub, quindi i link a commit e PR viaggiano come artifacts sulla ricevuta invece che tramite sincronizzazione.

Hypertask è la scelta migliore se vuoi una CLI per hook e CI, un’API REST, agenti come account di servizio con un’identità propria, funzioni IA integrate, monitoraggio del tempo o un’app pensata per la tastiera. Weft non ha CLI, né API pubblica, né monitoraggio del tempo. Dove Weft si distingue è che la presa in carico, il segnale di vita e la domanda alla persona sono strumenti MCP che Claude Code chiama direttamente, l’accesso è OAuth con refresh, e la stessa bacheca è in ChatGPT e in entrambi gli store per telefono. Di più nel nostro confronto con Hypertask.

Mi serve una chiave API per Claude Code?

No. Claude Code accede con OAuth nel browser, e Weft rilascia refresh token, quindi il client rinnova l’accesso da solo. I token di accesso personali esistono per i client che non supportano OAuth, ma a Claude Code non servono.

Claude Code segnerà le mie attività come Done senza di me?

Per impostazione predefinita sì: complete_task sposta l’attività in Done con la sua ricevuta. Un’attività che richiede una revisione, o il cui controllo di verifica fallisce, si ferma invece nella tua Inbox per Accetta, Rifai, Più tardi o Scarta.

Posso impedire a Claude Code di eliminare le cose?

Imposta la connessione su scrittura nella schermata di consenso, o più tardi in Impostazioni → Client IA collegati. Scrittura permette tutto tranne i tre strumenti distruttivi (trash_task, archive_done_tasks, complete_sprint). Lettura permette solo gli 11 strumenti di sola lettura. In ogni caso gli agenti non possono eliminare le attività definitivamente; il cestino le conserva per 30 giorni, e il ripristino dal cestino è una funzione Pro.

Weft fa pagare l’IA in più rispetto a Claude?

No. Weft non ha crediti IA: il ragionamento avviene in Claude Code con il tuo piano Claude. Weft conta le chiamate agli strumenti: 200 al mese sul gratuito, illimitate su Pro a 7 $ per postazione al mese o 60 $ all’anno. Vedi i prezzi.

E se tengo già le attività in Linear, Jira, Notion o Trello?

L’importazione è gratuita su ogni piano: esportazioni CSV da Linear, Jira o Notion, oppure una bacheca Trello in JSON. Claude Code può anche creare molte attività insieme con bulk_create_tasks.

Weft funziona con altri agenti di programmazione oltre a Claude Code?

Sì. Ci sono 33 pagine di configurazione per i client, tra cui Cursor, Codex e ChatGPT. Raggiungono tutti la stessa bacheca tramite lo stesso endpoint.