AI ऐप कनेक्ट करें

आप Claude, ChatGPT, Cursor, Codex या MCP बोलने वाले किसी भी दूसरे AI क्लाइंट को ख़ुद VentionDesk से जोड़ सकते हैं — बिना API कुंजी के। ऐप आपके VentionDesk खाते से साइन इन करता है, और जोड़ते समय आप तय करते हैं कि वह क्या कर सकता है। यह मालिकों और स्टाफ़ सदस्यों के लिए काम करता है; ग्राहक पोर्टल के ग्राहक खाते कोई AI ऐप नहीं जोड़ सकते।

अंतरराष्ट्रीय यूज़र्स और ऐप डायरेक्टरी के लिए पेज, सभी टूल की सूची और उदाहरण प्रॉम्प्ट के साथ: AI ऐप को VentionDesk से जोड़ें।

कनेक्शन कैसे काम करता है (How a connection works)

1. URL डालें। AI ऐप में एक MCP सर्वर जोड़ें (अक्सर इसे “कनेक्टर” या “इंटीग्रेशन” कहा जाता है), इस URL के साथ: https://api.ventiondesk.com/mcp। ऐप को और कुछ नहीं चाहिए — साइन इन का रास्ता वह ख़ुद ढूँढ लेता है।
2. साइन इन करें। ऐप VentionDesk साइन इन के साथ एक ब्राउज़र विंडो खोलता है। अगर आप पहले से साइन इन हैं, तो वह सीधे आगे बढ़ता है।
3. सहमति दें। VentionDesk ऐप के नाम के साथ एक सहमति पेज दिखाता है (/oauth/zustimmen के तहत)। वहाँ आप चुनते हैं:
   • वर्कस्पेस, अगर आप एक से ज़्यादा के सदस्य हैं,
   • अनुमतियाँ — स्टाफ़ सदस्य के रूप में केवल वे जिन्हें मालिक ने AI ऐप के लिए जारी किया है,
   • प्रोजेक्ट — सभी (आने वाले प्रोजेक्ट भी) या एक चयन।
4. जुड़ गया। आपकी सहमति के बाद आप ऐप पर लौटते हैं। अब से वह ठीक इन्हीं अनुमतियों के साथ काम करता है — आपकी अपनी अनुमतियों के साथ नहीं। अगर आप मना करते हैं, तो कनेक्शन बिना कुछ सेव किए रद्द हो जाता है।

ऐप को वही टूल मिलते हैं जो एक एजेंट कुंजी को मिलते हैं (देखें Claude और MCP); कोई टूल क्या कर सकता है, यह आपकी चुनी हुई अनुमतियों से तय होता है। ऐप जो पढ़ता है, वह उसके प्रोवाइडर के पास जाता है — जैसे Anthropic, OpenAI या Anysphere। आपका वर्कस्पेस ऐसा कर सकता है या नहीं, यह उसका अपना फ़ैसला है; टिकट, ग्राहक डेटा और नामों वाले समय के लिए आमतौर पर प्रोवाइडर के साथ डेटा प्रोसेसिंग अनुबंध चाहिए।

Claude

claude.ai और Claude Desktop: Settings › Connectors में एक कस्टम कनेक्टर जोड़ें, नाम “VentionDesk” और URL https://api.ventiondesk.com/mcp। फिर “Connect” — साइन इन और सहमति ऊपर की तरह होते हैं। आपके प्लान और संगठन में कस्टम कनेक्टर चालू हैं या नहीं, यह Anthropic या आपका Claude एडमिनिस्ट्रेटर तय करता है।

Claude Code: टर्मिनल में

claude mcp add --transport http ventiondesk https://api.ventiondesk.com/mcp

और फिर Claude Code में /mcp चलाएँ और “ventiondesk” पर साइन इन करें। अगर आप एक तय कुंजी के साथ काम करना पसंद करते हैं, तो Claude और MCP देखें।

/aufgaben की तरह टास्क पूरे करें — बिना फ़ाइल सिस्टम वाले ऐप में भी: “Work on the next open VentionDesk task”। Claude टास्क रनर जैसे ही नियम से अगला टास्क लेता है, विवरण, इतिहास और प्रोजेक्ट पढ़ता है, स्क्रीनशॉट केवल ज़रूरत होने पर लाता है, नतीजा सबूत के साथ रिपोर्ट करता है और रन बंद करता है। इसके लिए कनेक्शन को “Claude रनर” टेम्पलेट की अनुमतियाँ चाहिए (टास्क पढ़ना और रिपोर्ट करना, रन चलाना, प्रोजेक्ट पढ़ना)।

ChatGPT

सेटिंग्स में Connectors के नीचे (वर्शन के हिसाब से “Apps & Connectors”; कस्टम MCP सर्वर के लिए डेवलपर मोड चाहिए) एक नया कनेक्टर बनाएँ: URL https://api.ventiondesk.com/mcp, ऑथेंटिकेशन OAuth। साइन इन और सहमति पहली बार इस्तेमाल पर होते हैं। किन प्लान में कस्टम कनेक्टर की अनुमति है, यह OpenAI तय करता है।

Cursor

~/.cursor/mcp.json (सभी प्रोजेक्ट के लिए) या .cursor/mcp.json (केवल इस प्रोजेक्ट के लिए) में:

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

फिर Cursor सर्वर को Settings › MCP में साइन इन सूचना के साथ दिखाता है; उस पर क्लिक करने से साइन इन और सहमति शुरू होती है।

Codex

~/.codex/config.toml में:

[mcp_servers.ventiondesk]
url = "https://api.ventiondesk.com/mcp"

फिर codex mcp login ventiondesk — ब्राउज़र साइन इन और सहमति खोलता है। Codex के पुराने वर्शन HTTP पर MCP केवल एक अतिरिक्त स्विच के साथ बोलते हैं; संदेह होने पर अपने Codex वर्शन की हेल्प देखें।

दूसरे क्लाइंट (Other clients)

OAuth के साथ HTTP पर MCP (“Streamable HTTP”) का समर्थन करने वाला हर क्लाइंट रास्ता ख़ुद ढूँढ लेता है: बिना साइन इन वाले अनुरोध पर https://api.ventiondesk.com/mcp 401 से जवाब देता है और https://api.ventiondesk.com/.well-known/oauth-protected-resource की ओर इशारा करता है; वहीं VentionDesk की साइन इन सेवा दर्ज है। क्लाइंट वहाँ ख़ुद को रजिस्टर करता है — आपको पहले से कुछ बनाने की ज़रूरत नहीं है।

कोई क्लाइंट जो OAuth स्कोप माँगता है (openid, email, profile), वे केवल साइन इन से जुड़े हैं। ऐप VentionDesk में क्या कर सकता है, यह सहमति पेज पर चुना जाता है।

डिस्कनेक्ट करना और समाप्ति (Disconnecting and expiry)

सेटिंग्स › मेरे AI ऐप्स में आप सभी वर्कस्पेस में अपने कनेक्शन देखते हैं: ऐप, अनुमतियाँ, प्रोजेक्ट, जुड़ने की तारीख़ और आख़िरी इस्तेमाल। “डिस्कनेक्ट करें” कनेक्शन को तुरंत ख़त्म करता है — ऐप को पहले से दिया गया साइन इन भी उसके बाद मान्य नहीं रहता। आपके अपने कनेक्शन के लिए VentionDesk साइन इन पर दी गई मंज़ूरी भी वापस ले लेता है; अगर आप ऐप को फिर से जोड़ते हैं, तो VentionDesk आपसे फिर पूछता है।

जो कनेक्शन 90 दिनों से इस्तेमाल नहीं हुआ, वह अपने-आप ख़त्म हो जाता है। ज़रूरत पड़ने पर ऐप को बस फिर से जोड़ लें।

मालिक के रूप में आप वहाँ अपने वर्कस्पेस के सभी लोगों के कनेक्शन भी देखते हैं और उनमें से किसी को भी डिस्कनेक्ट कर सकते हैं। आप यह भी तय करते हैं कि स्टाफ़ सदस्य किसी AI ऐप को कौन-सी अनुमतियाँ दे सकते हैं। डिफ़ॉल्ट रूप से ये “केवल पढ़ना” और “Claude रनर” टेम्पलेट की अनुमतियाँ हैं — प्रोजेक्ट, टास्क और डिप्लॉयमेंट पढ़ना, टास्क पर रिपोर्ट करना और रन दर्ज करना —, कुछ भी संवेदनशील नहीं। आप ख़ुद हर अनुमति दे सकते हैं, सिवाय एक्सेस दर्ज करने के, जो केवल ऑपरेटर कर सकता है। अगर आप जारी अनुमतियाँ घटाते हैं, तो यह मौजूदा कनेक्शन पर ऐप के अगले टोकन से लागू होता है — आमतौर पर एक घंटे के भीतर।

हर कनेक्शन और हर डिस्कनेक्ट आपके वर्कस्पेस के लॉग में दिखता है; ऐप द्वारा किए गए बदलाव वहाँ उतने दिखते हैं जितने VentionDesk लॉग करता है — हर एक ऐप और व्यक्ति के साथ, जैसे “AI ऐप: Claude · Anna Schmidt”।

AI ऐप या API कुंजी? (AI app or API key?)