# MCP ilə digər tətbiqlərdən Dvina istifadə edin > Claude Code, ChatGPT və ya Cursor kimi MCP klientini Dvina-ya qoşun, hesabınıza daxil olun və ona təsdiqinizlə Dvina-dakı məlumatları oxumağa və yeni məlumatlar əlavə etməyə icazə verin. Dvina-nın öz MCP serveri var. Claude Code, ChatGPT və ya Cursor kimi MCP klientini qoşun. Həmin tətbiq sizin adınızdan Dvina-da axtarış edə, sənədlərinizi və yaddaşınızı oxuya, qeydlər, tapşırıqlar və xatırlatmalar əlavə edə bilər. ## Başlamazdan əvvəl Serverin ünvanı lazımdır: ```text https://api.dvina.ai/mcp ``` Şirkətiniz Dvina-nı öz serverlərində işlədirsə, şirkətinizin Dvina API ünvanının sonuna `/mcp` əlavə edib istifadə edin. Ünvanı administratorunuzdan soruşun. Server Streamable HTTP istifadə edir. Klient nəqliyyat protokolunu soruşursa, HTTP seçin. ## Klienti qoşun ::: tabs === Claude Code 1. Terminalda bu əmri icra edin: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp ``` 2. Claude Code-u başladın, `/mcp` əmrini icra edin, **dvina** seçin və Dvina hesabınıza daxil olun. === ChatGPT 1. ChatGPT-də MCP serveri əlavə edə biləcəyiniz bölməni açın. 2. Serverin ünvanı kimi `https://api.dvina.ai/mcp` daxil edin. Giriş üsulu soruşularsa, OAuth seçin. 3. ChatGPT istədikdə Dvina hesabınıza daxil olun. === 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. ::: Klient ID-si və ya məxfi açar lazım deyil. Klient ilk dəfə qoşulduqda Dvina-da özünü qeydiyyatdan keçirir. ## Hesabınıza daxil olun Dvina-nın MCP serveri brauzerinizdə OAuth vasitəsilə hesabınıza giriş edir: 1. Dvina hesabınıza həmişəki qaydada daxil olun. 2. Birdən çox iş sahəsinə üzvsünüzsə, **İş sahəsini seçin** bölməsində birini seçin, sonra **Davam edin** seçin. Klient yalnız həmin iş sahəsində işləyir. 3. **Girişə icazə verin** bölməsində tətbiqin adını yoxlayın, sonra **Girişə icazə verin** seçin. Tətbiqi tanımırsınızsa, **Rədd edin** seçin. Klient qoşulu qalır, buna görə hər dəfə hesabınıza daxil olmaq lazım deyil. ## Klient nə edə bilər Klient Dvina-nın alətlərini görür və sorğunuz tələb etdikdə onlardan istifadə edir: | Sahə | Klientin edə bildikləri | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Axtarış** | Söhbətlərinizdə, sənədlərinizdə, yaddaşınızda və dünyanızda eyni anda axtarış etmək. | | **Yaddaş** | Yaddaş fayllarınızı siyahıya almaq və oxumaq, yenisini əlavə etmək və ya mövcud faylı dəyişmək. | | **Dünya** | Mövzularınızı siyahıya almaq, Dvina-nın bir mövzu və ya başqa hər hansı bir şey haqqında bildiklərini göstərmək və Lentinizi siyahıya almaq. | | **Sənədlər** | Kitabxananızı siyahıya almaq, oxumaq və orada axtarış etmək, qeydlər və qovluqlar yaratmaq, fayllar yükləmək, sənədi əvəz etmək, köçürmək, adını dəyişmək və ya zibil qutusuna atmaq. | | **Kanvas** | Kanvaslarınızı siyahıya almaq və oxumaq, kanvas yaratmaq və ya səhifəni yenidən yazmaq. | | **Tapşırıqlar və məqsədlər** | Tapşırıqlarınızı siyahıya almaq və nə etdiklərini oxumaq, tapşırıq və ya bir məqsədə yönəlmiş tapşırıq başlatmaq, tapşırığa əlavə iş vermək və ya onu dayandırmaq. | | **Planlaşdırılmış mesajlar** | Onları siyahıya almaq, birdəfəlik və ya təkrarlanan mesaj və ya xatırlatma planlaşdırmaq, yaxud ləğv etmək. | | **Agentlər və bacarıqlar** | Agentlərinizi və bacarıqlarınızı siyahıya almaq və oxumaq, agent yaratmaq, bacarıq əlavə etmək və ya hər birini dəyişmək. | | **Layihələr** | Layihələrinizi siyahıya almaq, layihənin qovluğunu və son tapşırıqlarını göstərmək. | | **Paylaşım** | Bir elementə kimin girişinin olduğunu və başqalarının sizinlə nə paylaşdığını görmək, yaxud kiməsə giriş vermək və ya girişini ləğv etmək. | | **Parametrlər** | Seçimlərinizi göstərmək və ya yaddaşı aktivləşdirmək və ya söndürmək. | Klient heç nəyi həmişəlik silə, ictimai keçidləri aça, tətbiqləri qoşa və ya ayıra, administrator və ya ödəniş parametrlərini dəyişə bilməz. ## Dəyişiklikləri təsdiqləyin Klientin etdiklərinə Dvina-nın hər yerindəki eyni qaydalar tətbiq olunur: - Oxuma əməliyyatları sizdən soruşmadan yerinə yetirilir. - Qeyd, yaddaş faylı və ya tapşırıq kimi yeni bir şeyin əlavə edilməsi sizdən soruşmadan yerinə yetirilir. Bu, mövcud olan heç nəyi dəyişmir. - Sənədi zibil qutusuna atmaq, kanvas səhifəsini yenidən yazmaq, tapşırığı dayandırmaq və ya elementi paylaşmaq kimi dəyişdirmə və ya silmə əməliyyatları üçün əvvəlcə sizdən icazə istənilir. Klient Dvina-nın dəyişiklik haqqında hazırladığı xülasəni göstərir və siz onu təsdiqləyir və ya rədd edirsiniz. Rədd etdikdə heç nə dəyişmir. > [!NOTE] > Klient sizdən təsdiq istəyə bilmirsə, Dvina həmin klient vasitəsilə dəyişikliyi etmir. Dəyişikliyi Dvina tətbiqində edin və ya təsdiq istəyə bilən klientdən istifadə edin. ## Giriş hüquqlarınız və şirkətinizin qaydaları Klient sizin adınızdan işləyir və yalnız Dvina-da görə və edə bildiklərinizə giriş əldə edir: - O, yalnız iş məkanının üzvü olduğunuz müddətdə və rolunuzun icazə verdiyi çərçivədə işləyir. - Administratorunuz fayl yükləmə kimi bir funksiyanı söndürərsə, klient də ondan istifadə edə bilməz. - Klientin əlavə etdiyi və ya dəyişdirdiyi hər şeyə tətbiqdə olduğu kimi şirkətinizin məlumatların qorunması qaydaları tətbiq olunur. - Əlavə etdiyi və ya dəyişdirdiyi hər şey [audit jurnalınızda](/docs/teams/audit-log) assistentin sizin adınızdan etdiyi əməliyyat kimi, hansı klientdən gəldiyi göstərilməklə qeydə alınır. - Etdiyi əməliyyatlar adi limitləriniz daxilində istifadənizə hesablanır. ## OAuth əvəzinə API açarı ilə qoşulun Enterprise planında klient daxil olmaq əvəzinə şəxsi giriş tokeni ilə qoşula bilər. OAuth ilə daxil ola bilməyən klient və ya skript üçün bu üsuldan istifadə edin. 1. Parametrləri açın və **API girişi** seçin. 2. **Şəxsi giriş tokenləri** bölməsində **Token yarat** seçin. 3. **Ad** daxil edin, **Giriş** səviyyəsini və **Bitmə vaxtı** seçin, sonra **Token yarat** seçin. 4. **Tokeninizi kopyalayın** bölməsində tokeni kopyalayın. Token yalnız bu dəfə göstərilir. Klientə lazım olan giriş səviyyəsini seçin: - **Yalnız oxuma:** klient yalnız oxuma alətlərini görür. Dvina-dakı məlumatlarınızda axtarış edə və onları oxuya bilər, lakin heç nə əlavə edə və ya dəyişə bilməz. - **Oxuma və yazma:** klient bütün alətləri görür və OAuth ilə olduğu kimi dəyişikliklər üçün yenə də təsdiqiniz tələb olunur. Tokeni `Authorization` başlığında `Bearer` sözündən sonra göndərin. Məsələn, Claude Code-da: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer " ``` Başqa klientdə eyni başlığı MCP serveri üçün başlıqlar təyin etməyə imkan verən yerə əlavə edin. Token onu yaratdığınız iş məkanında, oradakı cari rolunuzla sizin adınızdan işləyir. Onu əvəz etmək üçün **Şəxsi giriş tokenləri** bölməsində açın və **Yenilə…** seçin: yeni token onu əvəz edir və köhnəsi dərhal işləməyi dayandırır. Onu dayandırmaq üçün **Ləğv et…** seçin: ondan istifadə edən hər şey dərhal işləməyi dayandırır. Tokenlər haqqında ətraflı məlumat üçün [API girişi](/docs/dvina-mcp/api-access) səhifəsinə baxın. ## Əlaqəli mövzular - [Fərdi tətbiqlər və MCP serverləri](/docs/connectors/custom-apps) - [API girişi](/docs/dvina-mcp/api-access) - [dvina əmrindən istifadə edin](/docs/dvina-mcp/cli) - [Komandalara ümumi baxış](/docs/teams/overview)