Dvina MCP

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.

Markdown formatında bax

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:

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

Claude Code

  1. Terminalda bu əmri icra edin:

    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.

Qeyd

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 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:

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

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 səhifəsinə baxın.