MCP इंटीग्रेशन

Claude Code, Codex, ChatGPT, Cursor, Claude Desktop जैसे AI को Addness से जोड़ने (MCP इंटीग्रेशन) पर, AI Addness के लक्ष्य, ToDo, टिप्पणियाँ आदि पढ़ और लिख सकता है।

पहली बार उपयोग करने वालों के लिए: जिन्होंने नया संगठन बनाया है और जो आमंत्रण से किसी संगठन में शामिल हुए हैं, उनके लक्ष्य पेज पर "Addness सेट अप करें" होता है। उसके अंदर "1. अपने AI को Addness से जोड़ें" की पंक्ति पर "AI से पूछें" → "Claude Code में खोलें" (या "Codex में खोलें") दबाएँ, तो AI Addness से कनेक्शन से शुरू करके क्रम से आगे बढ़ता है (→ लक्ष्य पेज)। AI ऐप इंस्टॉल करने से शुरू होने वाले चरण AI ऐप इंस्टॉल करें और Addness से जोड़ें में हैं। यह लेख केवल MCP-एकीकरण वाले हिस्से को समझाता है।

AI को अनुरोध भेजें

आप जिस AI का उपयोग करते हैं, बस उसे यह अनुरोध भेजिए।

कृपया Addness MCP (https://vt.api.addness.com/mcp) सेट अप करें।

AI जहाँ तक कर सकता है वहाँ तक आगे बढ़ता है और केवल वहीं मार्गदर्शन करता है जहाँ आपकी कार्रवाई ज़रूरी हो। केवल ब्राउज़र में साइन-इन की स्वीकृति, जब AI आपको वहाँ तक पहुँचाए तब कृपया स्वयं करें।

AI क्या-क्या कर पाएगा

आप किसी भी AI से जोड़ें, वह उसी संगठन के उसी गोल ट्री को पढ़ता और लिखता है।

अगर बीच में रुक जाए: टूल के अनुसार चरण

अगर सेटअप अनुमतियों या प्रमाणीकरण पर रुक जाए, तो नीचे दिए चरण AI को दिखाइए, या स्वयं आगे बढ़िए।

ChatGPT (आधिकारिक प्लगइन)

ChatGPT में “@Addness” टाइप करें या ऐप सूची से Addness चुनें। “कनेक्ट करें” दबाएँ, Addness में साइन इन करें और “अनुमति दें” दबाएँ। Free प्लान में उपलब्ध। बदलाव करने से पहले पुष्टि ज़रूरी है। सिर्फ़ पहले से मौजूद Addness खाता ही जोड़ा जा सकता है (ChatGPT की स्क्रीन से नया पंजीकरण नहीं हो सकता)।

Claude Code (टर्मिनल)

1. Addness MCP जोड़ें (--scope user के साथ, ताकि यह किसी भी प्रोजेक्ट से उपयोग हो सके)

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

1. Addness में साइन इन करें (जब ब्राउज़र खुले, तो अपने Addness खाते से स्वीकृति दें)

claude mcp login addness

1. कनेक्शन जाँचें (अगर सूची में addness दिखे तो हो गया; आप Claude Code के अंदर /mcp से भी जाँच सकते हैं)

claude mcp list

Codex (CLI)

आप इसे केवल ब्राउज़र में Addness में साइन इन करके उपयोग कर सकते हैं। API कुंजी बनाने की ज़रूरत नहीं है (पुराना Codex OAuth का समर्थन नहीं करता, इसलिए चलाने से पहले नवीनतम संस्करण में अपडेट करें)।

1. Addness MCP जोड़ें (ब्राउज़र स्वतः खुलता है, इसलिए अपने Addness खाते से स्वीकृति दें। सेटिंग्स ~/.codex/config.toml में सहेजी जाती हैं)

codex mcp add addness --url https://vt.api.addness.com/mcp

1. कनेक्शन जाँचें (अगर Auth OAuth है तो हो गया। अगर साइन-इन शुरू नहीं हुआ, तो codex mcp login addness चलाएँ)

codex mcp list

Cursor

1. ~/.cursor/mcp.json खोलें और निम्न सेटिंग जोड़ें (अगर आपके पास अन्य सर्वर हैं, तो केवल addness प्रविष्टि जोड़ें)

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

1. Cursor की Settings → Tools & MCP में addness के लिए Connect दबाएँ और ब्राउज़र में अपने Addness खाते से स्वीकृति दें

Claude Desktop

रिमोट MCP को कॉन्फ़िग फ़ाइल से नहीं, बल्कि एक कस्टम कनेक्टर के रूप में जोड़ें।

1. Customize → Connectors खोलें और + → Add custom connector चुनें
2. नाम को Addness और URL को https://vt.api.addness.com/mcp सेट करें और सहेजें (Team / Enterprise पर, Owner द्वारा संगठन कॉन्फ़िगरेशन आवश्यक है)
3. Addness के लिए Connect दबाएँ और ब्राउज़र में स्वीकृति दें (आप इसे प्रति बातचीत Connectors से सक्षम कर सकते हैं)

अन्य MCP-संगत क्लाइंट

कोई भी MCP क्लाइंट जो Streamable HTTP और OAuth का समर्थन करता है, जुड़ सकता है।

1. सर्वर नाम को addness और ट्रांसपोर्ट को Streamable HTTP पर सेट करें
2. कनेक्शन लक्ष्य के रूप में https://vt.api.addness.com/mcp निर्दिष्ट करें
3. क्लाइंट के प्रमाणीकरण बटन से Addness में साइन इन करें; टूल सूची प्राप्त होते ही हो गया

जाँचें कि जुड़ गया है या नहीं

AI से कहें, "Addness में मेरे संगठनों की सूची दिखाओ"। अगर आप जिन संगठनों में हैं उनके नाम लौटते हैं, तो जुड़ गया है। "Addness में मेरे ToDo दिखाओ" कहकर भी जाँच सकते हैं कि आपके ToDo लौटते हैं या नहीं।

अगर आप एक से ज़्यादा संगठनों में हैं, तो काम शुरू करने से पहले AI से कहें, "Addness में संगठन को 〈संगठन का नाम〉 पर बदल दो"। AI उस संगठन को बदल देता है जिसमें वह काम करता है (switch_organization)। अगर वह पहले से उसी संगठन से जुड़ा है, तो कुछ नहीं बदलता। बदला हुआ संगठन उसी AI की अगली बातचीत में भी बना रहता है।

अगर AI जवाब दे कि "Addness के टूल नहीं हैं" या "प्रमाणीकरण ज़रूरी है", तो अगर जुड़ न पाए देखें।

स्क्रीन से सौंपने के लिए: "AI से पूछें"

शब्दों में कहने के बजाय, आप इसे किसी लक्ष्य की पंक्ति के दाईं ओर के ✦ ("AI से पूछें") से भी सौंप सकते हैं (मोबाइल चौड़ाई पर पंक्ति के "…" → "AI से पूछें")।

• आगे बढ़ाएँ: AI उस लक्ष्य का संदर्भ पढ़कर सीधे आगे बढ़ता है
• विचार-मंथन करें: AI आपसे बात करते हुए चीज़ें व्यवस्थित करता है और उप-लक्ष्यों के प्रस्ताव देता है। केवल वही बनाए जाते हैं जिन्हें आप OK करते हैं
• प्रश्न पूछें: जो जानना है वह लिखकर भेजें, AI लक्ष्य पढ़कर जवाब देता है। लक्ष्य में कोई बदलाव नहीं करता

"Claude Code में खोलें", "Codex में खोलें" या "ChatGPT में खोलें" दबाएँ, और AI एक ऐसे निर्देश के साथ खुलता है जिसमें लक्ष्य का URL और आगे बढ़ने का तरीका शामिल होता है। "निर्देश कॉपी करें" से, आप इसे Cursor जैसे किसी अन्य AI में पेस्ट करके उपयोग कर सकते हैं। व्यक्तिगत सेटिंग्स के "AI" में "निर्देश भेजने की जगह" तय कर लें, तो हर बार चुने बिना एक क्लिक में खुल जाता है। क्या होता है इसकी विस्तृत व्याख्या के लिए, देखें लक्ष्य पेज।

बाहरी इंटीग्रेशन API से अंतर

MCP इंटीग्रेशन से आपका AI आपके अपने साइन-इन खाते के नाम से Addness में पढ़ता और लिखता है। अगर आपके सिस्टम को सिर्फ़ संगठन के सदस्य और आज के To-do पढ़ने हैं, तो संगठन से जुड़ी कुंजी से चलने वाला बाहरी इंटीग्रेशन API (केवल पढ़ने के लिए) इस्तेमाल करें। बाहरी इंटीग्रेशन की कुंजी MCP में काम नहीं करती। यह API केवल उन संगठनों के लिए उपलब्ध है जिन्हें Addness ने चालू किया है।

अगर जुड़ न पाए

यहाँ आम दिक्कतें और उन्हें ठीक करने के तरीके दिए गए हैं। AI ऐप इंस्टॉल करने और जोड़ने का तरीका AI ऐप इंस्टॉल करें और Addness से जोड़ें में है।

Addness के टूल उपयोग नहीं हो पा रहे

• जोड़ने के बाद भी AI कहता है कि "Addness के टूल नहीं हैं": कंप्यूटर पर Claude Code या Codex में, जोड़ने के ठीक बाद, AI ऐप दोबारा खोलने तक टूल नहीं दिखते। ऐप बंद करके दोबारा खोलें, वही बातचीत चुनें और "आगे बढ़ो" भेजें। सिर्फ़ विंडो बंद करने से ऐप बंद नहीं होता। Mac पर Command + Q दबाकर ऐप बंद करें। Windows पर Alt + F4 से बंद करें, और अगर स्क्रीन के नीचे दाईं ओर उसका आइकॉन बचा रहे, तो उस पर राइट-क्लिक करके "बाहर निकलें" चुनें। टर्मिनल में Ctrl + C दो बार दबाकर बंद करें, और claude --resume (Codex में codex resume) से उसी बातचीत पर लौटें
• दोबारा खोलने के बाद भी कहता है कि "नहीं हैं": Claude Code कभी-कभी Addness के टूल तब तक लोड नहीं करता, जब तक उनका उपयोग करने की ज़रूरत न पड़े। AI से कहें, "Addness के टूल ढूँढकर उनका उपयोग करो"
• हर बार टूल का उपयोग करते समय अनुमति माँगता है और रुक जाता है: AI से कहें, "ऐसी सेटिंग कर दो कि तुम Addness के टूल हर बार मुझसे पूछे बिना उपयोग कर सको"। Claude Code में, इससे सेटिंग फ़ाइल (~/.claude/settings.json) की अनुमति सूची में mcp__addness जुड़ जाता है
• कॉन्टेक्स्ट में जगह खाली करने के लिए Addness के टूल हटा दिए थे: जब तक वे हटे रहते हैं, AI, Addness के लक्ष्य और टू-डू नहीं पढ़ सकता। Addness के साथ काम करते समय उन्हें जुड़ा रहने दें। अगर हटा दिए हैं, तो AI से कहें, "Addness के टूल फिर से चालू कर दो", और ऐप दोबारा खोलें
• ब्राउज़र में Claude या ChatGPT में Addness नहीं दिखता: ChatGPT में आधिकारिक प्लगइन से या ब्राउज़र वाले Claude में कस्टम कनेक्टर से Addness कनेक्ट करें। सिर्फ़ फ़ोन पर Addness इस्तेमाल करें देखें।

साइन इन आगे नहीं बढ़ता या कनेक्शन कट जाता है

• साइन इन की स्क्रीन नहीं खुलती: AI से कहें, "Addness का साइन इन शुरू करो और URL दिखाओ"। दिखाया गया URL ब्राउज़र में पेस्ट करके खोलें और "अनुमति दें" दबाएँ। अगर "अनुमति दें" वाली स्क्रीन न दिखे या कोई दूसरा ब्राउज़र खुल जाए, तो AI ऐप इंस्टॉल करें और Addness से जोड़ें का "अगर काम न करे" देखें
• "अनुमति दें" दबाने के बाद भी त्रुटि आती है: साइन इन की स्क्रीन खुली छोड़कर समय बीत जाए, तो "अधिकृत करने का कोड तैयार नहीं हो सका" जैसी त्रुटि आती है। AI से दोबारा साइन इन शुरू करवाएँ, और खुलने वाली स्क्रीन पर तुरंत "अनुमति दें" दबाएँ
• पहले काम कर रहा था, पर अब साइन इन माँग रहा है या बार-बार साइन इन माँगता है: Addness से कनेक्शन 90 दिनों में ख़त्म हो जाता है। इन स्थितियों में यह 90 दिनों से पहले कट जाता है। उसी AI ऐप से दोबारा जोड़ने पर, उस ऐप का पिछला कनेक्शन कट जाता है। एक व्यक्ति अधिकतम 20 कनेक्शन रख सकता है, और इससे ज़्यादा होने पर सबसे लंबे समय से इस्तेमाल न हुआ कनेक्शन पहले कटता है (कई कंप्यूटर या AI इस्तेमाल करने वालों के पुराने कनेक्शन इसी वजह से कट सकते हैं)। AI से कहें, "Addness में फिर से साइन इन करो", और ब्राउज़र में "अनुमति दें" दबाएँ
• कंपनी और निजी खाते में ग़लत खाता चुन लिया: AI उसी खाते से जुड़ता है, जो "Addness MCP से कनेक्ट करें" स्क्रीन पर "… के रूप में साइन इन हैं" में दिखता है। "अनुमति दें" दबाने से पहले ईमेल पता जाँच लें। अगर ग़लत खाते से जोड़ दिया है, तो ब्राउज़र के Addness में सही खाते से फिर से साइन इन करें, फिर AI से कहें, "Addness में फिर से साइन इन करो"

किसी दूसरे संगठन से जुड़ा है

• AI कहता है कि "आइटम नहीं मिला", या दूसरे संगठन के लक्ष्य पढ़ रहा है: AI उसी संगठन से जुड़ता है, जो "अनुमति दें" दबाते समय ब्राउज़र के Addness में चुना हुआ था। अगर आप एक से ज़्यादा संगठनों में हैं, तो AI से कहें, "Addness में संगठन को 〈संगठन का नाम〉 पर बदल दो"। किसी लक्ष्य का URL देते समय भी, पहले उस संगठन पर बदलवाएँ जिसमें वह लक्ष्य है, फिर अनुरोध करें

Windows पर रुक जाता है

• Codex से जोड़ते समय बीच में, या फ़ोन से भेजा गया अनुरोध रुक जाता है: सिर्फ़ Codex ऐप इंस्टॉल करने से, हो सकता है कि कंप्यूटर पर codex कमांड उपयोग न हो पाए। Windows पर ऐसे मामले रहे हैं जिनमें यही वजह थी। AI से कहें, "जाँचो कि codex कमांड चलती है या नहीं, और न चले तो इंस्टॉल कर दो"। अगर "Codex में खोलें" दबाने पर भी Codex न खुले, तो "निर्देश कॉपी करें" दबाएँ, और Codex में पेस्ट करके भेज दें
• Windows वाले Codex में Addness का साइन इन पूरा नहीं होता: Codex को नवीनतम संस्करण में अपडेट करें और फिर से साइन इन करें। फिर भी पूरा न हो, तो आप Claude Code से भी जोड़ सकते हैं

<a id="mobile-only"></a>

सिर्फ़ फ़ोन पर Addness इस्तेमाल करें

• ChatGPT ऐप: ChatGPT में “@Addness” टाइप करें या ऐप सूची से Addness चुनें। “कनेक्ट करें” दबाएँ, Addness में साइन इन करें और “अनुमति दें” दबाएँ।
• Claude ऐप: Safari में claude.ai खोलें → कस्टमाइज़ करें → कनेक्टर → ＋जोड़ें → कस्टम कनेक्टर जोड़ें → नाम Addness और URL https://vt.api.addness.com/mcp डालें → कनेक्ट करें और अनुमति दें। Claude ऐप में Addness चालू करें, निर्देश पेस्ट करें और भेजें।
• कंप्यूटर पर जारी रखें: अपने कंप्यूटर पर AI को काम भेजने के लिए फ़ोन से भेजे गए अनुरोध नहीं पहुँचते में दिए गए चरणों का पालन करें।

<a id="phone-pc-relay"></a>

फ़ोन से अनुरोध नहीं कर पा रहे

“फ़ोन से भेजे गए अनुरोध नहीं पहुँचते” में बताया गया है कि कंप्यूटर पर AI को काम कैसे भेजें। सिर्फ़ फ़ोन इस्तेमाल करने के लिए “सिर्फ़ फ़ोन पर Addness इस्तेमाल करें” देखें।

फ़ोन के Addness ऐप का "AI से पूछें", आपका अनुरोध कंप्यूटर के Claude Code या Codex तक पहुँचाता है। इसके लिए कंप्यूटर पर Addness का डेस्कटॉप ऐप (→ वेब संस्करण और डेस्कटॉप ऐप) इंस्टॉल होना चाहिए, उसी Addness खाते से साइन इन करके खुला रहना चाहिए, और कंप्यूटर जागा हुआ होना चाहिए। फ़ोन पर खुला संगठन और डेस्कटॉप ऐप का संगठन भी एक ही रखें। कंप्यूटर पर "फ़ोन से अपने AI को काम सौंपें" लक्ष्य AI को सौंप दें, तो यह तैयारी AI आगे बढ़ाता है। कंपनी के Windows कंप्यूटर पर कभी-कभी डेस्कटॉप ऐप नहीं चल पाता।

• "आपके कंप्यूटर का AI अभी जुड़ा नहीं है" दिखता है: कंप्यूटर की तैयारी अभी पूरी नहीं हुई है। कंप्यूटर पर Addness खोलें, "फ़ोन से अपने AI को काम सौंपें" पर "AI से पूछें" (✦) दबाएँ और आगे बढ़ें
• "PC जागने पर शुरू होगा" दिखता रहता है और कुछ नहीं होता: कंप्यूटर स्लीप में है, या डेस्कटॉप ऐप बंद है। कंप्यूटर को जगाकर ऐप खोलें, तो काम शुरू हो जाता है। 24 घंटे बीतने पर अनुरोध रद्द हो जाता है
• "PC पर Codex नहीं मिला" दिखता है: कंप्यूटर पर codex कमांड इंस्टॉल नहीं है। कंप्यूटर के AI से कहें, "codex कमांड इंस्टॉल कर दो", और इंस्टॉल होने के बाद डेस्कटॉप ऐप दोबारा खोलें
• Mac के ChatGPT ऐप में शामिल Codex इस्तेमाल कर रहे हैं: डेस्कटॉप ऐप को ChatGPT ऐप के अंदर वाला Codex नहीं मिलता। कंप्यूटर के AI से कहें, "codex कमांड इंस्टॉल कर दो", और इंस्टॉल होने के बाद डेस्कटॉप ऐप दोबारा खोलें (डेस्कटॉप ऐप Codex को सिर्फ़ होम फ़ोल्डर के .local/bin में, और उन जगहों पर ढूँढता है जहाँ टर्मिनल कमांड ढूँढता है)
• "PC के Addness में वर्किंग फ़ोल्डर चुनें" या "PC के Addness में वर्किंग फ़ोल्डर नहीं चुना गया है" दिखता है: कंप्यूटर पर डेस्कटॉप ऐप की सेटिंग्स में "リモート操作" (रिमोट कंट्रोल) खोलें, और सबसे ऊपर "作業フォルダ" (वर्किंग फ़ोल्डर) में वह फ़ोल्डर चुनें जिसमें AI काम करे। चुनने तक अनुरोध न Claude Code तक पहुँचते हैं, न Codex तक
• "PC के Addness को अपडेट करें" दिखता है: कंप्यूटर का डेस्कटॉप ऐप पुराना संस्करण है। उसे नवीनतम संस्करण में अपडेट करके फिर से भेजें
• "PC के Addness में Codex का “फ़ोन से स्वीकार करें” बंद है" दिखता है: कंप्यूटर पर डेस्कटॉप ऐप की सेटिंग्स में "リモート操作" (रिमोट कंट्रोल) खोलें, और "Codex" भाग में "スマホから受け付ける" (फ़ोन से स्वीकार करें) चालू करें (पहले "作業フォルダ" (वर्किंग फ़ोल्डर) चुन लें)
• Claude Code तक नहीं पहुँचता: जाँचें कि फ़ोन के Claude ऐप में उसी Claude खाते से साइन इन है, जिससे कंप्यूटर पर है

फिर भी नहीं जुड़ रहा

• किसी भी तरीके से नहीं जुड़ता: हो सकता है कि एंटीवायरस सॉफ़्टवेयर या कंपनी का नेटवर्क Addness के साथ संचार रोक रहा हो। कुछ मामलों में, सॉफ़्टवेयर की सेटिंग में vt.api.addness.com को जाँच से बाहर करने पर जुड़ गया। कंपनी का कंप्यूटर हो, तो अपनी IT टीम से पूछें
• यहाँ तक आज़माने के बाद भी आगे नहीं बढ़ता: जहाँ रुका है उस स्क्रीन का स्क्रीनशॉट लगाकर, सहायता होम पर "Addness के बारे में प्रश्न" से हमसे संपर्क करें