अपने टूल जोड़ें। पहुँच सीमित रखें।

API कुंजी बनाएँ और इस्तेमाल करें।

कार्यक्षेत्र के स्वामी और व्यवस्थापक डेवलपर टूल में कुंजियाँ बना सकते हैं। नई कुंजी दिखते ही कॉपी करें; MCPBinder केवल उसका हैश रखता है और फिर नहीं दिखाता। पढ़ने या कार्य संपादन की पहुँच चुनें, समाप्ति तय करें और ज़रूरत न रहने पर रद्द करें।

हर अनुरोध HTTPS पर Authorization: Bearer YOUR_API_KEY के साथ भेजें। हर कुंजी प्रति मिनट 120 अनुरोध तक सीमित है। API JSON लौटाता है। प्रोजेक्ट और कार्य सूचियों में कर्सर पेजिनेशन है; हर पृष्ठ में अधिकतम 1,000 रिकॉर्ड हैं।

https://www.mcpbinder.com/api/v1

उपलब्ध एंडपॉइंट।

पढ़ने की पहुँच कार्यक्षेत्र विवरण, प्रोजेक्ट और कार्य समर्थित करती है। कार्य संपादन कुंजियाँ कार्य बना, अपडेट और संग्रहीत भी कर सकती हैं। अपडेट में मौजूदा संस्करण चाहिए; किसी ने पहले बदलाव किया हो तो API टकराव लौटाता है ताकि आप नवीनतम रिकॉर्ड लेकर फिर प्रयास करें।

createdAt जैसे टाइमस्टैम्प UTC में ISO 8601 स्ट्रिंग हैं, जैसे 2026-09-28T14:05:00.000Z। dueOn, 2026-09-28 जैसी कैलेंडर तिथि है, बिना समय या समय क्षेत्र।

• GET /workspace — मौजूदा कार्यक्षेत्र पहचान।
• GET /projects — दृश्यमान प्रोजेक्ट।
• GET /tasks — दृश्यमान सक्रिय कार्य; वैकल्पिक फ़िल्टर ?projectId={uuid}। GET /tasks/{id} — दृश्यमान कार्य रिकॉर्ड, संग्रहीत होने पर archivedAt सहित।
• POST /tasks — title और वैकल्पिक description, projectId तथा dueOn से कार्य बनाएँ।
• PATCH /tasks/{id} — title, description, dueOn, status, वर्कफ़्लो स्थिति, sectionId, labelIds या assignee अपडेट करें। version और कम से कम एक बदलने वाला फ़ील्ड शामिल करें।
• DELETE /tasks/{id}?version={n} — मौजूदा संस्करण से कार्य संग्रहीत करें। यह कार्य स्थायी रूप से नहीं मिटाता।

प्रोजेक्ट या कार्यों का हर पृष्ठ पढ़ें।

GET /projects और GET /tasks, limit (1–1,000; डिफ़ॉल्ट 1,000) और cursor स्वीकारते हैं। हर उत्तर में data, hasMore और nextCursor हैं। अगले अनुरोध में nextCursor को cursor दें, जब तक nextCursor null न हो। वही projectId फ़िल्टर रखें; क्वेरी मान URL-एन्कोड करें।

रिकॉर्ड स्थिर आरोही ID क्रम में लौटते हैं। संपादन आइटम को पृष्ठों के बीच नहीं ले जाता। कर्सर छेड़छाड़ से सुरक्षित और कार्यक्षेत्र, उपयोगकर्ता, संसाधन प्रकार तथा प्रोजेक्ट फ़िल्टर से जुड़े हैं। हर पृष्ठ पर अनुमति जाँच होती है। अमान्य या असंगत कर्सर 400 लौटाते हैं। यह लाइव सूची है, स्नैपशॉट नहीं: कर्सर से पहले नए रिकॉर्ड के लिए नई यात्रा चाहिए, जबकि संग्रहीत या अदृश्य रिकॉर्ड गायब होते हैं।

GET /api/v1/tasks?limit=100&projectId=PROJECT_UUID&cursor=NEXT_CURSOR

कार्य बनाएँ और अपडेट करें।

Content-Type: application/json के साथ JSON भेजें। बनाते समय Idempotency-Key हेडर दें ताकि उसी अनुरोध के पुनः प्रयास से काम दोहरा न बने।

• POST /tasks बॉडी: { "title": "Review launch brief", "projectId": "PROJECT_UUID" }।
• PATCH /tasks/TASK_UUID बॉडी: { "version": 1, "status": "in_progress" }।

कार्य घटनाओं की सदस्यता लें।

डेवलपर टूल में HTTPS एंडपॉइंट बनाएँ और मिलने वाली कार्य घटनाएँ चुनें। हर POST में घटना id, type, निर्माण समय और कार्य डेटा है: id, taskNumber, projectId, title, status, workflowStatusId, version और updatedAt। वर्तमान घटनाएँ task.created, task.updated, task.completed और task.archived हैं।

कार्य webhook स्वामी और व्यवस्थापक कॉन्फ़िगर करते हैं। ये चुने सार्वजनिक HTTPS एंडपॉइंट को कार्य शीर्षक और स्थिति मेटाडेटा भेजते हैं; उसका संचालक अपनी शर्तों पर जानकारी पाता है। done में बदलाव task.updated और task.completed दोनों भेजता है। डिलीवरी पृष्ठभूमि में चलती है, क्रम बदल सकता है और नेटवर्क विफलता से परिणाम अनिश्चित हो तो दोहराव हो सकता है। नेटवर्क विफलता, 408, 429 और 5xx पर बढ़ते अंतराल से अधिकतम छह प्रयास होते हैं; अन्य गैर-2xx उत्तर विफल चिह्नित हैं। सेवा घटना स्वीकार ले तो 2xx लौटाएँ और घटना id से डुप्लिकेट हटाएँ।

• X-MCPBinder-Event — घटना प्रकार।
• X-MCPBinder-Event-Id — पुनः प्रयासों में डुप्लिकेट हटाने के लिए स्थिर घटना id।
• X-MCPBinder-Delivery-Id — कतारबद्ध डिलीवरी का अनूठा id।
• X-MCPBinder-Timestamp — सेकंड में Unix टाइमस्टैम्प।
• X-MCPBinder-Signature — t={timestamp},v1={hex HMAC-SHA256}।

विफल घटनाएँ जाँचें और फिर भेजें।

डेवलपर टूल में Webhook डिलीवरी खोलें। पहले विफल घटनाएँ दिखती हैं; कतारबद्ध, चल रही और पूरी डिलीवरी के लिए सभी डिलीवरी चुनें। घटना जाँचें मूल अनुरोध बॉडी दिखाता है। स्थिति रीफ़्रेश करें या पुरानी घटनाओं के लिए और लोड करें। केवल स्वामी और व्यवस्थापक पेलोड जाँच या पुनः डिलीवरी माँग सकते हैं और हाल की सुरक्षा जाँच चाहिए।

रिसीवर ठीक करने के बाद घटना फिर भेजें चुनकर पुष्टि करें। नई डिलीवरी में मूल घटना ID और बिल्कुल वही बॉडी, नई डिलीवरी ID तथा नया टाइमस्टैम्प और हस्ताक्षर हैं। मूल विफल डिलीवरी बचती है और अनुरोध ऑडिट लॉग में दर्ज होता है। बार-बार क्लिक वही पुनः डिलीवरी इस्तेमाल करते हैं; विफल होने पर नई विफल डिलीवरी का प्रयास करें। रद्द एंडपॉइंट पर पुनः डिलीवरी नहीं हो सकती। हमेशा घटना ID से डुप्लिकेट हटाएँ, क्योंकि भेजने वाले को विफलता दिखने पर भी रिसीवर घटना स्वीकार सकता है।

webhook हस्ताक्षर सत्यापित करें।

एंडपॉइंट बनाते समय हस्ताक्षर गुप्त कुंजी कॉपी करें; यह एक बार दिखती है। JSON पार्स करने से पहले अनुरोध बॉडी मूल बाइट में पढ़ें। गुप्त कुंजी और UTF-8 स्ट्रिंग `${timestamp}.${rawBody}` से HMAC-SHA256 निकालें। स्थिर-समय तुलना से हेक्स डाइजेस्ट v1 से मिलाएँ और छोटी रीप्ले अवधि से बाहर के टाइमस्टैम्प अस्वीकार करें। तभी JSON पार्स करके घटना संभालें।

एंडपॉइंट URL सहेजते समय और डिलीवरी से पहले जाँचा जाता है। सार्वजनिक HTTPS पता इस्तेमाल करें। पूरा URL और हस्ताक्षर गुप्त कुंजी भंडारण में एन्क्रिप्ट हैं; सेटिंग में केवल एंडपॉइंट मूल दिखता है, पथ या क्वेरी नहीं। एंडपॉइंट रद्द करना आगे के कतारबद्ध भेज रोकता है, लेकिन भेजी घटना या चल रहा अनुरोध वापस नहीं ला सकता।

त्रुटियाँ और पहुँच।

401 का अर्थ कुंजी अनुपस्थित, समाप्त, रद्द है या निर्माता अब स्वामी या व्यवस्थापक नहीं; भूमिका खोने पर कुंजी स्वतः रद्द होती है। 403 का अर्थ आवश्यक अनुमति नहीं या प्रोजेक्ट निर्माता को नहीं दिखता। 409 का अर्थ कार्य संस्करण पुराना है। 429 में Retry-After है। कार्यक्षेत्र प्रोजेक्ट दृश्यता API कुंजियों पर भी लागू है।