# MCP के ज़रिए दूसरे ऐप्स से Dvina इस्तेमाल करें

> Claude Code, ChatGPT या Cursor जैसे MCP क्लाइंट को Dvina से कनेक्ट करें, साइन इन करें और अपनी अनुमति से उसे आपके Dvina में मौजूद जानकारी पढ़ने और नई जानकारी जोड़ने दें।

Dvina का अपना MCP सर्वर है। Claude Code, ChatGPT या Cursor जैसे किसी MCP क्लाइंट को कनेक्ट करें। इसके बाद वह ऐप आपकी ओर से आपके Dvina में खोज सकता है, आपके दस्तावेज़ और मेमोरी पढ़ सकता है, और नोट्स, टास्क और रिमाइंडर जोड़ सकता है।

## शुरू करने से पहले

आपको सर्वर के पते की ज़रूरत होगी:

```text
https://api.dvina.ai/mcp
```

अगर आपकी कंपनी अपने सर्वर पर Dvina चलाती है, तो अपनी कंपनी के Dvina API पते के अंत में `/mcp` जोड़कर इस्तेमाल करें। यह पता अपने एडमिन से माँगें।

सर्वर Streamable HTTP का इस्तेमाल करता है। अगर क्लाइंट आपसे ट्रांसपोर्ट चुनने को कहे, तो HTTP चुनें।

## क्लाइंट कनेक्ट करें

::: tabs

=== Claude Code

1. अपने टर्मिनल में यह चलाएँ:

    ```sh
    claude mcp add --transport http dvina https://api.dvina.ai/mcp
    ```

2. Claude Code शुरू करें, `/mcp` चलाएँ, **dvina** चुनें और Dvina में साइन इन करें।

=== ChatGPT

1. ChatGPT में वह जगह खोलें जहाँ आप MCP सर्वर जोड़ सकते हैं।
2. सर्वर के पते के रूप में `https://api.dvina.ai/mcp` दर्ज करें। अगर साइन इन करने का तरीका पूछा जाए, तो OAuth चुनें।
3. जब ChatGPT कहे, तो Dvina में साइन इन करें।

=== Cursor

1. Open the place where Cursor lets you add an MCP server.
2. Add a server named `dvina` with the address `https://api.dvina.ai/mcp`.
3. Sign in to Dvina when Cursor asks.

:::

आपको क्लाइंट ID या सीक्रेट की ज़रूरत नहीं है। पहली बार कनेक्ट होने पर क्लाइंट खुद को Dvina में रजिस्टर कर लेता है।

## साइन इन करें

Dvina का MCP सर्वर आपके ब्राउज़र में OAuth के ज़रिए आपको साइन इन कराता है:

1. Dvina में उसी तरह साइन इन करें जैसे आप आम तौर पर करते हैं।
2. अगर आप एक से ज़्यादा वर्कस्पेस के सदस्य हैं, तो **वर्कस्पेस चुनें** के तहत एक चुनें, फिर **जारी रखें** चुनें। क्लाइंट केवल उसी वर्कस्पेस में काम करता है।
3. **ऐक्सेस की अनुमति दें** के तहत ऐप का नाम जाँचें, फिर **ऐक्सेस दें** चुनें। अगर आप ऐप को नहीं पहचानते, तो **अस्वीकार करें** चुनें।

क्लाइंट कनेक्ट रहता है, इसलिए आपको हर बार साइन इन नहीं करना पड़ता।

## क्लाइंट क्या कर सकता है

क्लाइंट को Dvina के टूल दिखाई देते हैं और वह आपके अनुरोध के लिए ज़रूरी होने पर उनका इस्तेमाल करता है:

| क्षेत्र                   | क्लाइंट क्या कर सकता है                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **खोज**             | आपकी चैट, दस्तावेज़ों, मेमोरी और वर्ल्ड में एक साथ खोज सकता है।                                                                                      |
| **मेमोरी**             | आपकी मेमोरी फ़ाइलों की सूची देख सकता है, उन्हें पढ़ सकता है, नई फ़ाइल जोड़ सकता है या किसी फ़ाइल में बदलाव कर सकता है।                                                                               |
| **वर्ल्ड**              | आपके विषयों की सूची देख सकता है, दिखा सकता है कि Dvina किसी विषय या किसी और चीज़ के बारे में क्या जानता है, और आपके फ़ीड की सूची देख सकता है।                                                  |
| **दस्तावेज़**          | आपकी लाइब्रेरी की सूची देख सकता है, उसे पढ़ सकता है और उसमें खोज सकता है, नोट और फ़ोल्डर बना सकता है, फ़ाइलें अपलोड कर सकता है, और किसी दस्तावेज़ को बदल सकता है, दूसरी जगह ले जा सकता है, उसका नाम बदल सकता है या उसे ट्रैश में डाल सकता है। |
| **कैनवस**             | आपके कैनवस की सूची देख सकता है, उन्हें पढ़ सकता है, नया कैनवस बना सकता है या किसी पेज को दोबारा लिख सकता है।                                                                             |
| **टास्क और लक्ष्य**    | आपके टास्क की सूची देख सकता है और पढ़ सकता है कि उन्होंने क्या किया, कोई टास्क या लक्ष्य की दिशा में काम करने वाला टास्क शुरू कर सकता है, किसी टास्क को और काम दे सकता है या उसे रोक सकता है।                |
| **शेड्यूल किए गए संदेश** | उनकी सूची देख सकता है, एक बार या बार-बार भेजे जाने वाला संदेश या रिमाइंडर शेड्यूल कर सकता है या उसे रद्द कर सकता है।                                                                 |
| **एजेंट और स्किल**  | आपके एजेंट और स्किल की सूची देख सकता है, उन्हें पढ़ सकता है, नया एजेंट बना सकता है, स्किल जोड़ सकता है या इनमें से किसी में बदलाव कर सकता है।                                                        |
| **प्रोजेक्ट**           | आपके प्रोजेक्ट की सूची देख सकता है और किसी प्रोजेक्ट का फ़ोल्डर और हाल के टास्क दिखा सकता है।                                                                             |
| **शेयर करना**            | देख सकता है कि किसी आइटम तक किसकी पहुँच है और दूसरों ने आपके साथ क्या शेयर किया है, या किसी को पहुँच दे सकता है या उसकी पहुँच हटा सकता है।                                           |
| **सेटिंग्स**           | आपकी प्राथमिकताएँ दिखा सकता है या मेमोरी चालू या बंद कर सकता है।                                                                                             |

क्लाइंट किसी भी चीज़ को हमेशा के लिए मिटा नहीं सकता, सार्वजनिक लिंक खोल नहीं सकता, ऐप कनेक्ट या डिस्कनेक्ट नहीं कर सकता, और एडमिन या बिलिंग सेटिंग्स बदल नहीं सकता।

## बदलावों को मंज़ूरी दें

क्लाइंट के काम पर वही नियम लागू होते हैं जो Dvina में हर जगह लागू होते हैं:

- पढ़ने का काम आपसे पूछे बिना होता है।
- कोई नई चीज़ जोड़ने का काम, जैसे नोट, मेमोरी फ़ाइल या टास्क, आपसे पूछे बिना होता है। इससे पहले से मौजूद किसी चीज़ में कभी बदलाव नहीं होता।
- किसी चीज़ को बदलने या हटाने से पहले आपसे पूछा जाता है, जैसे किसी दस्तावेज़ को ट्रैश में डालना, कैनवस के किसी पेज को दोबारा लिखना, किसी टास्क को रोकना या कोई आइटम शेयर करना। क्लाइंट बदलाव का सारांश दिखाता है, जो Dvina ने खुद तैयार किया होता है, और आप उसे मंज़ूरी देते हैं या अस्वीकार करते हैं। अस्वीकार करने पर कुछ भी नहीं बदलता।

> [!NOTE]
> अगर कोई क्लाइंट आपसे पुष्टि नहीं माँग सकता, तो Dvina उस क्लाइंट के ज़रिए बदलाव नहीं करता। इसके बजाय Dvina ऐप में बदलाव करें या ऐसा क्लाइंट इस्तेमाल करें जो आपसे पुष्टि माँग सके।

## आपकी पहुँच और आपकी कंपनी के नियम

क्लाइंट आपकी ओर से काम करता है और Dvina में वही देख और कर सकता है जो आप देख और कर सकते हैं:

- यह केवल तब तक काम करता है जब तक आप वर्कस्पेस के सदस्य हैं, और केवल वही काम करता है जिनकी आपकी भूमिका अनुमति देती है।
- अगर आपका एडमिन कोई सुविधा बंद कर देता है, जैसे फ़ाइल अपलोड करना, तो क्लाइंट भी उसका इस्तेमाल नहीं कर सकता।
- क्लाइंट जो कुछ जोड़ता या बदलता है, उस पर ऐप की तरह ही आपकी कंपनी के डेटा सुरक्षा नियम लागू होते हैं।
- वह जो कुछ जोड़ता या बदलता है, उसे आपके [ऑडिट लॉग](/docs/teams/audit-log) में आपके लिए असिस्टेंट की कार्रवाई के रूप में दर्ज किया जाता है, साथ ही यह भी दर्ज होता है कि वह किस क्लाइंट से आई थी।
- उसके काम की गिनती आपके उपयोग में होती है और उस पर आपकी सामान्य सीमाएँ लागू होती हैं।

## OAuth के बजाय API कुंजी से कनेक्ट करें

Enterprise प्लान में, क्लाइंट साइन इन करने के बजाय व्यक्तिगत एक्सेस टोकन से कनेक्ट कर सकता है। इसका इस्तेमाल ऐसे क्लाइंट के लिए करें जो OAuth से साइन इन नहीं कर सकता, या किसी स्क्रिप्ट के लिए करें।

1. सेटिंग्स खोलें और **API एक्सेस** चुनें।
2. **व्यक्तिगत एक्सेस टोकन** के तहत, **टोकन बनाएँ** चुनें।
3. एक **नाम** दर्ज करें, **एक्सेस** चुनें और तय करें कि वह कब **समाप्त होगा**, फिर **टोकन बनाएँ** चुनें।
4. **अपना टोकन कॉपी करें** के तहत, टोकन कॉपी करें। टोकन केवल इसी समय दिखाया जाता है।

क्लाइंट के लिए ज़रूरी एक्सेस चुनें:

- **केवल पढ़ने के लिए:** क्लाइंट को केवल पढ़ने वाले टूल दिखाई देते हैं। वह आपके Dvina में खोज सकता है और पढ़ सकता है, लेकिन कुछ भी जोड़ या बदल नहीं सकता।
- **पढ़ने और लिखने के लिए:** क्लाइंट को सभी टूल दिखाई देते हैं, और OAuth की तरह ही बदलावों के लिए अब भी आपकी मंज़ूरी माँगी जाती है।

टोकन को `Authorization` हेडर में `Bearer` के बाद भेजें। उदाहरण के लिए, Claude Code में:

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

किसी दूसरे क्लाइंट में, जहाँ वह आपको MCP सर्वर के लिए हेडर सेट करने देता है, वहाँ यही हेडर जोड़ें।

टोकन आपकी ओर से उसी वर्कस्पेस में काम करता है जिसमें आपने उसे बनाया था, और वहाँ आपकी मौजूदा भूमिका के अनुसार काम करता है। उसे बदलने के लिए, **व्यक्तिगत एक्सेस टोकन** के तहत उसे खोलें और **नया टोकन जारी करें…** चुनें: नया टोकन उसकी जगह ले लेता है और पुराना टोकन तुरंत काम करना बंद कर देता है। उसे बंद करने के लिए, **रद्द करें…** चुनें: उसका इस्तेमाल करने वाली हर चीज़ तुरंत काम करना बंद कर देती है।

टोकन के बारे में और जानकारी के लिए, [API एक्सेस](/docs/dvina-mcp/api-access) देखें।

## संबंधित

- [कस्टम ऐप और MCP सर्वर](/docs/connectors/custom-apps)
- [API एक्सेस](/docs/dvina-mcp/api-access)
- [dvina कमांड का इस्तेमाल करें](/docs/dvina-mcp/cli)
- [टीम का अवलोकन](/docs/teams/overview)