Claude Code için görev panosu: MCP ile gerçekten iki dakikalık kurulum

Claude Code’a bir görev panosu vermek için tek bir komut çalıştır: claude mcp add --transport http weft https://letsweft.com/api/mcp. Ardından Claude Code ilk kez bağlandığında tarayıcıda Weft’e giriş yap. Kopyalanacak bir anahtar, bir yapılandırma dosyasına yapıştırılacak bir şey yok. Bundan sonra CLAUDE.md’deki kısa bir blok, Claude Code’un kodu düzenlemeden önce bir görevi sahiplenmesini, çalışırken rapor vermesini ve bitirdiğinde bir makbuz bırakmasını sağlar.

Weft’i biz geliştiriyoruz. Diğer ürünlerle ilgili bilgiler, 27 Ekim 2026’da kontrol edilen resmî sayfalarından alındı.

Bir pano Claude Code’a terminalin vermediği neyi verir?

Claude Code önündeki depoyu bilir; başka kimin çalıştığını ya da çöken bir oturumun hangi göreve başladığını bilmez. Pano bu durumu tek bir oturumun dışında tutar; böylece bir insan, ikinci bir Claude Code penceresi ve bir ChatGPT sohbeti aynı şeyi görür.

Her depo için bir panoya ihtiyacın yok. Tek kişi, tek kısa oturum ve bir TODO listesi çoğu zaman yeterli. Pano, iş birkaç oturuma ya da birkaç ajana yayıldığında veya sonuçların sayılması için bir insanın onlara bakması gerektiğinde karşılığını vermeye başlar.

Claude Code’u Weft’e iki dakikada nasıl bağlarım?

1. letsweft.com adresinde ücretsiz bir hesap oluştur. Yeni bir pano dört sütunla başlar: Backlog, Todo, Doing ve Done.
2. Terminalinde claude mcp add --transport http weft https://letsweft.com/api/mcp komutunu çalıştır. Claude Code sunucuyu geçerli proje için kaydeder; her projede olmasını istiyorsan --scope user ekle (bkz. Anthropic’in Claude Code MCP belgeleri).
3. claude’u başlat. Weft ilk kez kullanıldığında OAuth için bir tarayıcı penceresi açılır. Açılmazsa /mcp yaz, weft’i seç ve oradan kimlik doğrula.
4. Weft onay ekranında bu bağlantının ne yapabileceğini seç: full, write (üç yıkıcı araç dışında her şey) ya da read. Bunu sonra Ayarlar → Bağlı yapay zekâ istemcileri bölümünden değiştirebilirsin.
5. Claude Code’a dönüp şunu sor: "Panomda ne var?"

Uç nokta Streamable HTTP üzerinden MCP konuşur ve 32 araç sunar. Weft yenileme belirteçleri verir, böylece istemci girişi kendisi yeniler. OAuth yapamayan bir istemci kullanıyorsan kişisel erişim belirteci de çalışır, ama Claude Code’un buna ihtiyacı yok. Kurulum sayfasının tamamı letsweft.com/claude-code adresinde.

Hiçbir şeyi değiştirmesine izin vermeden çalıştığını nasıl kontrol ederim?

İlk istemi salt okunur yap. Bu sana araçların yüklendiğini ve girişin doğru çalışma alanına ulaştığını söyler; panoda da hiçbir şey kıpırdamaz:

Weft panomu listele: sütunlar, Doing'de ne var ve beni ne bekliyor.
Hiçbir şeyi değiştirme.

Claude Code get_board_state ya da get_my_work çağırmalı. İkisi de salt okunur araçlar. Alışırken bir güvenlik payı istiyorsan bağlantıyı onay ekranında read olarak ayarla: yazma çağrıları reddedilir ve reddedilen çağrılar aylık kotandan düşmez.

Dürüst bir maliyet: 32 araç tanımı Claude Code’un bağlamında yaklaşık 18.000 token yer kaplar.

Sahiplenilmiş tek bir görev neye benzer?

Todo’ya küçük ve gerçek bir görev koy, örneğin "kararsız tarih testini düzelt", ve Claude Code’dan onu almasını iste. İyi bir çalışma şöyle ilerler:

1. get_my_work, bu istemcinin zaten elinde olanları, seni bekleyenleri ve bir şeye başlamak için yer olup olmadığını döndürür.
2. start_task görevi sahiplenir, Doing’e taşır ve bir runId ile leaseToken döndürür. Yanıt ajana her 300 saniyede bir yenilemesini de söyler.
3. Claude Code depoda her zamanki gibi çalışır. Birkaç dakikada bir kiralamayı yenileyen report_progress’i çağırır.
4. Yalnızca senin verebileceğin bir karara gelirse seçeneklerle request_input çağırır. Claude Code soruyu kendi seçenek kartlarıyla gösterir; yanıt submit_answer ile geri gider.
5. complete_task çalışmayı bir sonuç, commit hash’i ve test çıktısı gibi artefaktlar ve yapmadıklarıyla kapatır.

Varsayılan olarak tamamlanan bir görev doğrudan Done’a gider. Görev inceleme gerektirdiğinde ya da bir doğrulama kontrolü başarısız olduğunda bunun yerine Gelen kutunda durur. Orada Kabul et, Yeniden yap, Sonra ya da Bırak seçersin. Ajan "PR #12’yi birleştir" gibi bir nextStep verdiyse Kabul et tam olarak o adımı onaylar ve adım uygulanmak üzere ajana geri döner.

Her ret ve alanla birlikte döngünün tamamı sahiplenme döngüsü rehberinde.

CLAUDE.md’ye ne yazmalıyım?

Araç açıklamaları bu kuralları zaten taşıyor; CLAUDE.md’deki birkaç satır onları deponun alışkanlığı yapar. Yapıştır ve uyarla:

## Weft görev panosu

Weft (MCP sunucusu "weft") bu deponun ortak panosudur. Diğer yapay zekâ
istemcileri ve insanlar da onu okur, bu yüzden onu doğru tut.

- Oturumun başında get_my_work çağır. Onun döndürdükleri üzerinde çalış;
  görevleri hafızandan seçme.
- Bir görev için herhangi bir dosyayı değiştirmeden önce görevin id'siyle
  start_task çağır. Döndürdüğü runId ve leaseToken'ı sakla.
  - already_claimed: görev başkasında. İşi tekrarlama; başka bir görev seç.
  - attention_queue_full: yeniden deneme. Yanıtın önerdiğini yap
    (mevcut işi bitir ya da netleştir).
- Çalışırken yaklaşık her 5 dakikada bir ve her gerçek kontrol noktasında
  (testler yeşil, PR açıldı) runId ve leaseToken ile report_progress çağır.
- request_input'u yalnızca kişinin vermesi gereken kararlar için çağır: geri
  dönüşü olmayan her şey (üretim, para, yayımlama, veri silme) ya da makul bir
  varsayılanı olmayan gerçek bir yol ayrımı. Seçenek ver. Devam etmek için asla
  izin isteme.
- Bitince complete_task'ı şunlarla çağır:
  - outcome: neyin değiştiğini anlatan bir ya da iki cümle
  - artifacts: commit hash'i, PR URL'si, test komutu ve sonucu
  - notDone: atladığın ya da sonraya bıraktığın şeyler
  - unknowns: doğrulayamadığın şeyler
  - nextStep: kişi kabul ederse atacağın tek adım
- Bitirmeden durursan bunu söyle ve görevi Doing'de bırak.

Artefaktlar "bitti"yi kontrol edebileceğin bir şeye dönüştürür. Çağrı kanıt eksik diye asla başarısız olmaz, çünkü bitmiş işi kaybetmek onu doğrulanmamış olarak kaydetmekten daha kötüdür.

Bir Claude Code oturumu görevin ortasında ölürse ne olur?

Arkasını toplaması gereken hiçbir şey yok. Sahiplenme bir bayrak değil, bir kiralamadır. start_task 20 dakika verir ve her report_progress bunu yeniler. Çöken, ağ bağlantısını kaybeden ya da kapatılan bir oturum rapor veremez; yani işaret sessizliktir.

• Nabız sinyali olmadan geçen 20 dakikanın ardından çalışma bayat olarak işaretlenir, kiralama belirteci temizlenir ve görev atanmamış duruma döner.
• Her 10 dakikada bir tarama çalışır; ayrıca başka bir istemci görevi sahiplenmeye çalıştığında görev hemen serbest bırakılır.
• Yanıtını bekleyen bir çalışma sahiplenmeyi 60 dakika korur. Sonrasında kiralama düşer ama soru Gelen kutunda açık kalır.
• Sahiplenmeye veritabanı karar verir; böylece aynı görev için yarışan iki Claude Code penceresinin ikisi birden kazanamaz. Kaybeden, görevin id’si ve başlığıyla birlikte already_claimed alır.

Birkaç ajanı aynı anda çalıştırmak tek panoda birden fazla yapay zekâ ajanı yazısında anlatılıyor.

Aynı panoyu ChatGPT’den ya da telefonumdan görebilir miyim?

Evet. Tek bir uç noktanın arkasında tek bir pano var. Weft, Free dahil her planda ChatGPT’de yayımlanmış bir uygulama (kurulum); yani ChatGPT’ye Claude Code’un gece neyi bitirdiğini sorabilirsin. Cursor tek tıkla kurulur (kurulum), Codex ise bir yapılandırma girdisi artı codex mcp login weft kullanır (kurulum). claude.ai ve Claude Desktop’ta Weft özel bağlayıcı olarak eklenir.

Weft’in iOS ve Android uygulamaları da var. Kuyruğuna bir görev düştüğünde telefona, çalışma alanı başına en fazla 10 dakikada bir olmak üzere bir bildirim gelir; böylece Claude Code’dan gelen bir soru masadan uzaktayken de sana ulaşır. Her OAuth istemcisi ayrı bir aktördür ve pano onun kaydolurken kullandığı adı gösterir.

Bir ajanın ne yaptığını geriye dönük okumak için yapay zekâ ajanım ne yaptı? yazısına bak.

Neler ters gider ve nasıl düzeltirim?

Giriş yapılmamış

Claude Code weft’in kimlik doğrulaması gerektiğini bildirirse /mcp yaz, weft’i seç ve kimlik doğrula. İstemcinin bağlantısını Weft’te Ayarlar → Bağlı yapay zekâ istemcileri bölümünden kestiysen eski belirteçleri bir sonraki çağrıda reddedilir; aynı yolla yeniden giriş yap.

Weft araçları listelenmiyor

claude mcp list çalıştır ve weft’in https://letsweft.com/api/mcp adresiyle orada olduğunu kontrol et. Sunucuyu --scope user ile eklemediysen proje başınadır; yani başka bir klasörde olmayabilir.

already_claimed

Bu bir hata değil, bir yanıt. Başka bir istemci o görev üzerinde canlı bir kiralama tutuyor. Ajan başka bir iş seçmeli. Diğer oturumun öldüğünü biliyorsan bekle: kiralama 20 dakika içinde sona erer ve görev serbest kalır.

attention_queue_full

Seni bekleyen bitmiş ya da tıkanmış iş çok fazla: tek kişilik çalışma alanında 5 öğe ya da ekipte 10 öğe veya tahmini 45 dakikalık inceleme, hangisi önce gelirse. Sorular da sayılır. Gelen kutunun bir kısmını temizleyene kadar start_task reddeder. Yanıt, ajanın hâlâ yapabileceklerini listeler (report_progress, get_my_work, get_board_state, search); böylece daha fazla işe başlamak yerine bitirebilir ya da toparlayabilir.

Free planda çağrılar duruyor

Free ayda 200 yapay zekâ çağrısı içerir ve kayıttan sonraki ilk 48 saat sayılmaz. Beş dakikada bir nabız sinyali gönderen uzun bir oturum düzenli olarak çağrı harcar. Pro sınırı kaldırır; fiyatlandırmaya bak.

Bu, TODO.md, GitHub Issues ya da Hypertask ile nasıl karşılaştırılır?

GitHub bilgileri GitHub’ın belgelerine ve fiyatlandırma sayfasına, Hypertask bilgileri onların belgelerine bağlanıyor. Daha geniş bir tablo için MCP görev yöneticileri karşılaştırmasına bak.

Tek bir depoda tek bir geliştirici için doğru yanıt bir TODO.md’dir: kodla birlikte sürümlenir, hesap yok, kimlik doğrulama yok. İki oturum onu düzenlediğinde ya da bir soruyu telefonundan yanıtlamak istediğinde işe yaramaz hâle gelir.

İşin zaten issue’lardan ve pull request’lerden oluşuyorsa ve ekipteki herkes GitHub’da yaşıyorsa GitHub Issues doğal yuvadır. Weft’in GitHub entegrasyonu yok; bu yüzden commit ve PR bağlantıları senkronizasyonla değil, makbuzdaki artefaktlar olarak taşınır.

Hook’lar ve CI için bir CLI, bir REST API, kendi kimliği olan hizmet hesabı olarak ajanlar, yerleşik yapay zekâ özellikleri, zaman takibi ya da klavye öncelikli bir uygulama istiyorsan Hypertask daha iyi bir seçim. Weft’in CLI’ı, herkese açık API’si ve zaman takibi yok. Weft’in farkı şurada: sahiplenme, nabız sinyali ve kişiye sorulan soru Claude Code’un doğrudan çağırdığı MCP araçlarıdır, giriş yenilemeli OAuth’tur ve aynı pano ChatGPT’de ve iki telefon mağazasında da vardır. Daha fazlası Hypertask karşılaştırmamızda.

Claude Code için bir API anahtarına ihtiyacım var mı?

Hayır. Claude Code tarayıcıda OAuth ile giriş yapar ve Weft yenileme belirteçleri verir, böylece istemci girişi kendisi yeniler. Kişisel erişim belirteçleri OAuth yapamayan istemciler için var, ama Claude Code’un buna ihtiyacı yok.

Claude Code görevlerimi bana sormadan Done olarak işaretler mi?

Varsayılan olarak evet: complete_task görevi makbuzuyla birlikte Done’a taşır. İnceleme gerektiren ya da doğrulama kontrolü başarısız olan bir görev ise bunun yerine Kabul et, Yeniden yap, Sonra ya da Bırak için Gelen kutunda durur.

Claude Code’un bir şeyleri silmesini engelleyebilir miyim?

Bağlantıyı onay ekranında ya da sonradan Ayarlar → Bağlı yapay zekâ istemcileri bölümünde write olarak ayarla. Write, üç yıkıcı araç (trash_task, archive_done_tasks, complete_sprint) dışında her şeye izin verir. Read yalnızca 11 salt okunur araca izin verir. Ajanlar her durumda görevleri kalıcı olarak silemez; çöp kutusu onları 30 gün tutar ve çöp kutusundan geri yükleme bir Pro özelliğidir.

Weft, Claude’un üstüne yapay zekâ için ücret alıyor mu?

Hayır. Weft’te yapay zekâ kredisi yok: düşünme işi kendi Claude planınla Claude Code’da olur. Weft araç çağrılarını sayar: Free’de ayda 200, Pro’da sınırsız; Pro koltuk başına ayda $7 ya da yılda $60. Fiyatlandırmaya bak.

Görevlerimi zaten Linear, Jira, Notion ya da Trello’da tutuyorsam?

İçe aktarma her planda ücretsiz: Linear, Jira ya da Notion’dan CSV dışa aktarımları veya JSON olarak bir Trello panosu. Claude Code bulk_create_tasks ile tek seferde çok sayıda görev de oluşturabilir.

Weft, Claude Code dışındaki kodlama ajanlarıyla çalışıyor mu?

Evet. Cursor, Codex ve ChatGPT dahil 33 istemci kurulum sayfası var. Hepsi aynı uç nokta üzerinden aynı panoya ulaşır.