Blog

Nástěnka úkolů pro Claude Code: skutečné nastavení za dvě minuty přes MCP

Připojte Claude Code k nástěnce Weftu jedním příkazem a přihlášením v prohlížeči a pak přidejte blok do CLAUDE.md, aby si úkoly převzal, hlásil průběh a uzavíral je.

Weft je AI správce úkolů pro samostatné zakladatele a malé týmy.

Všechny články

Autor: Andrei Finogeev ·

Aby měl Claude Code nástěnku úkolů, spusťte jeden příkaz, claude mcp add --transport http weft https://letsweft.com/api/mcp, a při prvním připojení Claude Code se přihlaste do Weftu v prohlížeči. Žádný klíč ke kopírování, nic k vkládání do konfiguračního souboru. Pak už stačí krátký blok v CLAUDE.md a Claude Code si úkol převezme dřív, než začne upravovat kód, během práce hlásí průběh a po dokončení zanechá doklad.

Weft vyvíjíme my. Údaje o ostatních produktech pocházejí z jejich oficiálních stránek, ověřeno 27. října 2026.

Co dá nástěnka Claude Code, co terminál nedá?

Claude Code zná repozitář, který má před sebou, ale neví, kdo další na něm pracuje ani který úkol začala relace, jež spadla. Nástěnka drží tento stav mimo jakoukoli jednotlivou relaci, takže člověk, druhé okno Claude Code i chat v ChatGPT vidí totéž.

Nepotřebujete ji pro každý repozitář. Jeden člověk, jedna krátká relace a TODO seznam často stačí. Nástěnka se začne vyplácet, když práce zabere několik relací nebo několik agentů, nebo když se člověk musí na výsledky podívat, než začnou platit.

Jak připojit Claude Code k Weftu za dvě minuty?

  1. Založte si bezplatný účet na letsweft.com. Nová nástěnka začíná se čtyřmi sloupci: Backlog, Todo, Doing a Done.
  2. V terminálu spusťte claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code uloží server pro aktuální projekt; přidejte --scope user, pokud ho chcete ve všech projektech (viz dokumentace Anthropicu k MCP v Claude Code).
  3. Spusťte claude. Při prvním použití Weftu se otevře okno prohlížeče pro OAuth. Pokud se neotevře, napište /mcp, vyberte weft a přihlaste se odtud.
  4. Na obrazovce souhlasu Weftu zvolte, co toto připojení smí: plný přístup, zápis (všechno kromě tří destruktivních nástrojů) nebo čtení. Později to můžete změnit v nastavení v sekci připojených AI klientů.
  5. Zpátky v Claude Code se zeptejte: „Co mám na nástěnce?“

Endpoint mluví MCP přes Streamable HTTP a vystavuje 32 nástrojů. Weft vydává refresh tokeny, takže klient si přihlášení obnovuje sám. Pokud používáte klienta, který OAuth neumí, funguje i osobní přístupový token, Claude Code ho ale nepotřebuje. Kompletní stránka s nastavením je na letsweft.com/claude-code.

Jak ověřit, že to funguje, aniž by mohl cokoli změnit?

První prompt udělejte jen pro čtení. Dozvíte se tak, že jsou nástroje načtené a přihlášení vedlo do správného pracovního prostoru, a na nástěnce se nic nepohne:

Vypiš moji nástěnku ve Weftu: sloupce, co je v Doing a co čeká na mě.
Nic neměň.

Claude Code by měl zavolat get_board_state nebo get_my_work. Oba nástroje jsou jen pro čtení. Pokud chcete při zvykání bezpečnostní rezervu, nastavte na obrazovce souhlasu připojení na čtení: zápisová volání se pak odmítají a odmítnutá volání se do měsíční kvóty nepočítají.

Jedna poctivá cena: definice 32 nástrojů zaberou zhruba 18 000 tokenů kontextu Claude Code.

Jak vypadá jeden převzatý úkol?

Dejte do Todo malý skutečný úkol, třeba „oprav nestabilní test s datem“, a požádejte Claude Code, ať si ho vezme. Dobrý průběh vypadá takto:

  1. get_my_work vrátí, co už tomuto klientovi patří, co čeká na vás a zda je prostor cokoli začít.
  2. start_task úkol převezme, přesune ho do Doing a vrátí runId a leaseToken. Odpověď agentovi zároveň řekne, ať lease obnovuje každých 300 sekund.
  3. Claude Code pracuje v repozitáři jako obvykle. Každých pár minut zavolá report_progress, který lease obnoví.
  4. Když narazí na rozhodnutí, které můžete udělat jen vy, zavolá request_input s možnostmi. Claude Code otázku ukáže jako své nativní karty s možnostmi; odpověď se vrátí přes submit_answer.
  5. complete_task uzavře běh s výsledkem, artefakty jako hash commitu a výstup testů a s tím, co neudělal.

Ve výchozím stavu jde dokončený úkol rovnou do Done. Ve vašem Inboxu se místo toho zastaví, když úkol potřebuje kontrolu nebo neprojde ověření. Tam zvolíte Přijmout, Přepracovat, Později nebo Zahodit. Pokud agent předal nextStep, třeba „mergni PR #12“, Přijmout schválí přesně tento krok a ten se vrátí agentovi k provedení.

Celá smyčka se všemi odmítnutími a poli je v průvodci smyčkou převzetí.

Co dát do CLAUDE.md?

Popisy nástrojů tato pravidla už obsahují; pár řádků v CLAUDE.md z nich udělá zvyk repozitáře. Vložte a upravte:

## Nástěnka úkolů Weft

Weft (MCP server "weft") je sdílená nástěnka tohoto repozitáře. Čtou ji i jiní
AI klienti a lidé, takže ji udržuj pravdivou.

- Na začátku relace zavolej get_my_work. Pracuj na tom, co vrátí;
  nevybírej úkoly z paměti.
- Než kvůli úkolu změníš jakýkoli soubor, zavolej start_task s jeho id.
  Ulož si runId a leaseToken, které vrátí.
  - already_claimed: drží ho někdo jiný. Nezdvojuj práci; vyber jiný.
  - attention_queue_full: nezkoušej to znovu. Udělej, co navrhuje odpověď
    (dokonči nebo vyjasni rozdělanou práci).
- Během práce volej report_progress s runId a leaseToken zhruba každých
  5 minut a u každého skutečného milníku (testy zelené, PR otevřený).
- request_input volej jen u rozhodnutí, která musí udělat člověk: cokoli
  nevratného (produkce, peníze, publikování, mazání dat) nebo skutečné rozcestí
  bez rozumné výchozí volby. Dej možnosti. Nikdy se neptej, jestli můžeš pokračovat.
- Po dokončení zavolej complete_task s:
  - outcome: jedna nebo dvě věty o tom, co se změnilo
  - artifacts: hash commitu, URL PR, testovací příkaz a jeho výsledek
  - notDone: co jsi přeskočil nebo nechal na později
  - unknowns: co se ti nepodařilo ověřit
  - nextStep: jediný krok, který bys udělal, pokud člověk přijme
- Pokud skončíš bez dokončení, řekni to a nech úkol v Doing.

Artefakty dělají z „hotovo“ něco, co můžete zkontrolovat. Volání nikdy neselže kvůli chybějícím důkazům, protože ztratit hotovou práci je horší než ji zaznamenat neověřenou.

Co se stane, když relace Claude Code spadne uprostřed úkolu?

Nikdo po ní nemusí uklízet. Převzetí je lease, ne příznak. start_task přidělí 20 minut a každé report_progress je obnoví. Relace, která spadne, ztratí síť nebo se zavře, nemůže hlásit, takže signálem je ticho.

  • Po 20 minutách bez heartbeatu je běh označen jako zastaralý, lease token se vymaže a úkol se vrátí mezi nepřiřazené.
  • Úklid běží každých 10 minut a úkol se uvolní okamžitě i tehdy, když se ho pokusí převzít jiný klient.
  • Běh, který čeká na vaši odpověď, si převzetí drží 60 minut. Pak lease odpadne, ale otázka zůstane otevřená ve vašem Inboxu.
  • O převzetí rozhoduje databáze, takže dvě okna Claude Code, která se perou o stejný úkol, nemůžou vyhrát obě. Poražené dostane already_claimed s id a názvem úkolu.

Souběh několika agentů popisuje článek více AI agentů na jedné nástěnce.

Uvidím stejnou nástěnku i z ChatGPT nebo z telefonu?

Ano. Je to jedna nástěnka za jedním endpointem. Weft je zveřejněná aplikace v ChatGPT ve všech tarifech, včetně bezplatného (nastavení), takže se můžete ChatGPT zeptat, co Claude Code dokončil přes noc. Cursor se instaluje jedním kliknutím (nastavení) a Codex používá položku v konfiguraci plus codex mcp login weft (nastavení). Na claude.ai a v Claude Desktop se Weft přidává jako vlastní konektor.

Weft má i aplikace pro iOS a Android. Když vám do fronty dorazí úkol, telefon dostane push, nejvýš jeden na pracovní prostor za 10 minut, takže otázka od Claude Code vás zastihne i mimo stůl. Každý OAuth klient je samostatný aktér a nástěnka ukazuje jméno, pod kterým se zaregistroval.

Jak zpětně zjistit, co agent udělal, popisuje článek co udělal můj AI agent?

Co se může pokazit a jak to opravit?

Nepřihlášeno

Pokud Claude Code hlásí, že weft potřebuje přihlášení, napište /mcp, vyberte weft a přihlaste se. Pokud jste klienta odpojili v nastavení Weftu v sekci připojených AI klientů, jeho staré tokeny se při dalším volání odmítnou, takže se přihlaste znovu stejným způsobem.

Nástroje Weftu nejsou v seznamu

Spusťte claude mcp list a ověřte, že je tam weft s URL https://letsweft.com/api/mcp. Server je pro každý projekt zvlášť, pokud jste ho nepřidali s --scope user, takže v jiné složce být nemusí.

already_claimed

To je odpověď, ne chyba. Jiný klient má na ten úkol živý lease. Agent by si měl vybrat jinou práci. Pokud víte, že druhá relace je mrtvá, počkejte: lease do 20 minut propadne a úkol se uvolní.

attention_queue_full

Na vás čeká příliš mnoho hotové nebo zablokované práce: 5 položek v pracovním prostoru pro jednoho, 10 v týmu, nebo 45 minut odhadované kontroly, podle toho, co nastane dřív. Počítají se i otázky. start_task odmítá, dokud část Inboxu nevyřídíte. Odpověď vypíše, co agent ještě dělat může (report_progress, get_my_work, get_board_state, search), takže může dokončovat nebo uklízet, místo aby začínal další věci.

Volání se v bezplatném tarifu zastaví

Free zahrnuje 200 volání AI měsíčně a prvních 48 hodin po registraci se nepočítá. Dlouhá relace s heartbeatem každých pět minut spotřebovává volání průběžně. Pro limit ruší; viz ceník.

Jak si to stojí proti TODO.md, GitHub Issues nebo Hypertasku?

Údaje o GitHubu odkazují na dokumentaci a ceník GitHubu; údaje o Hypertasku na jeho dokumentaci. Širší tabulku najdete ve srovnání MCP správců úkolů.

WeftTODO.md v repozitářiGitHub Issues MCPHypertask
Jak se Claude Code připojíJeden příkaz claude mcp add, Streamable HTTPŽádné připojení: Claude Code čte souborOficiální hostovaný server api.githubcopilot.com/mcp/Dokumentované nastavení: konfigurace se zkopírovaným API klíčem; Streamable HTTP na /mcp, starší SSE na /sse
Přihlášení a vypršeníOAuth v prohlížeči; refresh tokeny, takže klient si přihlášení obnovuje sám. Volitelné přístupové tokeny pro klienty bez OAuthNení potřebaOAuth nebo osobní přístupový tokenZkopírovaný klíč vyprší po 30 dnech; připojení schválené v prohlížeči vydrží 90 dní bez refresh tokenu
Převzetí s leasem přímo v MCPAno: start_task, 20minutový lease, already_claimed pro druhého agentaNe. Dvě relace můžou upravit stejný řádekV dokumentaci GitHubu není popsánoLeasy existují jako REST endpointy, ne MCP nástroje, záměrně
Dotaz na člověka během úkolurequest_input s možnostmi; Inbox a push na mobilJen v terminálu, který zrovna sledujeteKomentáře u issuesEskalace jen přes REST
Počet MCP nástrojů32ŽádnéNeuvedeno21
Stejná nástěnka z ChatGPTZveřejněná aplikace v ChatGPT, ve všech tarifech včetně bezplatnéhoNeDokumentace GitHubu nepokrýváVlastní GPT s OpenAPI Actions, nebo konektor přes developer mode podle jejich llms.txt
TelefonAplikace pro iOS a AndroidTextový souborGitHub Mobile, iOS a Android (App Store, Google Play)Žádná nativní aplikace pro iOS (webová aplikace na ploše); APK pro Android na GitHubu, bez zápisu v Play
Jazyky27VášNeuvedenoJen angličtina
CLI pro skripty a CINeJakýkoli nástroj v shelluZde neuvedenoAno, @hypertask/hypertask_cli
Cena za místoFree: 50 úkolů, 200 volání AI měsíčně. Pro: $7 měsíčně nebo $60 ročněZdarmaBezplatný tarif; placený tarif Team, viz ceník GitHubuZdarma (3 nástěnky na osobu); BYOK $8 při ročním / $10 při měsíčním placení; Pro $16 při ročním / $20 při měsíčním
Potřebné AI kredityŽádné: přemýšlí se v Claude CodeŽádnéPro issues žádnéVestavěná AI: úvodní příděl ve Free, vlastní klíče v BYOK, v ceně v Pro

TODO.md je správná odpověď pro jednoho vývojáře na jednom repozitáři: verzovaný spolu s kódem, bez účtu, bez přihlašování. Selže, když ho upravují dvě relace, nebo když chcete odpovědět na otázku z telefonu.

GitHub Issues jsou přirozený domov, když vaše práce už jsou issues a pull requesty a celý tým žije na GitHubu. Weft nemá integraci s GitHubem, takže odkazy na commity a PR putují jako artefakty v dokladu, ne přes synchronizaci.

Hypertask je lepší volba, pokud chcete CLI pro hooky a CI, REST API, agenty jako servisní účty s vlastní identitou, vestavěné AI funkce, měření času nebo aplikaci stavěnou pro klávesnici. Weft nemá CLI, veřejné API ani měření času. Weft se liší v tom, že převzetí, heartbeat i otázka na člověka jsou MCP nástroje, které Claude Code volá přímo, přihlášení je OAuth s obnovou a stejná nástěnka je v ChatGPT i v obou obchodech s mobilními aplikacemi. Víc v našem srovnání s Hypertaskem.

Potřebuju pro Claude Code API klíč?
Ne. Claude Code se přihlásí přes OAuth v prohlížeči a Weft vydává refresh tokeny, takže klient si přihlášení obnovuje sám. Osobní přístupové tokeny existují pro klienty, kteří OAuth neumí, Claude Code ho ale nepotřebuje.
Označí Claude Code moje úkoly jako Done beze mě?
Ve výchozím stavu ano: complete_task přesune úkol i s dokladem do Done. Úkol, který potřebuje kontrolu nebo jehož ověření selže, se místo toho zastaví ve vašem Inboxu s volbami Přijmout, Přepracovat, Později nebo Zahodit.
Můžu Claude Code zabránit v mazání?
Nastavte připojení na zápis na obrazovce souhlasu, nebo později v nastavení v sekci připojených AI klientů. Zápis povoluje všechno kromě tří destruktivních nástrojů (trash_task, archive_done_tasks, complete_sprint). Čtení povoluje jen 11 nástrojů jen pro čtení. Natrvalo agenti úkoly smazat nemůžou v žádném případě; koš je drží 30 dní a obnovení z koše je funkce Pro.
Účtuje si Weft za AI navíc k Claude?
Ne. Weft nemá AI kredity: přemýšlí se v Claude Code v rámci vašeho vlastního tarifu Claude. Weft počítá volání nástrojů: 200 měsíčně ve Free, neomezeně v Pro za $7 za místo měsíčně nebo $60 ročně. Viz ceník.
Co když už úkoly vedu v Linearu, Jiře, Notionu nebo Trellu?
Import je zdarma ve všech tarifech: CSV exporty z Linearu, Jiry nebo Notionu, nebo nástěnka z Trella jako JSON. Claude Code také umí založit mnoho úkolů najednou přes bulk_create_tasks.
Funguje Weft i s jinými programovacími agenty než Claude Code?
Ano. Existuje 33 stránek s nastavením klientů, včetně Cursoru, Codexu a ChatGPT. Všichni se ke stejné nástěnce dostanou přes stejný endpoint.