Papan tugas Claude Code: persediaan dua minit yang sebenar dengan MCP

Untuk memberi Claude Code papan tugas, jalankan satu arahan, claude mcp add --transport http weft https://letsweft.com/api/mcp, kemudian log masuk ke Weft dalam pelayar kali pertama Claude Code bersambung. Tiada kunci untuk disalin dan tiada apa-apa untuk ditampal ke dalam fail konfigurasi. Selepas itu, satu blok ringkas dalam CLAUDE.md membuatkan Claude Code menuntut tugas sebelum menyunting kod, melapor semasa bekerja, dan meninggalkan resit apabila selesai.

Kami yang membina Weft. Fakta tentang produk lain diambil daripada halaman rasmi mereka, disemak pada 27 Oktober 2026.

Apakah yang diberikan oleh papan kepada Claude Code yang tidak diberikan oleh terminal?

Claude Code tahu tentang repositori di hadapannya, bukan siapa lagi yang sedang bekerja atau tugas mana yang telah dimulakan oleh sesi yang ranap. Papan menyimpan keadaan itu di luar mana-mana satu sesi, jadi manusia, tetingkap Claude Code kedua dan sembang ChatGPT semuanya melihat perkara yang sama.

Anda tidak memerlukannya untuk setiap repo. Seorang individu, satu sesi pendek dan senarai TODO selalunya sudah memadai. Papan mula memberi pulangan apabila kerja merentasi beberapa sesi atau beberapa ejen, atau apabila manusia perlu melihat hasil sebelum ia diambil kira.

Bagaimanakah saya menyambungkan Claude Code kepada Weft dalam dua minit?

1. Cipta akaun percuma di letsweft.com. Papan baharu bermula dengan empat lajur: Backlog, Todo, Doing dan Done.
2. Dalam terminal anda, jalankan claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code menyimpan pelayan untuk projek semasa; tambah --scope user jika anda mahukannya dalam setiap projek (lihat dokumentasi MCP Claude Code oleh Anthropic).
3. Mulakan claude. Kali pertama Weft digunakan, tetingkap pelayar dibuka untuk OAuth. Jika tidak, taip /mcp, pilih weft dan buat pengesahan dari situ.
4. Pada skrin persetujuan Weft, pilih apa yang boleh dilakukan oleh sambungan ini: full, write (semua kecuali tiga alat yang memusnahkan) atau read. Anda boleh mengubahnya kemudian di Settings → Connected AI clients.
5. Kembali ke Claude Code, tanya: "Apa yang ada di papan saya?"

Titik akhir ini menggunakan MCP melalui Streamable HTTP dan mendedahkan 32 alat. Weft mengeluarkan token refresh, jadi klien memperbaharui log masuk dengan sendirinya. Jika anda menggunakan klien yang tidak boleh menggunakan OAuth, token akses peribadi juga boleh digunakan, tetapi Claude Code tidak memerlukannya. Halaman persediaan penuh ada di letsweft.com/claude-code.

Bagaimanakah saya menyemak bahawa ia berfungsi tanpa membenarkannya mengubah apa-apa?

Jadikan prompt pertama baca sahaja. Ini memberitahu anda bahawa alat telah dimuatkan dan log masuk sampai ke ruang kerja yang betul, dan tiada apa-apa di papan yang beralih:

Senaraikan papan Weft saya: lajur, apa yang ada dalam Doing, dan apa yang menunggu saya.
Jangan ubah apa-apa.

Claude Code sepatutnya memanggil get_board_state atau get_my_work. Kedua-duanya alat baca sahaja. Jika anda mahukan margin keselamatan sementara membiasakan diri, tetapkan sambungan kepada read pada skrin persetujuan: panggilan tulis kemudian akan ditolak, dan panggilan yang ditolak tidak dikira dalam kuota bulanan anda.

Satu kos yang jujur: 32 definisi alat itu menggunakan kira-kira 18,000 token daripada konteks Claude Code.

Bagaimanakah rupa satu tugas yang dituntut?

Letakkan satu tugas kecil yang sebenar dalam Todo, contohnya "betulkan ujian tarikh yang tidak stabil", dan minta Claude Code mengambilnya. Larian yang baik berjalan begini:

1. get_my_work memulangkan apa yang sudah menjadi milik klien ini, apa yang menunggu anda, dan sama ada ada ruang untuk memulakan apa-apa.
2. start_task menuntut tugas, mengalihkannya ke Doing dan memulangkan runId serta leaseToken. Respons itu juga memberitahu ejen supaya memperbaharui setiap 300 saat.
3. Claude Code bekerja dalam repo seperti biasa. Setiap beberapa minit ia memanggil report_progress, yang memperbaharui pajakan.
4. Jika ia menemui keputusan yang hanya anda boleh buat, ia memanggil request_input dengan pilihan. Claude Code memaparkan soalan itu sebagai kad pilihan aslinya; jawapan dihantar kembali melalui submit_answer.
5. complete_task menutup larian dengan hasil, artifacts seperti cincangan commit dan output ujian, serta apa yang tidak dilakukannya.

Secara lalai, tugas yang siap terus pergi ke Done. Ia berhenti di Inbox anda apabila tugas memerlukan semakan atau semakan pengesahan gagal. Di situ anda memilih Accept, Rework, Later atau Drop. Jika ejen menghantar nextStep, seperti "merge PR #12", Accept meluluskan tepat langkah itu dan ia kembali kepada ejen untuk dilaksanakan.

Gelung penuh, dengan setiap penolakan dan medan, ada dalam panduan gelung tuntutan.

Apakah yang patut saya letakkan dalam CLAUDE.md?

Penerangan alat sudah membawa peraturan ini; beberapa baris dalam CLAUDE.md menjadikannya tabiat repo. Tampal dan sesuaikan:

## Weft task board

Weft (MCP server "weft") is the shared board for this repo. Other AI clients
and people read it too, so keep it true.

- At the start of a session, call get_my_work. Work on what it returns;
  do not pick tasks from memory.
- Before you change any file for a task, call start_task with its id.
  Keep the runId and leaseToken it returns.
  - already_claimed: someone else holds it. Do not duplicate; pick another.
  - attention_queue_full: do not retry. Do what the response suggests
    (finish or clarify existing work).
- While working, call report_progress with runId and leaseToken about every
  5 minutes, and at each real checkpoint (tests green, PR opened).
- Call request_input only for decisions the person must make: anything
  irreversible (production, money, publishing, deleting data) or a real fork
  with no sensible default. Give options. Never ask permission to continue.
- When done, call complete_task with:
  - outcome: one or two sentences on what changed
  - artifacts: commit hash, PR URL, test command and its result
  - notDone: what you skipped or left for later
  - unknowns: what you could not verify
  - nextStep: the one step you would take if the person accepts
- If you stop without finishing, say so and leave the task in Doing.

Artifacts menukar "siap" kepada sesuatu yang boleh anda semak. Panggilan itu tidak pernah gagal kerana tiada bukti, kerana kehilangan kerja yang siap lebih buruk daripada merekodkannya tanpa pengesahan.

Apakah yang berlaku apabila sesi Claude Code mati di tengah tugas?

Tiada apa-apa yang perlu membersihkan selepasnya. Tuntutan ialah pajakan, bukan bendera. start_task memberikan 20 minit, dan setiap report_progress memperbaharuinya. Sesi yang ranap, terputus rangkaian atau ditutup tidak boleh melapor, jadi senyap itulah isyaratnya.

• Selepas 20 minit tanpa denyutan, larian ditandakan basi, token pajakan dikosongkan dan tugas kembali tanpa penerima.
• Sapuan berjalan setiap 10 minit, dan tugas juga dibebaskan serta-merta apabila klien lain cuba menuntutnya.
• Larian yang menunggu jawapan anda mengekalkan tuntutannya selama 60 minit. Selepas itu pajakan gugur tetapi soalan kekal terbuka dalam Inbox anda.
• Tuntutan ditentukan oleh pangkalan data, jadi dua tetingkap Claude Code yang berlumba untuk tugas yang sama tidak boleh kedua-duanya menang. Yang kalah mendapat already_claimed bersama id dan tajuk tugas.

Menjalankan beberapa ejen serentak diterangkan dalam beberapa ejen AI pada satu papan.

Bolehkah saya melihat papan yang sama dari ChatGPT atau telefon saya?

Boleh. Ia satu papan di sebalik satu titik akhir. Weft ialah aplikasi yang diterbitkan dalam ChatGPT pada setiap pelan, termasuk Free (persediaan), jadi anda boleh bertanya kepada ChatGPT apa yang disiapkan oleh Claude Code semalaman. Cursor dipasang dengan satu klik (persediaan) dan Codex menggunakan satu entri konfigurasi serta codex mcp login weft (persediaan). Pada claude.ai dan Claude Desktop, Weft ditambah sebagai penyambung tersuai.

Weft juga mempunyai aplikasi iOS dan Android. Apabila tugas masuk ke barisan anda, telefon menerima pemberitahuan tolak, paling banyak satu bagi setiap ruang kerja setiap 10 minit, jadi soalan daripada Claude Code sampai kepada anda walaupun anda jauh dari meja. Setiap klien OAuth ialah pelaku tersendiri, dan papan memaparkan nama yang didaftarkannya.

Untuk membaca semula apa yang telah dilakukan oleh ejen, lihat apa yang telah dilakukan oleh ejen AI saya?

Apakah yang boleh menjadi tidak kena, dan bagaimana membetulkannya?

Belum log masuk

Jika Claude Code melaporkan bahawa weft memerlukan pengesahan, taip /mcp, pilih weft dan buat pengesahan. Jika anda telah memutuskan sambungan klien dalam Settings → Connected AI clients di Weft, token lamanya akan ditolak pada panggilan seterusnya, jadi log masuk semula dengan cara yang sama.

Alat Weft tidak disenaraikan

Jalankan claude mcp list dan pastikan weft ada di situ dengan URL https://letsweft.com/api/mcp. Pelayan ditetapkan mengikut projek melainkan anda menambahnya dengan --scope user, jadi folder lain mungkin tidak memilikinya.

already_claimed

Ini jawapan, bukan ralat. Klien lain memegang pajakan aktif pada tugas itu. Ejen patut memilih kerja lain. Jika anda tahu sesi yang satu lagi sudah mati, tunggu: pajakan luput dalam masa 20 minit dan tugas dibebaskan.

attention_queue_full

Terlalu banyak kerja yang siap atau tersekat sedang menunggu anda: 5 item dalam ruang kerja seorang atau 10 dalam pasukan, atau 45 minit anggaran semakan, mana yang dahulu. Soalan juga dikira. start_task menolak sehingga anda mengosongkan sebahagian Inbox. Respons itu menyenaraikan apa yang masih boleh dilakukan oleh ejen (report_progress, get_my_work, get_board_state, search), jadi ia boleh menyiapkan atau mengemas kerja dan bukannya memulakan lebih banyak.

Panggilan berhenti pada pelan Free

Pelan Free merangkumi 200 panggilan AI sebulan, dan 48 jam pertama selepas mendaftar tidak dikira. Sesi panjang dengan denyutan setiap lima minit menggunakan panggilan secara berterusan. Pro menghapuskan had itu; lihat harga.

Bagaimanakah ini berbanding dengan TODO.md, GitHub Issues atau Hypertask?

Fakta GitHub dipautkan kepada dokumentasi dan halaman harga GitHub; fakta Hypertask dipautkan kepada dokumentasi mereka. Untuk jadual yang lebih luas, lihat perbandingan pengurus tugas MCP.

TODO.md ialah jawapan yang betul untuk seorang pembangun pada satu repo: diversikan bersama kod, tiada akaun, tiada pengesahan. Ia gagal apabila dua sesi menyuntingnya, atau apabila anda mahu menjawab soalan dari telefon.

GitHub Issues ialah tempat semula jadi apabila kerja anda memang sudah berupa isu dan pull request dan semua orang dalam pasukan menggunakan GitHub. Weft tiada integrasi GitHub, jadi pautan commit dan PR dibawa sebagai artifacts dalam resit, bukan melalui penyegerakan.

Hypertask pilihan yang lebih baik jika anda mahukan CLI untuk hook dan CI, REST API, ejen sebagai akaun perkhidmatan dengan identiti sendiri, ciri AI terbina dalam, penjejakan masa atau aplikasi yang mengutamakan papan kekunci. Weft tiada CLI, tiada API awam dan tiada penjejakan masa. Perbezaan Weft ialah tuntutan, denyutan dan soalan kepada manusia ialah alat MCP yang dipanggil terus oleh Claude Code, log masuk menggunakan OAuth dengan refresh, dan papan yang sama ada dalam ChatGPT serta di kedua-dua gedung aplikasi telefon. Lebih lanjut dalam perbandingan Hypertask kami.

Perlukah saya kunci API untuk Claude Code?

Tidak. Claude Code log masuk dengan OAuth dalam pelayar, dan Weft mengeluarkan token refresh supaya klien memperbaharui log masuk dengan sendirinya. Token akses peribadi tersedia untuk klien yang tidak boleh menggunakan OAuth, tetapi Claude Code tidak memerlukannya.

Adakah Claude Code akan menandakan tugas saya Done tanpa saya?

Secara lalai, ya: complete_task mengalihkan tugas ke Done bersama resitnya. Tugas yang memerlukan semakan, atau yang semakan pengesahannya gagal, berhenti di Inbox anda untuk Accept, Rework, Later atau Drop.

Bolehkah saya menghalang Claude Code daripada memadam sesuatu?

Tetapkan sambungan kepada write pada skrin persetujuan, atau kemudian di Settings → Connected AI clients. Write membenarkan semua kecuali tiga alat yang memusnahkan (trash_task, archive_done_tasks, complete_sprint). Read hanya membenarkan 11 alat baca sahaja. Ejen bagaimanapun tidak boleh memadam tugas secara kekal; tong sampah menyimpannya selama 30 hari, dan memulihkan daripada tong sampah ialah ciri Pro.

Adakah Weft mengenakan bayaran AI di samping Claude?

Tidak. Weft tiada kredit AI: pemikiran berlaku dalam Claude Code di bawah pelan Claude anda sendiri. Weft mengira panggilan alat: 200 sebulan pada Free, tanpa had pada Pro dengan harga $7 sebulan atau $60 setahun bagi setiap pengguna. Lihat harga.

Bagaimana jika saya sudah menyimpan tugas dalam Linear, Jira, Notion atau Trello?

Import adalah percuma pada setiap pelan: eksport CSV daripada Linear, Jira atau Notion, atau papan Trello sebagai JSON. Claude Code juga boleh mencipta banyak tugas sekali gus dengan bulk_create_tasks.

Adakah Weft berfungsi dengan ejen pengekodan lain selain Claude Code?

Ya. Terdapat 33 halaman persediaan klien, termasuk Cursor, Codex dan ChatGPT. Semuanya sampai ke papan yang sama melalui titik akhir yang sama.