Дошка завдань для Claude Code: справжнє налаштування за дві хвилини через MCP

Щоб дати Claude Code дошку завдань, виконай одну команду — claude mcp add --transport http weft https://letsweft.com/api/mcp, — а потім увійди у Weft у браузері, коли Claude Code вперше підключиться. Жодного ключа копіювати і нічого вставляти в конфігураційний файл не треба. Після цього короткий блок у CLAUDE.md змусить Claude Code захоплювати завдання, перш ніж редагувати код, звітувати під час роботи й лишати звіт, коли закінчить.

Weft робимо ми. Факти про інші продукти взято з їхніх офіційних сторінок, перевірено 27 жовтня 2026 року.

Що дає Claude Code дошка такого, чого не дає термінал?

Claude Code знає репозиторій перед собою, але не знає, хто ще працює і яке завдання почала сесія, що впала. Дошка тримає цей стан поза будь-якою окремою сесією, тож людина, друге вікно Claude Code і чат у ChatGPT бачать те саме.

Не для кожного репозиторію вона потрібна. Одна людина, одна коротка сесія і TODO-список — часто цього досить. Дошка починає окупатися, коли робота розтягується на кілька сесій чи кількох агентів або коли людина має переглянути результати, перш ніж вони зарахуються.

Як підключити Claude Code до Weft за дві хвилини?

1. Створи безкоштовний обліковий запис на letsweft.com. Нова дошка починається з чотирьох колонок: Backlog, Todo, Doing і Done.
2. У терміналі виконай claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code збереже сервер для поточного проєкту; додай --scope user, якщо хочеш мати його в усіх проєктах (див. документацію Anthropic про MCP у Claude Code).
3. Запусти claude. Коли Weft використовується вперше, відкривається вікно браузера для OAuth. Якщо ні — введи /mcp, обери weft і автентифікуйся звідти.
4. На екрані згоди Weft обери, що може це підключення: full, write (усе, крім трьох деструктивних інструментів) або read. Пізніше це можна змінити в Settings → Connected AI clients.
5. Повернися в Claude Code і спитай: «Що на моїй дошці?»

Ендпоінт говорить MCP через Streamable HTTP і відкриває 32 інструменти. Weft видає refresh-токени, тож клієнт сам поновлює вхід. Якщо твій клієнт не вміє OAuth, підійде й персональний токен доступу, але Claude Code він не потрібен. Повна сторінка налаштування — на letsweft.com/claude-code.

Як перевірити, що все працює, не даючи йому нічого змінювати?

Зроби перший промпт лише для читання. Так ти дізнаєшся, що інструменти завантажено і вхід потрапив у правильний робочий простір, а на дошці нічого не зрушить:

Покажи мою дошку Weft: колонки, що в Doing і що чекає на мене.
Нічого не змінюй.

Claude Code має викликати get_board_state або get_my_work. Обидва інструменти лише читають. Якщо хочеш запас безпеки, поки звикаєш, встанови для підключення read на екрані згоди: тоді виклики на запис відхилятимуться, а відхилені виклики не рахуються в місячну квоту.

Одна чесна ціна: 32 визначення інструментів займають приблизно 18 000 токенів контексту Claude Code.

Який вигляд має одне захоплене завдання?

Поклади в Todo невелике справжнє завдання, наприклад «полагодити нестабільний тест дат», і попроси Claude Code його взяти. Вдалий запуск виглядає так:

1. get_my_work повертає те, що вже належить цьому клієнту, що чекає на тебе і чи є місце, щоб щось почати.
2. start_task захоплює завдання, переносить його в Doing і повертає runId та leaseToken. Відповідь також каже агенту продовжувати оренду кожні 300 секунд.
3. Claude Code працює в репозиторії як завжди. Кожні кілька хвилин він викликає report_progress, що продовжує оренду.
4. Якщо він натрапляє на рішення, яке можеш ухвалити лише ти, то викликає request_input з варіантами. Claude Code показує запитання своїми нативними картками з варіантами; відповідь повертається через submit_answer.
5. complete_task закриває запуск із результатом, артефактами, як-от хеш коміту і вивід тестів, і переліком того, чого не зроблено.

За замовчуванням завершене завдання одразу йде в Done. Натомість воно зупиняється в твоєму Inbox, коли потребує рев’ю або перевірка не пройшла. Там ти обираєш Accept, Rework, Later чи Drop. Якщо агент передав nextStep, наприклад «merge PR #12», Accept погоджує саме цей крок, і він повертається до агента на виконання.

Повний цикл з усіма відмовами й полями — у посібнику про цикл захоплення.

Що написати в CLAUDE.md?

Описи інструментів уже містять ці правила; кілька рядків у CLAUDE.md роблять їх звичкою репозиторію. Встав і підлаштуй:

## Дошка завдань Weft

Weft (MCP-сервер "weft") — спільна дошка цього репозиторію. Її читають й інші
ШІ-клієнти та люди, тож тримай її правдивою.

- На початку сесії виклич get_my_work. Працюй над тим, що він повертає;
  не обирай завдання з пам’яті.
- Перш ніж змінювати будь-який файл для завдання, виклич start_task з його id.
  Збережи runId і leaseToken, які він поверне.
  - already_claimed: завдання тримає хтось інший. Не дублюй; обери інше.
  - attention_queue_full: не повторюй спробу. Зроби те, що пропонує відповідь
    (заверши або уточни наявну роботу).
- Під час роботи викликай report_progress з runId і leaseToken приблизно кожні
  5 хвилин і на кожній справжній контрольній точці (тести зелені, PR відкрито).
- Викликай request_input лише для рішень, які має ухвалити людина: будь-що
  незворотне (продакшн, гроші, публікація, видалення даних) або справжня розвилка
  без розумного варіанта за замовчуванням. Давай варіанти. Ніколи не питай дозволу продовжити.
- Коли закінчиш, виклич complete_task з:
  - outcome: одне-два речення про те, що змінилося
  - artifacts: хеш коміту, URL PR, команда тестів і її результат
  - notDone: що ти пропустив або відклав
  - unknowns: що ти не зміг перевірити
  - nextStep: єдиний крок, який ти зробиш, якщо людина прийме роботу
- Якщо зупиняєшся, не закінчивши, скажи про це і залиш завдання в Doing.

Артефакти перетворюють «готово» на те, що можна перевірити. Виклик ніколи не падає через брак доказів, бо втратити завершену роботу гірше, ніж записати її неперевіреною.

Що буде, якщо сесія Claude Code помре посеред завдання?

Ніхто не мусить за нею прибирати. Захоплення — це оренда, а не прапорець. start_task дає 20 хвилин, і кожен report_progress їх продовжує. Сесія, що впала, втратила мережу чи була закрита, не може звітувати, тож сигналом є мовчання.

• Після 20 хвилин без heartbeat запуск позначається як застарілий, токен оренди очищається, і завдання знову стає непризначеним.
• Прибирання запускається кожні 10 хвилин, а ще завдання звільняється одразу, коли інший клієнт пробує його захопити.
• Запуск, що чекає на твою відповідь, тримає захоплення 60 хвилин. Після цього оренда знімається, але запитання лишається відкритим у твоєму Inbox.
• Захоплення вирішує база даних, тож два вікна Claude Code, що змагаються за те саме завдання, не можуть обидва перемогти. Той, хто програв, отримує already_claimed з ідентифікатором і назвою завдання.

Про запуск кількох агентів одночасно — у статті «кілька ШІ-агентів на одній дошці».

Чи можу я бачити ту саму дошку з ChatGPT чи телефона?

Так. Це одна дошка за одним ендпоінтом. Weft — опублікований застосунок у ChatGPT на будь-якому тарифі, зокрема Free (налаштування), тож можна спитати ChatGPT, що Claude Code завершив за ніч. Cursor встановлюється в один клік (налаштування), а Codex використовує запис у конфігурації плюс codex mcp login weft (налаштування). У claude.ai і Claude Desktop Weft додають як кастомний конектор.

У Weft також є застосунки для iOS і Android. Коли завдання потрапляє в твою чергу, на телефон приходить push — не частіше ніж один на робочий простір кожні 10 хвилин, — тож запитання від Claude Code знайде тебе й далеко від робочого столу. Кожен OAuth-клієнт — окремий виконавець, і дошка показує ім’я, з яким він зареєструвався.

Як переглянути, що зробив агент, — у статті «що зробив мій ШІ-агент?»

Що може піти не так і як це виправити?

Вхід не виконано

Якщо Claude Code повідомляє, що weft потребує автентифікації, введи /mcp, обери weft і автентифікуйся. Якщо ти відключив клієнт у Weft у Settings → Connected AI clients, його старі токени відхиляються на наступному виклику, тож увійди знову так само.

Інструментів Weft немає в списку

Виконай claude mcp list і перевір, що weft там є з URL https://letsweft.com/api/mcp. Сервер прив’язаний до проєкту, якщо ти не додав його з --scope user, тож в іншій теці його може не бути.

already_claimed

Це відповідь, а не помилка. Інший клієнт тримає активну оренду цього завдання. Агенту варто обрати іншу роботу. Якщо ти знаєш, що інша сесія мертва, зачекай: оренда спливе протягом 20 хвилин, і завдання звільниться.

attention_queue_full

На тебе чекає забагато завершеної чи заблокованої роботи: 5 пунктів у робочому просторі на одну людину чи 10 у команді або 45 хвилин оціненого рев’ю — залежно від того, що настане раніше. Запитання теж рахуються. start_task відмовлятиме, поки ти не розчистиш частину Inbox. Відповідь перелічує, що агент ще може робити (report_progress, get_my_work, get_board_state, search), тож він може завершувати чи прибирати замість того, щоб братися за нове.

Виклики зупиняються на безкоштовному тарифі

Безкоштовний тариф включає 200 ШІ-викликів на місяць, а перші 48 годин після реєстрації не рахуються. Довга сесія з heartbeat кожні п’ять хвилин стабільно витрачає виклики. Pro знімає обмеження; див. ціни.

Як це порівнюється з TODO.md, GitHub Issues чи Hypertask?

Факти про GitHub ведуть на документацію і сторінку цін GitHub; факти про Hypertask — на його документацію. Ширша таблиця — у порівнянні MCP-менеджерів завдань.

TODO.md — правильна відповідь для одного розробника в одному репозиторії: версіонується разом із кодом, без облікового запису, без автентифікації. Він ламається, коли його редагують дві сесії або коли хочеш відповісти на запитання з телефона.

GitHub Issues — природне місце, коли твоя робота вже є issues і pull request-ами, а вся команда живе на GitHub. У Weft немає інтеграції з GitHub, тож посилання на коміти й PR потрапляють у звіт як артефакти, а не через синхронізацію.

Hypertask — кращий вибір, якщо тобі потрібні CLI для хуків і CI, REST API, агенти як сервісні акаунти з власною ідентичністю, вбудовані ШІ-функції, облік часу або застосунок із фокусом на клавіатуру. У Weft немає CLI, публічного API та обліку часу. Відмінність Weft у тому, що захоплення, heartbeat і запитання до людини — це MCP-інструменти, які Claude Code викликає напряму, вхід — це OAuth з оновленням, а та сама дошка є в ChatGPT і в обох магазинах застосунків. Більше — у нашому порівнянні з Hypertask.

Чи потрібен API-ключ для Claude Code?

Ні. Claude Code входить через OAuth у браузері, а Weft видає refresh-токени, тож клієнт сам поновлює вхід. Персональні токени доступу існують для клієнтів, які не вміють OAuth, але Claude Code вони не потрібні.

Чи позначатиме Claude Code мої завдання як Done без мене?

За замовчуванням так: complete_task переносить завдання в Done разом зі звітом. Завдання, яке потребує рев’ю або не пройшло перевірку, натомість зупиняється в твоєму Inbox на Accept, Rework, Later чи Drop.

Чи можна заборонити Claude Code щось видаляти?

Встанови для підключення write на екрані згоди або пізніше в Settings → Connected AI clients. Write дозволяє все, крім трьох деструктивних інструментів (trash_task, archive_done_tasks, complete_sprint). Read дозволяє лише 11 інструментів для читання. Агенти в жодному разі не можуть видаляти завдання назавжди; кошик зберігає їх 30 днів, а відновлення з кошика — функція Pro.

Чи бере Weft гроші за ШІ на додачу до Claude?

Ні. У Weft немає ШІ-кредитів: думання відбувається в Claude Code у межах твого власного тарифу Claude. Weft рахує виклики інструментів: 200 на місяць на безкоштовному тарифі, без обмежень на Pro за $7 за місце на місяць або $60 на рік. Див. ціни.

А якщо я вже веду завдання в Linear, Jira, Notion чи Trello?

Імпорт безкоштовний на будь-якому тарифі: CSV-експорти з Linear, Jira чи Notion або дошка Trello у JSON. Claude Code також може створити багато завдань одразу через bulk_create_tasks.

Чи працює Weft з іншими агентами для коду, крім Claude Code?

Так. Є 33 сторінки налаштування клієнтів, зокрема Cursor, Codex і ChatGPT. Усі вони звертаються до тієї самої дошки через той самий ендпоінт.