Papan tugas untuk Claude Code: pengaturan dua menit yang sungguhan dengan MCP

Untuk memberi Claude Code papan tugas, jalankan satu perintah, claude mcp add --transport http weft https://letsweft.com/api/mcp, lalu masuk ke Weft di browser saat Claude Code pertama kali terhubung. Tidak ada kunci yang perlu disalin dan tidak ada yang perlu ditempel ke file konfigurasi. Setelah itu, blok singkat di CLAUDE.md membuat Claude Code mengklaim tugas sebelum mengubah kode, melapor selama bekerja, dan meninggalkan tanda terima ketika selesai.

Kami yang membuat Weft. Fakta tentang produk lain diambil dari halaman resminya, diperiksa pada 27 Oktober 2026.

Apa yang diberikan papan kepada Claude Code yang tidak diberikan terminal?

Claude Code mengenal repositori di depannya, tetapi tidak tahu siapa lagi yang sedang bekerja atau tugas mana yang sudah dimulai oleh sesi yang mogok. Papan menyimpan keadaan itu di luar sesi mana pun, sehingga seseorang, jendela Claude Code kedua, dan obrolan ChatGPT melihat hal yang sama.

Anda tidak membutuhkannya untuk setiap repo. Satu orang, satu sesi singkat, dan daftar TODO sering kali sudah cukup. Papan mulai terbayar ketika pekerjaan merentang beberapa sesi atau beberapa agen, atau ketika seseorang harus melihat hasilnya sebelum dianggap selesai.

Bagaimana menghubungkan Claude Code ke Weft dalam dua menit?

1. Buat akun gratis di letsweft.com. Papan baru dimulai dengan empat kolom: Backlog, Todo, Doing, dan Done.
2. Di terminal, jalankan claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code menyimpan server untuk proyek saat ini; tambahkan --scope user jika Anda ingin server itu ada di setiap proyek (lihat dokumentasi MCP Claude Code dari Anthropic).
3. Jalankan claude. Saat Weft pertama kali dipakai, jendela browser terbuka untuk OAuth. Jika tidak terbuka, ketik /mcp, pilih weft, dan lakukan autentikasi dari sana.
4. Di layar persetujuan Weft, pilih apa yang boleh dilakukan koneksi ini: full, write (semuanya kecuali tiga alat destruktif), atau read. Anda bisa mengubahnya nanti di Pengaturan → klien AI yang terhubung.
5. Kembali ke Claude Code, tanyakan: "Apa saja yang ada di papan saya?"

Endpoint ini berbicara MCP lewat Streamable HTTP dan menyediakan 32 alat. Weft menerbitkan refresh token, sehingga klien memperbarui sesi masuknya sendiri. Jika Anda memakai klien yang tidak bisa OAuth, token akses pribadi juga bisa dipakai, tetapi Claude Code tidak membutuhkannya. Halaman pengaturan lengkapnya ada di letsweft.com/claude-code.

Bagaimana memeriksa bahwa semuanya bekerja tanpa membiarkannya mengubah apa pun?

Jadikan prompt pertama hanya-baca. Dari situ Anda tahu alatnya sudah dimuat dan sesi masuk sampai ke ruang kerja yang benar, tanpa ada yang bergeser di papan:

Tampilkan papan Weft saya: kolom, apa yang ada di Doing, dan apa yang menunggu saya.
Jangan ubah apa pun.

Claude Code seharusnya memanggil get_board_state atau get_my_work. Keduanya alat hanya-baca. Jika Anda ingin batas aman selagi membiasakan diri, atur koneksi ke read di layar persetujuan: panggilan tulis akan ditolak, dan panggilan yang ditolak tidak dihitung terhadap kuota bulanan Anda.

Satu biaya yang perlu diakui: 32 definisi alat memakan sekitar 18.000 token dari konteks Claude Code.

Seperti apa satu tugas yang diklaim?

Taruh tugas kecil yang nyata di Todo, misalnya "perbaiki tes tanggal yang kadang gagal", lalu minta Claude Code mengambilnya. Jalannya yang baik seperti ini:

1. get_my_work mengembalikan apa yang sudah menjadi milik klien ini, apa yang menunggu Anda, dan apakah masih ada ruang untuk memulai sesuatu.
2. start_task mengklaim tugas, memindahkannya ke Doing, dan mengembalikan runId serta leaseToken. Responsnya juga memberi tahu agen untuk memperpanjang setiap 300 detik.
3. Claude Code bekerja di repo seperti biasa. Setiap beberapa menit ia memanggil report_progress, yang memperpanjang masa pinjam.
4. Jika ia menemui keputusan yang hanya bisa Anda ambil, ia memanggil request_input dengan pilihan. Claude Code menampilkan pertanyaannya sebagai kartu pilihan bawaannya; jawabannya dikirim kembali lewat submit_answer.
5. complete_task menutup run dengan hasil, artefak seperti hash commit dan keluaran tes, serta apa yang tidak dikerjakan.

Secara bawaan, tugas yang selesai langsung masuk Done. Tugas itu berhenti di Kotak masuk Anda jika perlu ditinjau atau pemeriksaan verifikasi gagal. Di sana Anda memilih Terima, Kerjakan ulang, Nanti, atau Batalkan. Jika agen menyertakan nextStep, misalnya "merge PR #12", Terima menyetujui tepat langkah itu dan langkah itu kembali kepada agen untuk dijalankan.

Siklus lengkapnya, dengan setiap penolakan dan kolom, ada di panduan siklus klaim.

Apa yang sebaiknya ditulis di CLAUDE.md?

Deskripsi alat sudah membawa aturan-aturan ini; beberapa baris di CLAUDE.md menjadikannya kebiasaan repo. Tempel dan sesuaikan:

## Papan tugas Weft

Weft (server MCP "weft") adalah papan bersama untuk repo ini. Klien AI lain
dan orang-orang juga membacanya, jadi jaga agar isinya benar.

- Di awal sesi, panggil get_my_work. Kerjakan apa yang dikembalikannya;
  jangan memilih tugas dari ingatan.
- Sebelum mengubah file apa pun untuk sebuah tugas, panggil start_task dengan id-nya.
  Simpan runId dan leaseToken yang dikembalikannya.
  - already_claimed: orang lain memegangnya. Jangan menduplikasi; pilih tugas lain.
  - attention_queue_full: jangan mencoba ulang. Lakukan apa yang disarankan respons
    (selesaikan atau perjelas pekerjaan yang sudah ada).
- Selama bekerja, panggil report_progress dengan runId dan leaseToken kira-kira setiap
  5 menit, dan di setiap titik pemeriksaan nyata (tes hijau, PR dibuka).
- Panggil request_input hanya untuk keputusan yang harus diambil orangnya: apa pun
  yang tidak bisa dibatalkan (produksi, uang, publikasi, penghapusan data) atau persimpangan nyata
  tanpa pilihan bawaan yang masuk akal. Berikan pilihan. Jangan pernah meminta izin untuk melanjutkan.
- Setelah selesai, panggil complete_task dengan:
  - outcome: satu atau dua kalimat tentang apa yang berubah
  - artifacts: hash commit, URL PR, perintah tes dan hasilnya
  - notDone: apa yang Anda lewati atau tunda
  - unknowns: apa yang tidak bisa Anda verifikasi
  - nextStep: satu langkah yang akan Anda ambil jika orangnya menerima
- Jika Anda berhenti sebelum selesai, katakan demikian dan biarkan tugas tetap di Doing.

Artefak mengubah "selesai" menjadi sesuatu yang bisa Anda periksa. Panggilan ini tidak pernah gagal karena bukti tidak ada, sebab kehilangan pekerjaan yang sudah selesai lebih buruk daripada mencatatnya tanpa verifikasi.

Apa yang terjadi ketika sesi Claude Code mati di tengah tugas?

Tidak ada yang perlu membereskannya. Klaim adalah masa pinjam, bukan penanda. start_task memberi 20 menit, dan setiap report_progress memperpanjangnya. Sesi yang mogok, kehilangan jaringan, atau ditutup tidak bisa melapor, jadi keheningan adalah sinyalnya.

• Setelah 20 menit tanpa detak, run ditandai basi, token masa pinjam dihapus, dan tugas kembali tanpa penanggung jawab.
• Penyapuan berjalan setiap 10 menit, dan tugas juga langsung dibebaskan ketika klien lain mencoba mengklaimnya.
• Run yang sedang menunggu jawaban Anda mempertahankan klaimnya selama 60 menit. Setelah itu masa pinjamnya lepas, tetapi pertanyaannya tetap terbuka di Kotak masuk Anda.
• Klaim diputuskan oleh basis data, jadi dua jendela Claude Code yang berebut tugas yang sama tidak bisa sama-sama menang. Yang kalah mendapat already_claimed beserta id dan judul tugasnya.

Menjalankan beberapa agen sekaligus dibahas di beberapa agen AI di satu papan.

Bisakah saya melihat papan yang sama dari ChatGPT atau ponsel?

Bisa. Ini satu papan di balik satu endpoint. Weft adalah aplikasi yang sudah terbit di ChatGPT di semua paket, termasuk Free (pengaturan), jadi Anda bisa bertanya kepada ChatGPT apa yang diselesaikan Claude Code semalam. Cursor terpasang dengan satu klik (pengaturan) dan Codex memakai entri konfigurasi plus codex mcp login weft (pengaturan). Di claude.ai dan Claude Desktop, Weft ditambahkan sebagai konektor khusus.

Weft juga punya aplikasi iOS dan Android. Ketika tugas masuk ke antrean Anda, ponsel menerima notifikasi push, paling banyak satu per ruang kerja setiap 10 menit, sehingga pertanyaan dari Claude Code sampai kepada Anda meski sedang jauh dari meja. Setiap klien OAuth adalah aktor tersendiri, dan papan menampilkan nama yang didaftarkannya.

Untuk membaca kembali apa yang dikerjakan agen, lihat apa yang sudah dikerjakan agen AI saya?

Apa yang bisa salah, dan bagaimana memperbaikinya?

Belum masuk

Jika Claude Code melaporkan bahwa weft perlu autentikasi, ketik /mcp, pilih weft, dan lakukan autentikasi. Jika Anda memutus klien itu di Pengaturan → klien AI yang terhubung di Weft, token lamanya ditolak pada panggilan berikutnya, jadi masuk lagi dengan cara yang sama.

Alat Weft tidak muncul

Jalankan claude mcp list dan periksa apakah weft ada dengan URL https://letsweft.com/api/mcp. Server ini berlaku per proyek kecuali Anda menambahkannya dengan --scope user, jadi folder lain mungkin tidak memilikinya.

already_claimed

Ini jawaban, bukan kesalahan. Klien lain memegang masa pinjam aktif atas tugas itu. Agen sebaiknya memilih pekerjaan lain. Jika Anda tahu sesi yang lain sudah mati, tunggu saja: masa pinjamnya habis dalam 20 menit dan tugasnya dibebaskan.

attention_queue_full

Terlalu banyak pekerjaan yang selesai atau terhambat sedang menunggu Anda: 5 item di ruang kerja satu orang atau 10 di tim, atau 45 menit perkiraan waktu tinjauan, mana yang lebih dulu tercapai. Pertanyaan juga dihitung. start_task menolak sampai Anda mengosongkan sebagian Kotak masuk. Responsnya mencantumkan apa yang masih bisa dilakukan agen (report_progress, get_my_work, get_board_state, search), sehingga ia bisa menyelesaikan atau merapikan alih-alih memulai lebih banyak.

Panggilan berhenti di paket Free

Free mencakup 200 panggilan AI per bulan, dan 48 jam pertama setelah mendaftar tidak dihitung. Sesi panjang dengan detak setiap lima menit memakai panggilan secara terus-menerus. Pro menghapus batas itu; lihat harga.

Bagaimana perbandingannya dengan TODO.md, GitHub Issues, atau Hypertask?

Fakta GitHub ditautkan ke dokumentasi dan halaman harga GitHub; fakta Hypertask ditautkan ke dokumentasi mereka. Untuk tabel yang lebih luas, lihat perbandingan pengelola tugas MCP.

TODO.md adalah jawaban yang tepat untuk satu developer di satu repo: berversi bersama kode, tanpa akun, tanpa autentikasi. Ia mulai gagal ketika dua sesi mengeditnya, atau ketika Anda ingin menjawab pertanyaan dari ponsel.

GitHub Issues adalah rumah alami ketika pekerjaan Anda memang berupa issue dan pull request dan semua orang di tim tinggal di GitHub. Weft tidak punya integrasi GitHub, jadi tautan commit dan PR ikut sebagai artefak di tanda terima, bukan lewat sinkronisasi.

Hypertask pilihan yang lebih baik jika Anda menginginkan CLI untuk hook dan CI, REST API, agen sebagai akun layanan dengan identitas sendiri, fitur AI bawaan, pelacakan waktu, atau aplikasi yang mengutamakan keyboard. Weft tidak punya CLI, API publik, maupun pelacakan waktu. Perbedaan Weft adalah klaim, detak, dan pertanyaan kepada orangnya berupa alat MCP yang dipanggil Claude Code secara langsung, cara masuknya OAuth dengan refresh, dan papan yang sama ada di ChatGPT serta di kedua toko aplikasi ponsel. Selengkapnya di perbandingan kami dengan Hypertask.

Apakah saya perlu kunci API untuk Claude Code?

Tidak. Claude Code masuk dengan OAuth di browser, dan Weft menerbitkan refresh token sehingga klien memperbarui sesi masuknya sendiri. Token akses pribadi tersedia untuk klien yang tidak bisa OAuth, tetapi Claude Code tidak membutuhkannya.

Apakah Claude Code akan menandai tugas saya Done tanpa saya?

Secara bawaan, ya: complete_task memindahkan tugas ke Done beserta tanda terimanya. Tugas yang perlu ditinjau, atau yang pemeriksaan verifikasinya gagal, berhenti di Kotak masuk Anda untuk Terima, Kerjakan ulang, Nanti, atau Batalkan.

Bisakah saya mencegah Claude Code menghapus sesuatu?

Atur koneksi ke write di layar persetujuan, atau nanti di Pengaturan → klien AI yang terhubung. Write mengizinkan semuanya kecuali tiga alat destruktif (trash_task, archive_done_tasks, complete_sprint). Read hanya mengizinkan 11 alat hanya-baca. Bagaimanapun, agen tidak bisa menghapus tugas secara permanen; tempat sampah menyimpannya selama 30 hari, dan pemulihan dari tempat sampah adalah fitur Pro.

Apakah Weft menagih biaya AI di atas Claude?

Tidak. Weft tidak punya kredit AI: proses berpikirnya terjadi di Claude Code dengan paket Claude Anda sendiri. Weft menghitung panggilan alat: 200 per bulan di Free, tanpa batas di Pro seharga $7 per kursi per bulan atau $60 per tahun. Lihat harga.

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

Impor gratis di semua paket: ekspor CSV dari Linear, Jira, atau Notion, atau papan Trello sebagai JSON. Claude Code juga bisa membuat banyak tugas sekaligus dengan bulk_create_tasks.

Apakah Weft bekerja dengan agen coding lain selain Claude Code?

Ya. Ada 33 halaman pengaturan klien, termasuk Cursor, Codex, dan ChatGPT. Semuanya menjangkau papan yang sama lewat endpoint yang sama.