Takenbord voor Claude Code: echt in twee minuten ingesteld met MCP

Om Claude Code een takenbord te geven, voer je één commando uit, claude mcp add --transport http weft https://letsweft.com/api/mcp, en meld je je in de browser aan bij Weft wanneer Claude Code voor het eerst verbinding maakt. Er is geen sleutel om te kopiëren en niets om in een configuratiebestand te plakken. Daarna zorgt een kort blok in CLAUDE.md ervoor dat Claude Code een taak claimt voordat het code wijzigt, voortgang meldt terwijl het werkt, en een bewijsstuk achterlaat als het klaar is.

Wij maken Weft. Feiten over andere producten komen van hun officiële pagina's, gecontroleerd op 27 oktober 2026.

Wat geeft een bord Claude Code dat de terminal niet geeft?

Claude Code kent de repository die voor hem ligt, maar niet wie er verder aan werkt of welke taak een gecrashte sessie was begonnen. Een bord bewaart die stand buiten elke afzonderlijke sessie, zodat een persoon, een tweede Claude Code-venster en een ChatGPT-chat hetzelfde zien.

Je hebt er niet voor elke repo een nodig. Eén persoon, één korte sessie en een TODO-lijst is vaak genoeg. Het bord begint zich terug te betalen wanneer werk zich over meerdere sessies of meerdere agents uitstrekt, of wanneer iemand de resultaten moet bekijken voordat ze tellen.

Hoe verbind ik Claude Code in twee minuten met Weft?

1. Maak een gratis account aan op letsweft.com. Een nieuw bord begint met vier kolommen: Backlog, Todo, Doing en Done.
2. Voer in je terminal claude mcp add --transport http weft https://letsweft.com/api/mcp uit. Claude Code slaat de server op voor het huidige project; voeg --scope user toe als je hem in elk project wilt hebben (zie de MCP-docs van Anthropic voor Claude Code).
3. Start claude. De eerste keer dat Weft gebruikt wordt, opent er een browservenster voor OAuth. Gebeurt dat niet, typ dan /mcp, kies weft en authenticeer daarvandaan.
4. Kies op het toestemmingsscherm van Weft wat deze verbinding mag doen: full, write (alles behalve de drie destructieve tools) of read. Je kunt dit later wijzigen in Instellingen → Gekoppelde AI-clients.
5. Vraag terug in Claude Code: "Wat staat er op mijn bord?"

Het endpoint spreekt MCP via Streamable HTTP en biedt 32 tools. Weft geeft refresh-tokens uit, dus de client vernieuwt de aanmelding zelf. Gebruik je een client die geen OAuth kan, dan werkt een persoonlijk toegangstoken ook, maar Claude Code heeft er geen nodig. De volledige setuppagina staat op letsweft.com/nl/claude-code.

Hoe controleer ik dat het werkt zonder dat het iets verandert?

Maak de eerste prompt alleen-lezen. Zo weet je dat de tools geladen zijn en dat de aanmelding de juiste werkruimte heeft bereikt, en er verschuift niets op het bord:

Toon mijn Weft-bord: de kolommen, wat er in Doing staat en wat er op mij wacht.
Verander niets.

Claude Code hoort get_board_state of get_my_work aan te roepen. Beide zijn tools die alleen lezen. Wil je een veiligheidsmarge terwijl je eraan went, zet de verbinding dan op read op het toestemmingsscherm: schrijfaanroepen worden dan geweigerd, en geweigerde aanroepen tellen niet mee voor je maandquotum.

Eén eerlijke kostenpost: de definities van de 32 tools nemen zo'n 18.000 tokens van de context van Claude Code in.

Hoe ziet één geclaimde taak eruit?

Zet een kleine, echte taak in Todo, bijvoorbeeld "repareer de wispelturige datumtest", en vraag Claude Code hem op te pakken. Een goede run verloopt zo:

1. get_my_work geeft terug wat al van deze client is, wat er op jou wacht en of er ruimte is om iets te beginnen.
2. start_task claimt de taak, verplaatst hem naar Doing en geeft een runId en leaseToken terug. Het antwoord zegt de agent ook om elke 300 seconden te verlengen.
3. Claude Code werkt zoals gewoonlijk in de repo. Om de paar minuten roept het report_progress aan, wat de lease verlengt.
4. Stuit het op een beslissing die alleen jij kunt nemen, dan roept het request_input aan met opties. Claude Code toont de vraag als zijn eigen optiekaarten; het antwoord gaat terug via submit_answer.
5. complete_task sluit de run af met een uitkomst, artifacts zoals de commit-hash en testuitvoer, en wat het niet heeft gedaan.

Standaard gaat een afgeronde taak rechtstreeks naar Done. Hij stopt in plaats daarvan in je Inbox als de taak beoordeling nodig heeft of een verificatiecontrole faalt. Daar kies je Accepteren, Herwerken, Later of Laten vallen. Heeft de agent een nextStep meegegeven, zoals "merge PR #12", dan keurt Accepteren precies die stap goed en komt hij terug bij de agent om uit te voeren.

De hele lus, met elke weigering en elk veld, staat in de gids over de claimlus.

Wat zet ik in CLAUDE.md?

De toolbeschrijvingen bevatten deze regels al; een paar regels in CLAUDE.md maken er een gewoonte van de repo van. Plak en pas aan:

## Weft-takenbord

Weft (MCP-server "weft") is het gedeelde bord voor deze repo. Andere AI-clients
en mensen lezen het ook, dus houd het kloppend.

- Roep aan het begin van een sessie get_my_work aan. Werk aan wat dat teruggeeft;
  kies geen taken uit je geheugen.
- Roep start_task aan met het id van de taak voordat je voor die taak een bestand wijzigt.
  Bewaar de runId en leaseToken die het teruggeeft.
  - already_claimed: iemand anders heeft hem. Niet dupliceren; kies een andere.
  - attention_queue_full: niet opnieuw proberen. Doe wat het antwoord voorstelt
    (bestaand werk afmaken of verduidelijken).
- Roep tijdens het werk ongeveer elke 5 minuten report_progress aan met runId en
  leaseToken, en bij elk echt ijkpunt (tests groen, PR geopend).
- Roep request_input alleen aan voor beslissingen die de persoon moet nemen: alles
  wat onomkeerbaar is (productie, geld, publiceren, data verwijderen) of een echte
  splitsing zonder redelijke standaard. Geef opties. Vraag nooit toestemming om door te gaan.
- Roep als je klaar bent complete_task aan met:
  - outcome: een of twee zinnen over wat er veranderd is
  - artifacts: commit-hash, PR-URL, testcommando en het resultaat ervan
  - notDone: wat je hebt overgeslagen of voor later hebt laten liggen
  - unknowns: wat je niet kon verifiëren
  - nextStep: de ene stap die je zou zetten als de persoon accepteert
- Stop je zonder af te maken, zeg dat dan en laat de taak in Doing staan.

Artifacts maken van "klaar" iets wat je kunt controleren. De aanroep faalt nooit bij ontbrekend bewijs, want afgerond werk kwijtraken is erger dan het ongeverifieerd vastleggen.

Wat gebeurt er als een Claude Code-sessie midden in een taak afbreekt?

Niemand hoeft erachteraan op te ruimen. De claim is een lease, geen vlag. start_task geeft 20 minuten, en elke report_progress verlengt die. Een sessie die crasht, zijn netwerk verliest of wordt gesloten, kan niets melden, dus stilte is het signaal.

• Na 20 minuten zonder heartbeat wordt de run als verlopen gemarkeerd, wordt het lease-token gewist en gaat de taak terug naar niet-toegewezen.
• Elke 10 minuten loopt er een opruimronde, en de taak komt ook meteen vrij zodra een andere client hem probeert te claimen.
• Een run die op jouw antwoord wacht, houdt zijn claim 60 minuten vast. Daarna vervalt de lease, maar blijft de vraag open in je Inbox.
• Claims worden door de database beslist, dus twee Claude Code-vensters die om dezelfde taak racen, kunnen niet allebei winnen. De verliezer krijgt already_claimed met het id en de titel van de taak.

Meerdere agents tegelijk draaien komt aan bod in meerdere AI-agents op één bord.

Kan ik hetzelfde bord zien vanuit ChatGPT of op mijn telefoon?

Ja. Het is één bord achter één endpoint. Weft is een gepubliceerde app in ChatGPT op elk plan, ook Free (setup), dus je kunt ChatGPT vragen wat Claude Code vannacht heeft afgerond. Cursor installeer je met één klik (setup) en Codex gebruikt een configuratieregel plus codex mcp login weft (setup). Op claude.ai en in Claude Desktop voeg je Weft toe als custom connector.

Weft heeft ook apps voor iOS en Android. Wanneer er een taak in je wachtrij belandt, krijgt de telefoon een pushmelding, maximaal één per werkruimte per 10 minuten, zodat een vraag van Claude Code je ook bereikt als je niet achter je bureau zit. Elke OAuth-client is een eigen actor, en het bord toont de naam waarmee hij zich registreerde.

Om terug te lezen wat een agent deed, zie wat heeft mijn AI-agent gedaan?

Wat gaat er mis, en hoe los ik het op?

Niet aangemeld

Meldt Claude Code dat weft authenticatie nodig heeft, typ dan /mcp, selecteer weft en authenticeer. Heb je de client ontkoppeld in Instellingen → Gekoppelde AI-clients van Weft, dan worden zijn oude tokens bij de volgende aanroep geweigerd, dus meld je op dezelfde manier opnieuw aan.

Weft-tools staan niet in de lijst

Voer claude mcp list uit en controleer of weft erin staat met de URL https://letsweft.com/api/mcp. De server geldt per project, tenzij je hem met --scope user hebt toegevoegd, dus in een andere map staat hij misschien niet.

already_claimed

Dit is een antwoord, geen fout. Een andere client heeft een actieve lease op die taak. De agent hoort ander werk te kiezen. Weet je dat de andere sessie dood is, wacht dan: de lease verloopt binnen 20 minuten en de taak komt vrij.

attention_queue_full

Er wacht te veel afgerond of geblokkeerd werk op je: 5 items in een werkruimte voor één persoon of 10 in een team, of 45 minuten aan geschatte beoordeling, wat het eerst bereikt wordt. Vragen tellen ook mee. start_task weigert tot je een deel van de Inbox hebt weggewerkt. Het antwoord somt op wat de agent nog wel kan doen (report_progress, get_my_work, get_board_state, search), zodat hij kan afmaken of opruimen in plaats van meer te beginnen.

Aanroepen stoppen op het Free-plan

Free bevat 200 AI-aanroepen per maand, en de eerste 48 uur na aanmelden worden niet geteld. Een lange sessie met elke vijf minuten een heartbeat verbruikt gestaag aanroepen. Pro haalt de limiet weg; zie prijzen.

Hoe verhoudt dit zich tot een TODO.md, GitHub Issues of Hypertask?

Feiten over GitHub linken naar de docs en de prijspagina van GitHub; feiten over Hypertask linken naar hun docs. Voor een bredere tabel, zie MCP-taakmanagers vergeleken.

Een TODO.md is het juiste antwoord voor één developer op één repo: geversioneerd met de code, geen account, geen authenticatie. Het loopt spaak wanneer twee sessies het bewerken, of wanneer je een vraag vanaf je telefoon wilt beantwoorden.

GitHub Issues is de natuurlijke plek wanneer je werk al uit issues en pull requests bestaat en iedereen in het team op GitHub leeft. Weft heeft geen integratie met GitHub, dus links naar commits en PR's reizen mee als artifacts op het bewijsstuk in plaats van via synchronisatie.

Hypertask is de betere keuze als je een CLI wilt voor hooks en CI, een REST API, agents als serviceaccounts met een eigen identiteit, ingebouwde AI-functies, tijdregistratie of een app die op het toetsenbord is gebouwd. Weft heeft geen CLI, geen openbare API en geen tijdregistratie. Waar Weft verschilt: de claim, de heartbeat en de vraag aan de persoon zijn MCP-tools die Claude Code rechtstreeks aanroept, het aanmelden gaat via OAuth met vernieuwing, en hetzelfde bord zit in ChatGPT en in beide appstores. Meer in onze vergelijking met Hypertask.

Heb ik een API-sleutel nodig voor Claude Code?

Nee. Claude Code meldt zich aan met OAuth in de browser, en Weft geeft refresh-tokens uit zodat de client de aanmelding zelf vernieuwt. Persoonlijke toegangstokens bestaan voor clients die geen OAuth kunnen, maar Claude Code heeft er geen nodig.

Zet Claude Code mijn taken zonder mij op Done?

Standaard wel: complete_task verplaatst de taak met zijn bewijsstuk naar Done. Een taak die beoordeling nodig heeft, of waarvan de verificatiecontrole faalt, stopt in plaats daarvan in je Inbox voor Accepteren, Herwerken, Later of Laten vallen.

Kan ik voorkomen dat Claude Code dingen verwijdert?

Zet de verbinding op write op het toestemmingsscherm, of later in Instellingen → Gekoppelde AI-clients. Write staat alles toe behalve de drie destructieve tools (trash_task, archive_done_tasks, complete_sprint). Read staat alleen de 11 tools toe die alleen lezen. Agents kunnen taken hoe dan ook niet definitief verwijderen; de prullenbak bewaart ze 30 dagen, en herstellen uit de prullenbak is een Pro-functie.

Rekent Weft bovenop Claude nog iets voor AI?

Nee. Weft heeft geen AI-credits: het denkwerk gebeurt in Claude Code, onder je eigen Claude-plan. Weft telt toolaanroepen: 200 per maand op Free, onbeperkt op Pro voor $7 per plek per maand of $60 per jaar. Zie prijzen.

Wat als ik mijn taken al in Linear, Jira, Notion of Trello bijhoud?

Importeren is gratis op elk plan: CSV-exports uit Linear, Jira of Notion, of een Trello-bord als JSON. Claude Code kan ook veel taken tegelijk aanmaken met bulk_create_tasks.

Werkt Weft naast Claude Code ook met andere codeeragents?

Ja. Er zijn 33 setuppagina's voor clients, waaronder Cursor, Codex en ChatGPT. Ze bereiken allemaal hetzelfde bord via hetzelfde endpoint.