Claude Code के लिए टास्क बोर्ड: MCP के साथ सच में दो मिनट का सेटअप

Claude Code को टास्क बोर्ड देने के लिए एक कमांड चलाएँ, claude mcp add --transport http weft https://letsweft.com/api/mcp, फिर जब Claude Code पहली बार जुड़े तो ब्राउज़र में Weft में साइन इन करें। न कोई key कॉपी करनी है, न कॉन्फ़िग फ़ाइल में कुछ पेस्ट करना है। इसके बाद 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 के Claude Code MCP डॉक्स)।
3. claude शुरू करें। जब पहली बार Weft इस्तेमाल होगा, OAuth के लिए ब्राउज़र विंडो खुलेगी। अगर न खुले, तो /mcp टाइप करें, weft चुनें और वहीं से authenticate करें।
4. Weft की मंज़ूरी वाली स्क्रीन पर चुनें कि यह कनेक्शन क्या कर सकता है: full, write (तीन विनाशकारी टूल को छोड़कर सब) या read। इसे बाद में सेटिंग्स → जुड़े हुए AI क्लाइंट में बदला जा सकता है।
5. Claude Code में वापस आकर पूछें: "मेरे बोर्ड पर क्या है?"

यह एंडपॉइंट Streamable HTTP पर MCP बोलता है और 32 टूल देता है। Weft refresh token देता है, इसलिए क्लाइंट साइन-इन ख़ुद रिन्यू करता है। अगर आप ऐसा क्लाइंट इस्तेमाल करते हैं जो OAuth नहीं कर सकता, तो personal access token भी चलता है, पर Claude Code को इसकी ज़रूरत नहीं। पूरा सेटअप पेज letsweft.com/hi/claude-code पर है।

बिना कुछ बदलवाए कैसे जाँचें कि यह चल रहा है?

पहला prompt सिर्फ़ पढ़ने वाला रखें। इससे पता चलता है कि टूल लोड हो गए हैं और साइन-इन सही वर्कस्पेस तक पहुँचा है, और बोर्ड पर कुछ भी नहीं हिलता:

मेरा Weft बोर्ड दिखाओ: कॉलम, Doing में क्या है, और क्या मेरा इंतज़ार कर रहा है।
कुछ भी मत बदलो।

Claude Code को get_board_state या get_my_work कॉल करना चाहिए। दोनों read-only टूल हैं। अगर आदत पड़ने तक सुरक्षा का मार्जिन चाहिए, तो मंज़ूरी वाली स्क्रीन पर कनेक्शन को read पर रखें: तब write कॉल ठुकरा दिए जाते हैं, और ठुकराए गए कॉल आपके मासिक कोटे में नहीं गिने जाते।

एक ईमानदार लागत: 32 टूल की परिभाषाएँ Claude Code के context के लगभग 18,000 टोकन लेती हैं।

एक क्लेम किया गया टास्क कैसा दिखता है?

Todo में एक छोटा, असली टास्क डालें, जैसे "fix the flaky date test", और Claude Code से उसे लेने को कहें। एक अच्छा रन ऐसे चलता है:

1. get_my_work बताता है कि इस क्लाइंट के पास पहले से क्या है, क्या आपका इंतज़ार कर रहा है, और कुछ नया शुरू करने की जगह है या नहीं।
2. start_task टास्क क्लेम करता है, उसे Doing में ले जाता है और runId व leaseToken लौटाता है। जवाब एजेंट को हर 300 सेकंड में रिन्यू करने को भी कहता है।
3. Claude Code रिपॉज़िटरी में हमेशा की तरह काम करता है। हर कुछ मिनट में वह report_progress कॉल करता है, जो lease रिन्यू करता है।
4. अगर वह किसी ऐसे फ़ैसले पर पहुँचता है जो सिर्फ़ आप ले सकते हैं, तो वह विकल्पों के साथ request_input कॉल करता है। Claude Code सवाल को अपने नेटिव विकल्प कार्ड के रूप में दिखाता है; जवाब submit_answer से वापस जाता है।
5. complete_task रन को नतीजे, commit hash और टेस्ट आउटपुट जैसे artifacts, और जो उसने नहीं किया, उसके साथ बंद करता है।

डिफ़ॉल्ट रूप से पूरा हुआ टास्क सीधे Done में जाता है। जब टास्क को रिव्यू चाहिए या कोई verification जाँच फ़ेल हो, तो वह इसके बजाय आपके Inbox में रुकता है। वहाँ आप स्वीकार (Accept), दोबारा करें (Rework), बाद में (Later) या छोड़ दें (Drop) चुनते हैं। अगर एजेंट ने nextStep दिया था, जैसे "merge PR #12", तो स्वीकार ठीक उसी कदम को मंज़ूरी देता है और वह कदम एजेंट के पास करने के लिए लौट आता है।

पूरा चक्र, हर इनकार और हर फ़ील्ड के साथ, क्लेम के चक्र वाली गाइड में है।

CLAUDE.md में क्या लिखें?

टूल के विवरण में ये नियम पहले से हैं; CLAUDE.md की कुछ लाइनें इन्हें रिपॉज़िटरी की आदत बना देती हैं। पेस्ट करें और ज़रूरत के हिसाब से बदलें:

## Weft टास्क बोर्ड

Weft (MCP सर्वर "weft") इस रिपॉज़िटरी का साझा बोर्ड है। दूसरे AI क्लाइंट
और लोग भी इसे पढ़ते हैं, इसलिए इसे सच रखो।

- सेशन की शुरुआत में get_my_work कॉल करो। जो वह लौटाए, उसी पर काम करो;
  याद से टास्क मत चुनो।
- किसी टास्क के लिए कोई भी फ़ाइल बदलने से पहले उसके id के साथ start_task कॉल करो।
  जो runId और leaseToken वह लौटाए, उन्हें रखो।
  - already_claimed: किसी और के पास है। काम मत दोहराओ; दूसरा चुनो।
  - attention_queue_full: दोबारा कोशिश मत करो। जो जवाब सुझाए, वह करो
    (मौजूदा काम पूरा करो या स्पष्ट करो)।
- काम करते हुए लगभग हर 5 मिनट में, और हर असली पड़ाव पर (टेस्ट हरे, PR खुला),
  runId और leaseToken के साथ report_progress कॉल करो।
- request_input सिर्फ़ उन फ़ैसलों के लिए कॉल करो जो व्यक्ति को लेने ही हैं: जो भी
  पलटा न जा सके (प्रोडक्शन, पैसा, प्रकाशन, डेटा डिलीट करना) या ऐसा असली मोड़
  जिसका कोई समझदार डिफ़ॉल्ट न हो। विकल्प दो। आगे बढ़ने की इजाज़त कभी मत माँगो।
- काम पूरा होने पर complete_task कॉल करो, इनके साथ:
  - outcome: क्या बदला, एक या दो वाक्यों में
  - artifacts: commit hash, PR URL, टेस्ट कमांड और उसका नतीजा
  - notDone: जो छोड़ा या बाद के लिए रखा
  - unknowns: जो तुम जाँच नहीं पाए
  - nextStep: वह एक कदम जो व्यक्ति के स्वीकार करने पर तुम उठाओगे
- अगर बिना पूरा किए रुकते हो, तो यह बताओ और टास्क को Doing में छोड़ दो।

Artifacts "हो गया" को ऐसी चीज़ बना देते हैं जिसे आप जाँच सकें। सबूत न होने पर भी यह कॉल कभी फ़ेल नहीं होता, क्योंकि पूरा हुआ काम खो देना उसे बिना जाँचे दर्ज करने से बुरा है।

टास्क के बीच Claude Code का सेशन बंद हो जाए तो क्या होता है?

उसके बाद किसी को सफ़ाई नहीं करनी पड़ती। क्लेम एक lease है, कोई झंडा नहीं। start_task 20 मिनट देता है, और हर report_progress उसे रिन्यू करता है। जो सेशन क्रैश हो जाए, नेटवर्क खो दे या बंद कर दिया जाए, वह कुछ बता नहीं सकता, इसलिए चुप्पी ही संकेत है।

• बिना heartbeat के 20 मिनट बाद रन को stale मान लिया जाता है, lease token हटा दिया जाता है और टास्क फिर से किसी को सौंपा नहीं रहता।
• हर 10 मिनट में एक sweep चलता है, और जब कोई दूसरा क्लाइंट टास्क क्लेम करने की कोशिश करे तो वह तुरंत भी खुल जाता है।
• जो रन आपके जवाब का इंतज़ार कर रहा है, वह अपना क्लेम 60 मिनट तक रखता है। उसके बाद lease छूट जाती है, पर सवाल आपके Inbox में खुला रहता है।
• क्लेम डेटाबेस तय करता है, इसलिए एक ही टास्क के लिए दौड़ती Claude Code की दो विंडो दोनों नहीं जीत सकतीं। हारने वाली को टास्क के id और टाइटल के साथ already_claimed मिलता है।

एक साथ कई एजेंट चलाने के बारे में एक बोर्ड पर कई AI एजेंट में बताया गया है।

क्या वही बोर्ड ChatGPT या फ़ोन से देख सकता हूँ?

हाँ। एक एंडपॉइंट के पीछे एक ही बोर्ड है। Weft, ChatGPT में Free समेत हर प्लान पर प्रकाशित ऐप है (सेटअप), इसलिए आप ChatGPT से पूछ सकते हैं कि Claude Code ने रात में क्या पूरा किया। Cursor एक क्लिक में इंस्टॉल होता है (सेटअप) और Codex में एक कॉन्फ़िग एंट्री और codex mcp login weft लगता है (सेटअप)। claude.ai और Claude Desktop पर Weft को custom connector के रूप में जोड़ा जाता है।

Weft के iOS और Android ऐप भी हैं। जब कोई टास्क आपकी कतार में आता है, तो फ़ोन पर पुश आता है, प्रति वर्कस्पेस हर 10 मिनट में ज़्यादा से ज़्यादा एक, ताकि Claude Code का सवाल डेस्क से दूर भी आप तक पहुँचे। हर OAuth क्लाइंट अपना अलग actor है, और बोर्ड वही नाम दिखाता है जिससे उसने रजिस्टर किया।

एजेंट ने क्या किया, यह वापस पढ़ने के लिए देखें मेरे AI एजेंट ने क्या किया?

क्या गड़बड़ हो सकती है, और उसे कैसे ठीक करें?

साइन इन नहीं है

अगर Claude Code बताए कि weft को authentication चाहिए, तो /mcp टाइप करें, weft चुनें और authenticate करें। अगर आपने Weft के सेटिंग्स → जुड़े हुए AI क्लाइंट में क्लाइंट को डिस्कनेक्ट किया था, तो उसके पुराने टोकन अगले कॉल पर ठुकरा दिए जाते हैं, इसलिए उसी तरह फिर से साइन इन करें।

Weft के टूल लिस्ट में नहीं हैं

claude mcp list चलाएँ और जाँचें कि weft वहाँ URL https://letsweft.com/api/mcp के साथ है। जब तक आपने इसे --scope user के साथ नहीं जोड़ा, सर्वर प्रति प्रोजेक्ट होता है, इसलिए हो सकता है किसी दूसरे फ़ोल्डर में यह न हो।

already_claimed

यह जवाब है, एरर नहीं। किसी दूसरे क्लाइंट के पास उस टास्क की चालू lease है। एजेंट को दूसरा काम चुनना चाहिए। अगर आपको पता है कि दूसरा सेशन बंद हो चुका है, तो इंतज़ार करें: lease 20 मिनट के अंदर ख़त्म हो जाती है और टास्क खुल जाता है।

attention_queue_full

बहुत ज़्यादा पूरा हुआ या अटका काम आपका इंतज़ार कर रहा है: एक व्यक्ति वाले वर्कस्पेस में 5 आइटम या टीम में 10, या अनुमानित 45 मिनट का रिव्यू, जो भी पहले हो। सवाल भी गिने जाते हैं। जब तक आप Inbox में से कुछ साफ़ न करें, start_task मना करता रहता है। जवाब में लिखा होता है कि एजेंट अब भी क्या कर सकता है (report_progress, get_my_work, get_board_state, search), ताकि वह और शुरू करने के बजाय काम पूरा या व्यवस्थित कर सके।

Free प्लान पर कॉल रुक जाते हैं

Free में महीने में 200 AI कॉल शामिल हैं, और साइनअप के बाद पहले 48 घंटे गिने नहीं जाते। हर पाँच मिनट में heartbeat वाला लंबा सेशन लगातार कॉल खर्च करता है। Pro यह सीमा हटा देता है; देखें कीमतें।

TODO.md, GitHub Issues या Hypertask से इसकी तुलना कैसी है?

GitHub के तथ्य GitHub के डॉक्स और pricing पेज से लिंक हैं; Hypertask के तथ्य उनके डॉक्स से। बड़ी तालिका के लिए देखें MCP टास्क मैनेजरों की तुलना।

एक रिपॉज़िटरी पर एक डेवलपर के लिए TODO.md सही जवाब है: कोड के साथ वर्ज़न होता है, न अकाउंट, न auth। यह तब टूटता है जब दो सेशन उसे बदलें, या जब आप फ़ोन से किसी सवाल का जवाब देना चाहें।

जब आपका काम पहले से issues और pull requests ही है और टीम का हर व्यक्ति GitHub पर रहता है, तो GitHub Issues स्वाभाविक जगह है। Weft में GitHub इंटीग्रेशन नहीं है, इसलिए commit और PR के लिंक sync से नहीं, रसीद पर artifacts के रूप में आते हैं।

अगर आपको hooks और CI के लिए CLI, REST API, अपनी पहचान वाले service account के रूप में एजेंट, बिल्ट-इन AI फ़ीचर, टाइम ट्रैकिंग या कीबोर्ड-फ़र्स्ट ऐप चाहिए, तो Hypertask बेहतर चुनाव है। Weft में न CLI है, न सार्वजनिक API, न टाइम ट्रैकिंग। Weft का फ़र्क़ यह है कि क्लेम, heartbeat और व्यक्ति से सवाल MCP टूल हैं जिन्हें Claude Code सीधे कॉल करता है, साइन-इन refresh वाला OAuth है, और वही बोर्ड ChatGPT में और दोनों फ़ोन स्टोर पर है। ज़्यादा जानकारी हमारी Hypertask तुलना में।

क्या Claude Code के लिए API key चाहिए?

नहीं। Claude Code ब्राउज़र में OAuth से साइन इन करता है, और Weft refresh token देता है ताकि क्लाइंट साइन-इन ख़ुद रिन्यू करे। जो क्लाइंट OAuth नहीं कर सकते, उनके लिए personal access token हैं, पर Claude Code को इसकी ज़रूरत नहीं।

क्या Claude Code मेरे बिना मेरे टास्क Done कर देगा?

डिफ़ॉल्ट रूप से, हाँ: complete_task टास्क को उसकी रसीद के साथ Done में ले जाता है। जिस टास्क को रिव्यू चाहिए, या जिसकी verification जाँच फ़ेल हो, वह इसके बजाय आपके Inbox में स्वीकार, दोबारा करें, बाद में या छोड़ दें के लिए रुकता है।

क्या मैं Claude Code को चीज़ें डिलीट करने से रोक सकता हूँ?

मंज़ूरी वाली स्क्रीन पर, या बाद में सेटिंग्स → जुड़े हुए AI क्लाइंट में, कनेक्शन को write पर रखें। Write तीन विनाशकारी टूल (trash_task, archive_done_tasks, complete_sprint) को छोड़कर सब कुछ करने देता है। Read सिर्फ़ 11 read-only टूल की अनुमति देता है। किसी भी हाल में एजेंट टास्क हमेशा के लिए डिलीट नहीं कर सकते; ट्रैश उन्हें 30 दिन रखता है, और ट्रैश से रिस्टोर करना Pro फ़ीचर है।

क्या Weft, Claude के ऊपर AI के लिए अलग पैसा लेता है?

नहीं। Weft में कोई AI क्रेडिट नहीं: सोचने का काम आपके अपने Claude प्लान पर Claude Code में होता है। Weft टूल कॉल गिनता है: Free पर महीने में 200, Pro पर असीमित, प्रति सीट $7 महीना या $60 साल। देखें कीमतें।

अगर मैं पहले से Linear, Jira, Notion या Trello में टास्क रखता हूँ तो?

इम्पोर्ट हर प्लान पर मुफ़्त है: Linear, Jira या Notion के CSV एक्सपोर्ट, या JSON के रूप में Trello बोर्ड। Claude Code bulk_create_tasks से एक साथ कई टास्क भी बना सकता है।

क्या Weft, Claude Code के अलावा दूसरे कोडिंग एजेंटों के साथ चलता है?

हाँ। 33 क्लाइंट के सेटअप पेज हैं, जिनमें Cursor, Codex और ChatGPT शामिल हैं। सब एक ही एंडपॉइंट से एक ही बोर्ड तक पहुँचते हैं।