Blog

Tablica zadań dla Claude Code: prawdziwa konfiguracja w dwie minuty przez MCP

Podłącz Claude Code do tablicy zadań Weft jednym poleceniem i logowaniem w przeglądarce, a potem dodaj blok w CLAUDE.md, by przejmował, raportował i zamykał zadania.

Weft to menedżer zadań z AI dla samodzielnych założycieli i małych zespołów.

Wszystkie artykuły

Autor: Andrei Finogeev ·

Żeby dać Claude Code tablicę zadań, uruchom jedno polecenie, claude mcp add --transport http weft https://letsweft.com/api/mcp, a potem zaloguj się do Weft w przeglądarce, gdy Claude Code połączy się po raz pierwszy. Nie ma klucza do kopiowania ani niczego do wklejania w plik konfiguracyjny. Potem krótki blok w CLAUDE.md sprawia, że Claude Code przejmuje zadanie, zanim zacznie edytować kod, raportuje w trakcie pracy i zostawia pokwitowanie, gdy kończy.

Weft robimy my. Fakty o innych produktach pochodzą z ich oficjalnych stron, sprawdzonych 27 października 2026 r.

Co tablica daje Claude Code, czego nie daje terminal?

Claude Code zna repozytorium, które ma przed sobą, ale nie wie, kto jeszcze nad nim pracuje ani które zadanie zaczęła sesja, która się wysypała. Tablica trzyma ten stan poza jakąkolwiek pojedynczą sesją, więc człowiek, drugie okno Claude Code i czat w ChatGPT widzą to samo.

Nie potrzebujesz jej w każdym repozytorium. Jedna osoba, jedna krótka sesja i lista TODO często wystarczą. Tablica zaczyna się opłacać, gdy praca rozciąga się na kilka sesji lub kilku agentów albo gdy człowiek musi obejrzeć wyniki, zanim zostaną uznane.

Jak w dwie minuty podłączyć Claude Code do Weft?

  1. Załóż darmowe konto na letsweft.com. Nowa tablica startuje z czterema kolumnami: Backlog, Todo, Doing i Done.
  2. W terminalu uruchom claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code zapisuje serwer dla bieżącego projektu; dodaj --scope user, jeśli chcesz go mieć w każdym projekcie (zobacz dokumentację MCP Claude Code od Anthropic).
  3. Uruchom claude. Przy pierwszym użyciu Weft otworzy się okno przeglądarki z OAuth. Jeśli się nie otworzy, wpisz /mcp, wybierz weft i uwierzytelnij się stamtąd.
  4. Na ekranie zgody Weft wybierz, co to połączenie może robić: pełny dostęp, zapis (wszystko poza trzema destrukcyjnymi narzędziami) albo odczyt. Możesz to później zmienić w Ustawieniach → Podłączeni klienci AI.
  5. Wróć do Claude Code i zapytaj: „Co mam na tablicy?”

Endpoint mówi MCP przez Streamable HTTP i udostępnia 32 narzędzia. Weft wydaje tokeny odświeżania, więc klient sam odnawia logowanie. Jeśli używasz klienta, który nie obsługuje OAuth, zadziała też osobisty token dostępu, ale Claude Code go nie potrzebuje. Pełna strona konfiguracji jest pod letsweft.com/claude-code.

Jak sprawdzić, że działa, nie pozwalając mu niczego zmieniać?

Pierwszy prompt niech będzie tylko do odczytu. Dowiesz się, że narzędzia się załadowały, a logowanie trafiło do właściwej przestrzeni roboczej, i nic na tablicy się nie ruszy:

Pokaż moją tablicę Weft: kolumny, co jest w Doing i co czeka na mnie.
Niczego nie zmieniaj.

Claude Code powinien wywołać get_board_state albo get_my_work. Oba to narzędzia tylko do odczytu. Jeśli chcesz mieć margines bezpieczeństwa, zanim się przyzwyczaisz, ustaw połączenie na odczyt na ekranie zgody: wywołania zapisu są wtedy odrzucane, a odrzucone wywołania nie liczą się do miesięcznego limitu.

Jeden uczciwy koszt: definicje 32 narzędzi zajmują około 18 000 tokenów kontekstu Claude Code.

Jak wygląda jedno przejęte zadanie?

Wrzuć do Todo małe, prawdziwe zadanie, na przykład „napraw niestabilny test dat”, i poproś Claude Code, żeby je wziął. Dobry przebieg wygląda tak:

  1. get_my_work zwraca to, co już należy do tego klienta, co czeka na Ciebie i czy jest miejsce, by cokolwiek zacząć.
  2. start_task przejmuje zadanie, przenosi je do Doing i zwraca runId oraz leaseToken. Odpowiedź mówi też agentowi, żeby odnawiał co 300 sekund.
  3. Claude Code pracuje w repozytorium jak zwykle. Co kilka minut wywołuje report_progress, które odnawia dzierżawę.
  4. Jeśli trafi na decyzję, którą możesz podjąć tylko Ty, wywołuje request_input z wariantami. Claude Code pokazuje pytanie jako swoje natywne karty wyboru; odpowiedź wraca przez submit_answer.
  5. complete_task zamyka przebieg z wynikiem, artefaktami, takimi jak hash commita i wynik testów, oraz tym, czego nie zrobił.

Domyślnie ukończone zadanie trafia prosto do Done. Zatrzymuje się w Twojej Skrzynce, gdy wymaga przeglądu albo nie przejdzie kontrola weryfikacyjna. Tam wybierasz Akceptuj, Do poprawki, Później albo Odrzuć. Jeśli agent przekazał nextStep, na przykład „zmerguj PR #12”, Akceptuj zatwierdza dokładnie ten krok, a on wraca do agenta do wykonania.

Pełna pętla, z każdą odmową i każdym polem, jest w przewodniku po pętli przejęcia.

Co wpisać do CLAUDE.md?

Opisy narzędzi już niosą te reguły; kilka linii w CLAUDE.md zamienia je w nawyk repozytorium. Wklej i dostosuj:

## Tablica zadań Weft

Weft (serwer MCP "weft") to wspólna tablica tego repozytorium. Czytają ją też
inni klienci AI i ludzie, więc dbaj, żeby była prawdziwa.

- Na początku sesji wywołaj get_my_work. Pracuj nad tym, co zwróci;
  nie wybieraj zadań z pamięci.
- Zanim zmienisz jakikolwiek plik w ramach zadania, wywołaj start_task z jego id.
  Zachowaj zwrócone runId i leaseToken.
  - already_claimed: ktoś inny je trzyma. Nie dubluj; wybierz inne.
  - attention_queue_full: nie ponawiaj. Zrób to, co sugeruje odpowiedź
    (dokończ lub doprecyzuj istniejącą pracę).
- W trakcie pracy wywołuj report_progress z runId i leaseToken mniej więcej
  co 5 minut oraz w każdym prawdziwym punkcie kontrolnym (testy zielone, PR otwarty).
- Wywołuj request_input tylko dla decyzji, które musi podjąć człowiek: wszystko,
  co nieodwracalne (produkcja, pieniądze, publikacja, usuwanie danych), albo
  prawdziwe rozwidlenie bez rozsądnego domyślnego wyboru. Podaj warianty.
  Nigdy nie pytaj o pozwolenie na kontynuację.
- Po zakończeniu wywołaj complete_task z:
  - outcome: jedno lub dwa zdania o tym, co się zmieniło
  - artifacts: hash commita, URL PR, polecenie testów i jego wynik
  - notDone: co pominąłeś albo zostawiłeś na później
  - unknowns: czego nie udało się zweryfikować
  - nextStep: jeden krok, który zrobisz, jeśli człowiek zaakceptuje
- Jeśli przerywasz bez ukończenia, powiedz to i zostaw zadanie w Doing.

Artefakty zamieniają „gotowe” w coś, co możesz sprawdzić. Wywołanie nigdy nie zawodzi z powodu braku dowodów, bo utrata skończonej pracy jest gorsza niż zapisanie jej bez weryfikacji.

Co się dzieje, gdy sesja Claude Code padnie w połowie zadania?

Nic nie musi po niej sprzątać. Przejęcie to dzierżawa, a nie flaga. start_task daje 20 minut, a każde report_progress je odnawia. Sesja, która się wysypie, straci sieć albo zostanie zamknięta, nie może raportować, więc sygnałem jest cisza.

  • Po 20 minutach bez sygnału życia przebieg zostaje oznaczony jako nieaktualny, token dzierżawy jest czyszczony, a zadanie wraca do stanu nieprzypisanego.
  • Sprzątanie działa co 10 minut, a zadanie zwalnia się też od razu, gdy inny klient próbuje je przejąć.
  • Przebieg czekający na Twoją odpowiedź trzyma przejęcie przez 60 minut. Potem dzierżawa wygasa, ale pytanie zostaje otwarte w Twojej Skrzynce.
  • O przejęciach decyduje baza danych, więc dwa okna Claude Code ścigające się o to samo zadanie nie mogą wygrać obu. Przegrany dostaje already_claimed z id i tytułem zadania.

Praca kilku agentów naraz jest opisana w tekście o wielu agentach AI na jednej tablicy.

Czy tę samą tablicę widzę z ChatGPT albo z telefonu?

Tak. To jedna tablica za jednym endpointem. Weft jest opublikowaną aplikacją w ChatGPT w każdym planie, także Darmowym (konfiguracja), więc możesz zapytać ChatGPT, co Claude Code skończył w nocy. Cursor instaluje się jednym kliknięciem (konfiguracja), a Codex używa wpisu w konfiguracji plus codex mcp login weft (konfiguracja). Na claude.ai i w Claude Desktop dodajesz Weft jako własny konektor.

Weft ma też aplikacje na iOS i Androida. Gdy zadanie trafia do Twojej kolejki, telefon dostaje powiadomienie push, najwyżej jedno na przestrzeń roboczą co 10 minut, więc pytanie od Claude Code dociera do Ciebie z dala od biurka. Każdy klient OAuth to osobny wykonawca, a tablica pokazuje nazwę, pod którą się zarejestrował.

O odczytywaniu tego, co zrobił agent, przeczytasz w tekście: co zrobił mój agent AI?

Co może pójść nie tak i jak to naprawić?

Brak zalogowania

Jeśli Claude Code zgłasza, że weft wymaga uwierzytelnienia, wpisz /mcp, wybierz weft i się uwierzytelnij. Jeśli odłączyłeś klienta w Weft w Ustawieniach → Podłączeni klienci AI, jego stare tokeny są odrzucane przy następnym wywołaniu, więc zaloguj się ponownie w ten sam sposób.

Narzędzia Weft nie są widoczne

Uruchom claude mcp list i sprawdź, czy weft jest na liście z adresem https://letsweft.com/api/mcp. Serwer jest przypisany do projektu, chyba że dodałeś go z --scope user, więc w innym folderze może go nie być.

already_claimed

To odpowiedź, a nie błąd. Inny klient trzyma aktywną dzierżawę tego zadania. Agent powinien wziąć inną pracę. Jeśli wiesz, że tamta sesja nie żyje, poczekaj: dzierżawa wygaśnie w ciągu 20 minut i zadanie zostanie zwolnione.

attention_queue_full

Czeka na Ciebie za dużo skończonej lub zablokowanej pracy: 5 pozycji w jednoosobowej przestrzeni roboczej albo 10 w zespole, albo 45 minut szacowanego przeglądania — co nastąpi pierwsze. Pytania też się liczą. start_task odmawia, dopóki nie opróżnisz części Skrzynki. Odpowiedź wymienia, co agent nadal może robić (report_progress, get_my_work, get_board_state, search), więc może dokończyć albo posprzątać, zamiast zaczynać kolejne rzeczy.

Wywołania przestają działać w planie Darmowym

Darmowy plan obejmuje 200 wywołań AI miesięcznie, a pierwsze 48 godzin po rejestracji się nie liczy. Długa sesja z sygnałem życia co pięć minut systematycznie zużywa wywołania. Pro znosi limit; zobacz cennik.

Jak to wypada na tle TODO.md, GitHub Issues albo Hypertask?

Fakty o GitHubie prowadzą do dokumentacji i cennika GitHuba; fakty o Hypertask — do ich dokumentacji. Szerszą tabelę znajdziesz w porównaniu menedżerów zadań MCP.

WeftTODO.md w repozytoriumGitHub Issues MCPHypertask
Jak łączy się Claude CodeJedno polecenie claude mcp add, Streamable HTTPBez połączenia: Claude Code czyta plikOficjalny hostowany serwer api.githubcopilot.com/mcp/Udokumentowana konfiguracja: plik ze skopiowanym kluczem API; Streamable HTTP pod /mcp, starszy SSE pod /sse
Logowanie i wygasanieOAuth w przeglądarce; tokeny odświeżania, więc klient sam odnawia logowanie. Opcjonalne tokeny dostępu dla klientów bez OAuthNiepotrzebneOAuth albo osobisty token dostępuSkopiowany klucz wygasa po 30 dniach; połączenie zatwierdzone w przeglądarce trwa 90 dni bez tokenu odświeżania
Przejęcie z dzierżawą w MCPTak: start_task, 20-minutowa dzierżawa, already_claimed dla drugiego agentaNie. Dwie sesje mogą edytować tę samą linięNieopisane w dokumentacji GitHubaDzierżawy istnieją jako endpointy REST, nie narzędzia MCP, celowo
Pytanie człowieka w trakcie zadaniarequest_input z wariantami; Skrzynka i push na telefonTylko w terminalu, na który akurat patrzyszKomentarze w zgłoszeniachEskalacja tylko przez REST
Liczba narzędzi MCP32BrakNie podano21
Ta sama tablica z ChatGPTOpublikowana aplikacja ChatGPT, każdy plan, także DarmowyNieNieopisane w dokumentacji GitHubaWłasny GPT z akcjami OpenAPI albo konektor w trybie dewelopera według ich llms.txt
TelefonAplikacje iOS i AndroidPlik tekstowyGitHub Mobile, iOS i Android (App Store, Google Play)Brak natywnej aplikacji iOS (aplikacja webowa na ekranie początkowym); APK na Androida na GitHubie, bez wpisu w Play
Języki27TwójNie podanoTylko angielski
CLI do skryptów i CINieDowolne narzędzie powłokiTu nie podanoTak, @hypertask/hypertask_cli
Cena za stanowiskoDarmowy: 50 zadań, 200 wywołań AI miesięcznie. Pro: $7 miesięcznie albo $60 rocznieZa darmoPlan darmowy; płatny plan Team, zobacz cennik GitHubaDarmowy (3 tablice na osobę); BYOK $8 rocznie / $10 miesięcznie; Pro $16 rocznie / $20 miesięcznie
Potrzebne kredyty AIBrak: myślenie odbywa się w Claude CodeBrakBrak dla zgłoszeńWbudowane AI: startowa pula w Darmowym, własne klucze w BYOK, w cenie w Pro

TODO.md to właściwa odpowiedź dla jednego programisty w jednym repozytorium: wersjonowany razem z kodem, bez konta, bez uwierzytelniania. Przestaje działać, gdy edytują go dwie sesje albo gdy chcesz odpowiedzieć na pytanie z telefonu.

GitHub Issues to naturalny dom, gdy Twoja praca już jest zgłoszeniami i pull requestami, a cały zespół żyje na GitHubie. Weft nie ma integracji z GitHubem, więc linki do commitów i PR-ów trafiają do pokwitowania jako artefakty, a nie przez synchronizację.

Hypertask jest lepszym wyborem, jeśli chcesz CLI do hooków i CI, REST API, agentów jako kont usługowych z własną tożsamością, wbudowanych funkcji AI, śledzenia czasu albo aplikacji pod klawiaturę. Weft nie ma CLI, publicznego API ani śledzenia czasu. Weft różni się tym, że przejęcie, sygnał życia i pytanie do człowieka to narzędzia MCP, które Claude Code wywołuje bezpośrednio, logowanie to OAuth z odświeżaniem, a ta sama tablica jest w ChatGPT i w obu sklepach z aplikacjami. Więcej w naszym porównaniu z Hypertask.

Czy potrzebuję klucza API dla Claude Code?
Nie. Claude Code loguje się przez OAuth w przeglądarce, a Weft wydaje tokeny odświeżania, więc klient sam odnawia logowanie. Osobiste tokeny dostępu istnieją dla klientów, które nie obsługują OAuth, ale Claude Code ich nie potrzebuje.
Czy Claude Code będzie oznaczał moje zadania jako Done beze mnie?
Domyślnie tak: complete_task przenosi zadanie do Done razem z pokwitowaniem. Zadanie, które wymaga przeglądu albo nie przejdzie kontroli weryfikacyjnej, zatrzymuje się zamiast tego w Twojej Skrzynce na Akceptuj, Do poprawki, Później albo Odrzuć.
Czy mogę zabronić Claude Code usuwania rzeczy?
Ustaw połączenie na zapis na ekranie zgody albo później w Ustawieniach → Podłączeni klienci AI. Zapis pozwala na wszystko poza trzema destrukcyjnymi narzędziami (trash_task, archive_done_tasks, complete_sprint). Odczyt pozwala tylko na 11 narzędzi tylko do odczytu. Agenci i tak nie mogą usunąć zadań na dobre; kosz trzyma je przez 30 dni, a przywracanie z kosza to funkcja Pro.
Czy Weft pobiera opłaty za AI ponad Claude?
Nie. Weft nie ma kredytów AI: myślenie odbywa się w Claude Code w ramach Twojego planu Claude. Weft liczy wywołania narzędzi: 200 miesięcznie w Darmowym, bez limitu w Pro za $7 za stanowisko miesięcznie albo $60 rocznie. Zobacz cennik.
Co, jeśli już trzymam zadania w Linear, Jirze, Notion albo Trello?
Import jest darmowy w każdym planie: eksporty CSV z Linear, Jiry lub Notion albo tablica Trello jako JSON. Claude Code może też utworzyć wiele zadań naraz za pomocą bulk_create_tasks.
Czy Weft działa z innymi agentami do kodowania poza Claude Code?
Tak. Są 33 strony konfiguracji klientów, w tym Cursor, Codex i ChatGPT. Wszyscy docierają do tej samej tablicy przez ten sam endpoint.