Tauler de tasques per a Claude Code: una configuració real de dos minuts amb MCP
Connecta Claude Code a un tauler de tasques de Weft amb una sola ordre i un inici de sessió al navegador, i afegeix un bloc a CLAUDE.md perquè reclami, informi i tanqui les tasques.
Weft és el gestor de tasques amb IA per a fundadors en solitari i equips petits.
Per Andrei Finogeev ·
Per donar un tauler de tasques a Claude Code, executa una sola ordre, claude mcp add --transport http weft https://letsweft.com/api/mcp, i inicia sessió a Weft al navegador la primera vegada que Claude Code s'hi connecti. No hi ha cap clau per copiar ni res per enganxar en un fitxer de configuració. Després, un bloc breu a CLAUDE.md fa que Claude Code reclami una tasca abans d'editar codi, informi mentre treballa i deixi un comprovant quan acabi.
Weft és nostre. Les dades sobre altres productes provenen de les seves pàgines oficials, consultades el 27 d'octubre de 2026.
Què dona un tauler a Claude Code que el terminal no li dona?
Claude Code coneix el repositori que té davant, però no sap qui més hi està treballant ni quina tasca havia començat una sessió que ha caigut. Un tauler guarda aquest estat fora de qualsevol sessió, de manera que una persona, una segona finestra de Claude Code i un xat de ChatGPT veuen el mateix.
No en necessites un per a cada repositori. Una persona, una sessió curta i una llista TODO sovint n'hi ha prou. El tauler comença a compensar quan la feina s'estén al llarg de diverses sessions o diversos agents, o quan una persona ha de revisar els resultats abans que comptin.
Com connecto Claude Code a Weft en dos minuts?
- Crea un compte gratuït a letsweft.com. Un tauler nou comença amb quatre columnes: Backlog, Todo, Doing i Done.
- Al terminal, executa
claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code desa el servidor per al projecte actual; afegeix--scope usersi el vols a tots els projectes (consulta la documentació de MCP de Claude Code d'Anthropic). - Inicia
claude. La primera vegada que es faci servir Weft, s'obrirà una finestra del navegador per a l'OAuth. Si no s'obre, escriu/mcp, tria weft i autentica't des d'allà. - A la pantalla de consentiment de Weft, tria què pot fer aquesta connexió: full, write (tot excepte les tres eines destructives) o read. Ho pots canviar més endavant a Settings → Connected AI clients.
- De tornada a Claude Code, pregunta: «Què hi ha al meu tauler?»
L'endpoint parla MCP per Streamable HTTP i ofereix 32 eines. Weft emet tokens de renovació, de manera que el client renova la sessió tot sol. Si fas servir un client que no pot fer OAuth, també funciona un token d'accés personal, però Claude Code no el necessita. La pàgina de configuració completa és a letsweft.com/claude-code.
Com comprovo que funciona sense deixar-li canviar res?
Fes que la primera instrucció sigui només de lectura. Així sabràs que les eines estan carregades i que l'inici de sessió ha arribat a l'espai de treball correcte, i no es mourà res del tauler:
Llista el meu tauler de Weft: columnes, què hi ha a Doing i què m'està esperant.
No canviïs res.Claude Code hauria de cridar get_board_state o get_my_work. Totes dues són eines de només lectura. Si vols un marge de seguretat mentre t'hi acostumes, posa la connexió en read a la pantalla de consentiment: llavors les crides d'escriptura es rebutgen, i les crides rebutjades no compten per a la teva quota mensual.
Un cost, per ser honestos: les 32 definicions d'eines ocupen aproximadament 18.000 tokens del context de Claude Code.
Com és una tasca reclamada?
Posa una tasca petita i real a Todo, per exemple «arreglar el test de dates inestable», i demana a Claude Code que l'agafi. Una bona execució va així:
get_my_workretorna el que ja és d'aquest client, el que t'està esperant i si hi ha espai per començar res.start_taskreclama la tasca, la mou a Doing i retorna unrunIdi unleaseToken. La resposta també diu a l'agent que renovi cada 300 segons.- Claude Code treballa al repositori com sempre. Cada pocs minuts crida
report_progress, que renova l'arrendament. - Si topa amb una decisió que només pots prendre tu, crida
request_inputamb opcions. Claude Code mostra la pregunta amb les seves targetes d'opcions natives; la resposta torna a través desubmit_answer. complete_tasktanca l'execució amb un resultat, artefactes com el hash del commit i la sortida dels tests, i el que no ha fet.
Per defecte, una tasca completada va directament a Done. En canvi, s'atura a la teva safata d'entrada quan la tasca necessita revisió o falla una comprovació de verificació. Allà tries Accept, Rework, Later o Drop. Si l'agent ha indicat un nextStep, com ara «merge PR #12», Accept aprova exactament aquell pas i torna a l'agent perquè el dugui a terme.
El cicle complet, amb totes les negatives i tots els camps, és a la guia del cicle de reclamació.
Què hauria de posar a CLAUDE.md?
Les descripcions de les eines ja porten aquestes normes; unes quantes línies a CLAUDE.md les converteixen en l'hàbit del repositori. Enganxa-les i ajusta-les:
## Tauler de tasques de Weft
Weft (servidor MCP "weft") és el tauler compartit d'aquest repositori. Altres
clients d'IA i persones també el llegeixen, així que mantén-lo al dia.
- A l'inici d'una sessió, crida get_my_work. Treballa en el que retorni;
no triïs tasques de memòria.
- Abans de canviar cap fitxer per a una tasca, crida start_task amb el seu id.
Guarda el runId i el leaseToken que retorni.
- already_claimed: la té algú altre. No dupliquis la feina; tria'n una altra.
- attention_queue_full: no ho tornis a provar. Fes el que suggereixi la
resposta (acabar o aclarir la feina existent).
- Mentre treballes, crida report_progress amb runId i leaseToken més o menys
cada 5 minuts, i a cada punt de control real (tests en verd, PR oberta).
- Crida request_input només per a decisions que ha de prendre la persona:
qualsevol cosa irreversible (producció, diners, publicar, eliminar dades) o
una bifurcació real sense cap opció per defecte raonable. Dona opcions. No
demanis mai permís per continuar.
- Quan acabis, crida complete_task amb:
- outcome: una o dues frases sobre què ha canviat
- artifacts: hash del commit, URL de la PR, ordre dels tests i el resultat
- notDone: què t'has saltat o has deixat per més endavant
- unknowns: què no has pogut verificar
- nextStep: l'únic pas que faries si la persona ho accepta
- Si t'atures sense acabar, digues-ho i deixa la tasca a Doing.Els artefactes converteixen un «fet» en alguna cosa que pots comprovar. La crida no falla mai per falta de proves, perquè perdre feina acabada és pitjor que registrar-la sense verificar.
Què passa quan una sessió de Claude Code cau a mitja tasca?
No cal que ningú netegi res després. La reclamació és un arrendament, no una marca. start_task concedeix 20 minuts, i cada report_progress els renova. Una sessió que falla, es queda sense xarxa o es tanca no pot informar, així que el silenci és el senyal.
- Després de 20 minuts sense senyal de vida, l'execució es marca com a caducada, el token de l'arrendament s'esborra i la tasca torna a quedar sense assignar.
- Cada 10 minuts es fa una revisió, i la tasca també s'allibera immediatament quan un altre client prova de reclamar-la.
- Una execució que espera la teva resposta conserva la reclamació durant 60 minuts. Després l'arrendament cau, però la pregunta continua oberta a la teva safata d'entrada.
- Les reclamacions les decideix la base de dades, així que dues finestres de Claude Code que competeixen per la mateixa tasca no poden guanyar totes dues. La que perd rep already_claimed amb l'identificador i el títol de la tasca.
Com fer córrer diversos agents alhora s'explica a diversos agents d'IA en un sol tauler.
Puc veure el mateix tauler des de ChatGPT o des del mòbil?
Sí. És un sol tauler darrere d'un sol endpoint. Weft és una aplicació publicada a ChatGPT en tots els plans, inclòs el Free (configuració), així que pots preguntar a ChatGPT què ha acabat Claude Code durant la nit. Cursor s'instal·la amb un clic (configuració) i Codex fa servir una entrada de configuració més codex mcp login weft (configuració). A claude.ai i Claude Desktop, Weft s'afegeix com a connector personalitzat.
Weft també té aplicacions per a iOS i Android. Quan una tasca arriba a la teva cua, el mòbil rep una notificació push, com a màxim una per espai de treball cada 10 minuts, de manera que una pregunta de Claude Code t'arriba encara que no siguis a l'escriptori. Cada client OAuth és un actor diferent, i el tauler mostra el nom amb què s'ha registrat.
Per revisar què ha fet un agent, consulta què ha fet el meu agent d'IA?
Què pot fallar, i com ho arreglo?
No has iniciat sessió
Si Claude Code diu que weft necessita autenticació, escriu /mcp, selecciona weft i autentica't. Si has desconnectat el client a Settings → Connected AI clients de Weft, els seus tokens antics es rebutgen a la crida següent, així que torna a iniciar sessió de la mateixa manera.
Les eines de Weft no apareixen
Executa claude mcp list i comprova que weft hi és amb l'URL https://letsweft.com/api/mcp. El servidor és per projecte, tret que l'hagis afegit amb --scope user, així que una altra carpeta potser no el té.
already_claimed
És una resposta, no un error. Un altre client té un arrendament actiu sobre aquella tasca. L'agent hauria de triar una altra feina. Si saps que l'altra sessió és morta, espera: l'arrendament caduca en un màxim de 20 minuts i la tasca queda lliure.
attention_queue_full
Tens massa feina acabada o bloquejada esperant-te: 5 elements en un espai de treball d'una persona o 10 en un d'equip, o 45 minuts de revisió estimada, el que arribi primer. Les preguntes també hi compten. start_task es nega fins que no buidis una part de la safata d'entrada. La resposta llista què pot fer encara l'agent (report_progress, get_my_work, get_board_state, search), perquè pugui acabar o endreçar en lloc de començar més coses.
Les crides s'aturen al pla Free
El pla Free inclou 200 crides d'IA al mes, i les primeres 48 hores després de registrar-te no es compten. Una sessió llarga amb un senyal de vida cada cinc minuts va consumint crides de manera constant. Pro elimina el límit; consulta els preus.
Com es compara amb un TODO.md, GitHub Issues o Hypertask?
Les dades de GitHub enllacen a la documentació i a la pàgina de preus de GitHub; les de Hypertask, a la seva documentació. Per a una taula més àmplia, consulta la comparativa de gestors de tasques MCP.
| Weft | Un TODO.md al repositori | GitHub Issues MCP | Hypertask | |
|---|---|---|---|---|
| Com es connecta Claude Code | Una ordre claude mcp add, Streamable HTTP | Sense connexió: Claude Code llegeix el fitxer | Servidor oficial allotjat api.githubcopilot.com/mcp/ | Configuració documentada: fitxer de configuració amb una clau d'API copiada; Streamable HTTP a /mcp, SSE antic a /sse |
| Inici de sessió i caducitat | OAuth al navegador; tokens de renovació, de manera que el client renova la sessió tot sol. Tokens d'accés opcionals per a clients sense OAuth | No en cal | OAuth o un token d'accés personal | La clau copiada caduca al cap de 30 dies; una connexió aprovada al navegador dura 90 dies sense token de renovació |
| Reclamació amb arrendament, dins de MCP | Sí: start_task, arrendament de 20 minuts, already_claimed per al segon agent | No. Dues sessions poden editar la mateixa línia | No es descriu a la documentació de GitHub | Els arrendaments existeixen com a endpoints REST, no com a eines MCP, per disseny |
| Preguntar a la persona a mitja tasca | request_input amb opcions; safata d'entrada i notificació push al mòbil | Només al terminal que estàs mirant | Comentaris a la incidència | L'escalat és només per REST |
| Nombre d'eines MCP | 32 | Cap | No s'indica | 21 |
| El mateix tauler des de ChatGPT | Aplicació publicada a ChatGPT, tots els plans, inclòs el Free | No | No ho cobreix la documentació de GitHub | GPT personalitzat amb OpenAPI Actions, o un connector en mode de desenvolupador segons el seu llms.txt |
| Mòbil | Aplicacions per a iOS i Android | Un fitxer de text | GitHub Mobile, iOS i Android (App Store, Google Play) | Sense aplicació nativa per a iOS (aplicació web a la pantalla d'inici); APK d'Android a GitHub, sense fitxa a Play |
| Idiomes | 27 | El teu | No s'indica | Només anglès |
| CLI per a scripts i CI | No | Qualsevol eina de terminal | No s'indica aquí | Sí, @hypertask/hypertask_cli |
| Preu per llicència | Free: 50 tasques, 200 crides d'IA al mes. Pro: 7,87 € al mes o 66,55 € l'any | Gratuït | Pla gratuït; pla Team de pagament, consulta els preus de GitHub | Free (3 taulers per persona); BYOK 8 $ anual / 10 $ mensual; Pro 16 $ anual / 20 $ mensual |
| Cal comprar crèdits d'IA | No: el raonament passa a Claude Code | No | No per a les incidències | IA integrada: assignació inicial al Free, les teves pròpies claus a BYOK, inclosa a Pro |
Un TODO.md és la resposta adequada per a un sol desenvolupador en un sol repositori: versionat amb el codi, sense compte, sense autenticació. Es trenca quan dues sessions l'editen, o quan vols respondre una pregunta des del mòbil.
GitHub Issues és el lloc natural quan la teva feina ja són incidències i pull requests i tot l'equip viu a GitHub. Weft no té integració amb GitHub, així que els enllaços als commits i a les PR viatgen com a artefactes del comprovant, no per sincronització.
Hypertask és millor opció si vols una CLI per a hooks i CI, una API REST, agents com a comptes de servei amb identitat pròpia, funcions d'IA integrades, control del temps o una aplicació pensada per al teclat. Weft no té CLI, ni API pública, ni control del temps. On Weft es diferencia és que la reclamació, el senyal de vida i la pregunta a la persona són eines MCP que Claude Code crida directament, l'inici de sessió és OAuth amb renovació, i el mateix tauler és a ChatGPT i a totes dues botigues d'aplicacions mòbils. Més informació a la nostra comparativa amb Hypertask.
- Necessito una clau d'API per a Claude Code?
- No. Claude Code inicia sessió amb OAuth al navegador, i Weft emet tokens de renovació perquè el client renovi la sessió tot sol. Hi ha tokens d'accés personal per als clients que no poden fer OAuth, però Claude Code no en necessita.
- Claude Code marcarà les meves tasques com a Done sense mi?
- Per defecte, sí: complete_task mou la tasca a Done amb el seu comprovant. Una tasca que necessita revisió, o que falla la comprovació de verificació, s'atura a la teva safata d'entrada perquè triïs Accept, Rework, Later o Drop.
- Puc impedir que Claude Code elimini coses?
- Posa la connexió en write a la pantalla de consentiment, o més endavant a Settings → Connected AI clients. Write permet tot excepte les tres eines destructives (trash_task, archive_done_tasks, complete_sprint). Read només permet les 11 eines de lectura. En cap cas els agents no poden eliminar tasques definitivament; la paperera les guarda 30 dies, i restaurar-les des de la paperera és una funció de Pro.
- Weft cobra per la IA a més de Claude?
- No. Weft no té crèdits d'IA: el raonament passa a Claude Code amb el teu propi pla de Claude. Weft compta les crides a eines: 200 al mes al Free, il·limitades a Pro per 7,87 € per persona al mes o 66,55 € l'any. Consulta els preus.
- I si ja tinc les tasques a Linear, Jira, Notion o Trello?
- La importació és gratuïta en tots els plans: exportacions CSV de Linear, Jira o Notion, o un tauler de Trello en JSON. Claude Code també pot crear moltes tasques alhora amb bulk_create_tasks.