Aufgabenboard für Claude Code: echte Einrichtung in zwei Minuten mit MCP

Um Claude Code ein Aufgabenboard zu geben, führst du einen Befehl aus, claude mcp add --transport http weft https://letsweft.com/api/mcp, und meldest dich bei Weft im Browser an, wenn Claude Code sich zum ersten Mal verbindet. Es gibt keinen Schlüssel zu kopieren und nichts in eine Konfigurationsdatei einzufügen. Danach sorgt ein kurzer Block in CLAUDE.md dafür, dass Claude Code eine Aufgabe übernimmt, bevor es Code ändert, während der Arbeit berichtet und am Ende einen Beleg hinterlässt.

Wir entwickeln Weft. Angaben zu anderen Produkten stammen von deren offiziellen Seiten, geprüft am 27. Oktober 2026.

Was gibt ein Board Claude Code, was das Terminal nicht kann?

Claude Code kennt das Repository vor sich, aber nicht, wer sonst noch arbeitet oder welche Aufgabe eine abgestürzte Sitzung angefangen hatte. Ein Board hält diesen Zustand außerhalb jeder einzelnen Sitzung fest, sodass ein Mensch, ein zweites Claude-Code-Fenster und ein ChatGPT-Chat dasselbe sehen.

Nicht jedes Repo braucht eins. Eine Person, eine kurze Sitzung und eine TODO-Liste reichen oft. Das Board zahlt sich aus, wenn Arbeit über mehrere Sitzungen oder mehrere Agenten geht oder wenn ein Mensch Ergebnisse ansehen muss, bevor sie zählen.

Wie verbinde ich Claude Code in zwei Minuten mit Weft?

1. Leg ein kostenloses Konto auf letsweft.com an. Ein neues Board startet mit vier Spalten: Backlog, Todo, Doing und Done.
2. Führ im Terminal claude mcp add --transport http weft https://letsweft.com/api/mcp aus. Claude Code speichert den Server für das aktuelle Projekt; ergänze --scope user, wenn du ihn in jedem Projekt haben willst (siehe die MCP-Doku von Anthropic zu Claude Code).
3. Starte claude. Beim ersten Einsatz von Weft öffnet sich ein Browserfenster für OAuth. Falls nicht, tipp /mcp, wähl weft und melde dich von dort aus an.
4. Wähl auf dem Zustimmungsbildschirm von Weft, was diese Verbindung darf: full, write (alles außer den drei destruktiven Tools) oder read. Du kannst das später unter Einstellungen → Verbundene KI-Clients ändern.
5. Frag zurück in Claude Code: „Was liegt auf meinem Board?“

Der Endpunkt spricht MCP über Streamable HTTP und stellt 32 Tools bereit. Weft stellt Refresh-Tokens aus, der Client erneuert die Anmeldung also selbst. Wenn du einen Client nutzt, der kein OAuth kann, funktioniert auch ein persönliches Zugriffstoken, aber Claude Code braucht keins. Die vollständige Einrichtungsseite findest du unter letsweft.com/claude-code.

Wie prüfe ich, ob es funktioniert, ohne dass es etwas ändert?

Mach den ersten Prompt rein lesend. So siehst du, dass die Tools geladen sind und die Anmeldung im richtigen Workspace gelandet ist, und auf dem Board bewegt sich nichts:

Zeig mir mein Weft-Board: Spalten, was in Doing liegt und was auf mich wartet.
Ändere nichts.

Claude Code sollte get_board_state oder get_my_work aufrufen. Beide sind rein lesende Tools. Wenn du dir am Anfang einen Sicherheitspuffer wünschst, stell die Verbindung auf dem Zustimmungsbildschirm auf read: Schreibende Aufrufe werden dann abgelehnt, und abgelehnte Aufrufe zählen nicht gegen dein Monatskontingent.

Ein ehrlicher Preis: Die 32 Tool-Definitionen belegen rund 18.000 Tokens im Kontext von Claude Code.

Wie sieht eine übernommene Aufgabe aus?

Leg eine kleine, echte Aufgabe in Todo, zum Beispiel „den wackligen Datumstest reparieren“, und bitte Claude Code, sie zu nehmen. Ein guter Lauf sieht so aus:

1. get_my_work liefert, was diesem Client schon gehört, was auf dich wartet und ob überhaupt Platz ist, etwas zu starten.
2. start_task übernimmt die Aufgabe, schiebt sie nach Doing und liefert eine runId und ein leaseToken. Die Antwort sagt dem Agenten außerdem, dass er alle 300 Sekunden verlängern soll.
3. Claude Code arbeitet wie gewohnt im Repo. Alle paar Minuten ruft es report_progress auf, was das Lease verlängert.
4. Wenn es auf eine Entscheidung stößt, die nur du treffen kannst, ruft es request_input mit Optionen auf. Claude Code zeigt die Frage als seine eigenen Optionskarten; die Antwort geht über submit_answer zurück.
5. complete_task schließt den Lauf mit einem Ergebnis ab, mit Artefakten wie dem Commit-Hash und der Testausgabe und mit dem, was es nicht getan hat.

Standardmäßig geht eine abgeschlossene Aufgabe direkt nach Done. Sie hält stattdessen in deiner Inbox an, wenn die Aufgabe eine Prüfung braucht oder ein Verifizierungscheck fehlschlägt. Dort wählst du Annehmen, Überarbeiten, Später oder Verwerfen. Wenn der Agent einen nextStep mitgegeben hat, etwa „PR #12 mergen“, genehmigt Annehmen genau diesen Schritt, und er geht zur Ausführung an den Agenten zurück.

Den ganzen Kreislauf mit jeder Ablehnung und jedem Feld beschreibt der Leitfaden zum Übernahme-Kreislauf.

Was gehört in CLAUDE.md?

Die Tool-Beschreibungen enthalten diese Regeln schon; ein paar Zeilen in CLAUDE.md machen sie zur Gewohnheit des Repos. Einfügen und anpassen:

## Weft-Aufgabenboard

Weft (MCP-Server "weft") ist das gemeinsame Board für dieses Repo. Andere KI-Clients
und Menschen lesen es auch, also halte es wahr.

- Ruf zu Beginn einer Sitzung get_my_work auf. Arbeite an dem, was es liefert;
  nimm keine Aufgaben aus dem Gedächtnis.
- Bevor du für eine Aufgabe irgendeine Datei änderst, ruf start_task mit ihrer id auf.
  Behalte die runId und das leaseToken, die es zurückgibt.
  - already_claimed: Jemand anderes hält sie. Nicht doppelt arbeiten; nimm eine andere.
  - attention_queue_full: nicht erneut versuchen. Tu, was die Antwort vorschlägt
    (vorhandene Arbeit abschließen oder klären).
- Ruf während der Arbeit etwa alle 5 Minuten report_progress mit runId und leaseToken auf,
  und an jedem echten Zwischenstand (Tests grün, PR eröffnet).
- Ruf request_input nur für Entscheidungen auf, die der Mensch treffen muss: alles
  Unumkehrbare (Produktion, Geld, Veröffentlichen, Daten löschen) oder eine echte Gabelung
  ohne sinnvolle Voreinstellung. Gib Optionen an. Frag nie um Erlaubnis weiterzumachen.
- Wenn du fertig bist, ruf complete_task auf mit:
  - outcome: ein oder zwei Sätze dazu, was sich geändert hat
  - artifacts: Commit-Hash, PR-URL, Testbefehl und sein Ergebnis
  - notDone: was du übersprungen oder für später gelassen hast
  - unknowns: was du nicht prüfen konntest
  - nextStep: der eine Schritt, den du gehen würdest, wenn der Mensch annimmt
- Wenn du aufhörst, ohne fertig zu sein, sag das und lass die Aufgabe in Doing.

Artefakte machen aus „erledigt“ etwas, das du prüfen kannst. Der Aufruf scheitert nie an fehlenden Belegen, denn fertige Arbeit zu verlieren ist schlimmer, als sie ungeprüft festzuhalten.

Was passiert, wenn eine Claude-Code-Sitzung mitten in der Aufgabe stirbt?

Niemand muss hinterher aufräumen. Die Übernahme ist ein Lease, keine Markierung. start_task gewährt 20 Minuten, und jedes report_progress verlängert sie. Eine Sitzung, die abstürzt, das Netz verliert oder geschlossen wird, kann nicht berichten, also ist Stille das Signal.

• Nach 20 Minuten ohne Lebenszeichen wird der Lauf als veraltet markiert, das Lease-Token gelöscht, und die Aufgabe ist wieder niemandem zugewiesen.
• Alle 10 Minuten läuft eine Bereinigung, und die Aufgabe wird auch sofort frei, wenn ein anderer Client versucht, sie zu übernehmen.
• Ein Lauf, der auf deine Antwort wartet, behält seine Übernahme 60 Minuten lang. Danach fällt das Lease weg, aber die Frage bleibt in deiner Inbox offen.
• Übernahmen entscheidet die Datenbank, also können zwei Claude-Code-Fenster, die um dieselbe Aufgabe konkurrieren, nicht beide gewinnen. Der Verlierer bekommt already_claimed mit der id und dem Titel der Aufgabe.

Wie du mehrere Agenten gleichzeitig laufen lässt, beschreibt der Artikel über mehrere KI-Agenten auf einem Board.

Sehe ich dasselbe Board aus ChatGPT oder auf dem Handy?

Ja. Es ist ein Board hinter einem Endpunkt. Weft ist eine veröffentlichte App in ChatGPT, in jedem Tarif einschließlich Free (Einrichtung), du kannst ChatGPT also fragen, was Claude Code über Nacht erledigt hat. Cursor installierst du mit einem Klick (Einrichtung), und Codex nutzt einen Konfigurationseintrag plus codex mcp login weft (Einrichtung). Auf claude.ai und in Claude Desktop wird Weft als eigener Connector hinzugefügt.

Weft hat außerdem Apps für iOS und Android. Wenn eine Aufgabe in deiner Warteschlange landet, bekommt das Handy eine Push-Nachricht, höchstens eine pro Workspace alle 10 Minuten, sodass dich eine Frage von Claude Code auch fern vom Schreibtisch erreicht. Jeder OAuth-Client ist ein eigener Akteur, und das Board zeigt den Namen, mit dem er sich registriert hat.

Wie du nachliest, was ein Agent getan hat, steht unter Was hat mein KI-Agent gemacht?

Was geht schief, und wie behebe ich es?

Nicht angemeldet

Wenn Claude Code meldet, dass weft eine Anmeldung braucht, tipp /mcp, wähl weft und melde dich an. Wenn du den Client in Weft unter Einstellungen → Verbundene KI-Clients getrennt hast, werden seine alten Tokens beim nächsten Aufruf abgelehnt; melde dich dann auf demselben Weg neu an.

Die Weft-Tools tauchen nicht auf

Führ claude mcp list aus und prüf, dass weft mit der URL https://letsweft.com/api/mcp dabei ist. Der Server gilt pro Projekt, solange du ihn nicht mit --scope user hinzugefügt hast, in einem anderen Ordner fehlt er also womöglich.

already_claimed

Das ist eine Antwort, kein Fehler. Ein anderer Client hält ein aktives Lease auf diese Aufgabe. Der Agent sollte andere Arbeit nehmen. Wenn du weißt, dass die andere Sitzung tot ist, warte: Das Lease läuft innerhalb von 20 Minuten ab, und die Aufgabe wird frei.

attention_queue_full

Zu viel fertige oder blockierte Arbeit wartet auf dich: 5 Einträge in einem Ein-Personen-Workspace oder 10 im Team, oder 45 Minuten geschätzter Prüfaufwand, je nachdem, was zuerst eintritt. Fragen zählen mit. start_task lehnt ab, bis du einen Teil der Inbox abgearbeitet hast. Die Antwort listet, was der Agent noch tun kann (report_progress, get_my_work, get_board_state, search), sodass er abschließen oder aufräumen kann, statt mehr anzufangen.

Aufrufe stoppen im Free-Tarif

Free enthält 200 KI-Aufrufe im Monat, und die ersten 48 Stunden nach der Registrierung werden nicht gezählt. Eine lange Sitzung mit einem Lebenszeichen alle fünf Minuten verbraucht stetig Aufrufe. Pro hebt die Grenze auf; siehe Preise.

Wie schlägt sich das gegen eine TODO.md, GitHub Issues oder Hypertask?

Angaben zu GitHub verlinken auf die Doku und die Preisseite von GitHub, Angaben zu Hypertask auf dessen Doku. Eine breitere Tabelle findest du unter MCP-Aufgabenmanager im Vergleich.

Eine TODO.md ist die richtige Antwort für einen Entwickler in einem Repo: mit dem Code versioniert, kein Konto, keine Anmeldung. Sie kommt an ihre Grenzen, wenn zwei Sitzungen sie bearbeiten oder wenn du eine Frage vom Handy aus beantworten willst.

GitHub Issues ist das natürliche Zuhause, wenn deine Arbeit ohnehin aus Issues und Pull Requests besteht und alle im Team auf GitHub leben. Weft hat keine GitHub-Integration, Commit- und PR-Links reisen also als Artefakte auf dem Beleg mit, nicht per Synchronisation.

Hypertask ist die bessere Wahl, wenn du eine CLI für Hooks und CI willst, eine REST-API, Agenten als Dienstkonten mit eigener Identität, eingebaute KI-Funktionen, Zeiterfassung oder eine App, die auf die Tastatur ausgelegt ist. Weft hat keine CLI, keine öffentliche API und keine Zeiterfassung. Der Unterschied bei Weft: Übernahme, Lebenszeichen und Frage an den Menschen sind MCP-Tools, die Claude Code direkt aufruft, die Anmeldung ist OAuth mit Refresh, und dasselbe Board ist in ChatGPT und in beiden App-Stores. Mehr in unserem Vergleich mit Hypertask.

Brauche ich für Claude Code einen API-Schlüssel?

Nein. Claude Code meldet sich per OAuth im Browser an, und Weft stellt Refresh-Tokens aus, sodass der Client die Anmeldung selbst erneuert. Persönliche Zugriffstokens gibt es für Clients, die kein OAuth können, aber Claude Code braucht keins.

Setzt Claude Code meine Aufgaben ohne mich auf Done?

Standardmäßig ja: complete_task schiebt die Aufgabe mit ihrem Beleg nach Done. Eine Aufgabe, die eine Prüfung braucht oder deren Verifizierungscheck fehlschlägt, hält stattdessen in deiner Inbox an, zum Annehmen, Überarbeiten, Später oder Verwerfen.

Kann ich Claude Code am Löschen hindern?

Stell die Verbindung auf dem Zustimmungsbildschirm auf write, oder später unter Einstellungen → Verbundene KI-Clients. write erlaubt alles außer den drei destruktiven Tools (trash_task, archive_done_tasks, complete_sprint). read erlaubt nur die 11 lesenden Tools. Endgültig löschen können Agenten Aufgaben ohnehin nicht; der Papierkorb hält sie 30 Tage, und Wiederherstellen aus dem Papierkorb ist eine Pro-Funktion.

Berechnet Weft zusätzlich zu Claude etwas für KI?

Nein. Weft hat keine KI-Credits: Das Denken passiert in Claude Code über deinen eigenen Claude-Tarif. Weft zählt Tool-Aufrufe: 200 im Monat in Free, unbegrenzt in Pro für € 7,74 pro Platz und Monat oder € 65,45 im Jahr. Siehe Preise.

Was, wenn ich Aufgaben schon in Linear, Jira, Notion oder Trello habe?

Der Import ist in jedem Tarif kostenlos: CSV-Exporte aus Linear, Jira oder Notion oder ein Trello-Board als JSON. Claude Code kann auch mit bulk_create_tasks viele Aufgaben auf einmal anlegen.

Funktioniert Weft auch mit anderen Coding-Agenten außer Claude Code?

Ja. Es gibt Einrichtungsseiten für 33 Clients, darunter Cursor, Codex und ChatGPT. Alle erreichen dasselbe Board über denselben Endpunkt.