Dvina MCP

Dvina'yı MCP ile diğer uygulamalardan kullanın

Claude Code, ChatGPT veya Cursor gibi bir MCP istemcisini Dvina'ya bağlayın, oturum açın ve onayınızla Dvina'nızdaki içerikleri okumasına ve yeni içerikler eklemesine izin verin.

Markdown olarak gör

Dvina'nın kendi MCP sunucusu vardır. Claude Code, ChatGPT veya Cursor gibi bir MCP istemcisini bağladığınızda bu uygulama sizin adınıza Dvina'nızda arama yapabilir, belgelerinizi ve belleğinizi okuyabilir, notlar, görevler ve hatırlatıcılar ekleyebilir.

Başlamadan önce

Sunucunun adresine ihtiyacınız var:

https://api.dvina.ai/mcp

Şirketiniz Dvina'yı kendi sunucularında çalıştırıyorsa şirketinizin Dvina API adresini, sonuna /mcp ekleyerek kullanın. Bu adresi yöneticinizden isteyin.

Sunucu, Streamable HTTP kullanır. İstemci bir aktarım yöntemi sorarsa HTTP'yi seçin.

Bir istemci bağlayın

Claude Code

  1. Terminalinizde şu komutu çalıştırın:

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

  2. Claude Code'u başlatın, /mcp komutunu çalıştırın, dvina seçeneğini seçin ve Dvina'da oturum açın.

ChatGPT

  1. ChatGPT'de MCP sunucusu ekleyebileceğiniz bölümü açın.
  2. Sunucu adresi olarak https://api.dvina.ai/mcp girin. Oturum açma yöntemi sorulursa OAuth'u seçin.
  3. ChatGPT istediğinde Dvina'da oturum açın.

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.

İstemci kimliğine veya istemci sırrına ihtiyacınız yoktur. İstemci, ilk bağlantıda kendisini Dvina'ya kaydeder.

Oturum açın

Dvina'nın MCP sunucusu, tarayıcınızda OAuth ile oturum açmanızı sağlar:

  1. Dvina'da her zamanki gibi oturum açın.
  2. Birden fazla çalışma alanına üyeyseniz Çalışma alanı seçin bölümünden birini seçin, ardından Devam seçeneğini seçin. İstemci yalnızca bu çalışma alanında çalışır.
  3. Erişime izin verin bölümünde uygulamanın adını kontrol edin, ardından Erişime izin ver seçeneğini seçin. Uygulamayı tanımıyorsanız Reddet seçeneğini seçin.

İstemci bağlı kalır, böylece her seferinde oturum açmanız gerekmez.

İstemci neler yapabilir?

İstemci, Dvina'nın araçlarını görür ve isteğiniz gerektirdiğinde bunları kullanır:

Alan İstemcinin yapabilecekleri
Arama Sohbetlerinizde, belgelerinizde, belleğinizde ve dünyanızda aynı anda arama yapar.
Bellek Bellek dosyalarınızı listeler ve okur, yeni bir dosya ekler veya mevcut bir dosyayı değiştirir.
Dünya Konularınızı listeler, Dvina'nın bir konu veya başka herhangi bir şey hakkında bildiklerini gösterir ve Akışınızı listeler.
Belgeler Kitaplığınızı listeler, okur ve kitaplığınızda arama yapar; notlar ve klasörler oluşturur, dosya yükler; bir belgeyi değiştirir, taşır, yeniden adlandırır veya çöp kutusuna taşır.
Tuval Tuvallerinizi listeler ve okur, tuval oluşturur veya bir sayfayı yeniden yazar.
Görevler ve hedefler Görevlerinizi listeler ve yaptıklarını okur, bir görev veya bir hedefe yönelik çalışan bir görev başlatır, bir göreve ek iş gönderir veya görevi durdurur.
Zamanlanmış mesajlar Mesajları listeler, tek seferlik veya tekrarlayan bir mesaj ya da hatırlatıcı zamanlar veya iptal eder.
Ajanlar ve beceriler Ajanlarınızı ve becerilerinizi listeler ve okur, ajan oluşturur, beceri ekler veya bunlardan birini değiştirir.
Projeler Projelerinizi listeler, bir projenin klasörünü ve son görevlerini gösterir.
Paylaşım Bir öğeye kimlerin erişebildiğini ve başkalarının sizinle neler paylaştığını gösterir, birine erişim verir veya erişimini kaldırır.
Ayarlar Tercihlerinizi gösterir veya belleği açar ya da kapatır.

İstemci hiçbir şeyi kalıcı olarak silemez, herkese açık bağlantıları açamaz, uygulamaları bağlayamaz veya bağlantılarını kesemez, yönetici ya da faturalandırma ayarlarını değiştiremez.

Değişiklikleri onaylayın

İstemcinin yaptığı işlemler, Dvina'nın her yerinde geçerli olan kurallara uyar:

  • Okuma işlemleri size sorulmadan yapılır.
  • Not, bellek dosyası veya görev gibi yeni bir şey ekleme işlemleri size sorulmadan yapılır. Bu işlemler mevcut içerikleri hiçbir zaman değiştirmez.
  • Bir belgeyi çöp kutusuna taşıma, bir tuval sayfasını yeniden yazma, bir görevi durdurma veya bir öğeyi paylaşma gibi değiştirme ya da kaldırma işlemleri için önce size sorulur. İstemci, Dvina'nın değişiklik için hazırladığı özeti gösterir; siz de onaylar veya reddedersiniz. Reddederseniz hiçbir şey değişmez.

Not

Bir istemci sizden onay isteyemiyorsa Dvina o istemci üzerinden değişiklik yapmaz. Bunun yerine değişikliği Dvina uygulamasında yapın veya onay isteyebilen bir istemci kullanın.

Erişiminiz ve şirketinizin kuralları

İstemci sizin adınıza çalışır ve Dvina'da yalnızca sizin görebildiğiniz ve yapabildiğiniz şeylere erişebilir:

  • Yalnızca çalışma alanının üyesi olduğunuz sürece ve rolünüzün izin verdiği kapsamda çalışır.
  • Yöneticiniz dosya yükleme gibi bir özelliği kapatırsa istemci de bu özelliği kullanamaz.
  • İstemcinin eklediği veya değiştirdiği içerikler, uygulamada olduğu gibi şirketinizin veri koruma kurallarına tabi olur.
  • Eklediği veya değiştirdiği içerikler, hangi istemciden geldiği bilgisiyle birlikte, asistanın sizin adınıza yaptığı işlemler olarak denetim günlüğünüze kaydedilir.
  • Yaptığı işlemler, her zamanki sınırlarınız dahilinde kullanımınıza sayılır.

OAuth yerine API anahtarıyla bağlanın

Enterprise planında bir istemci, oturum açmak yerine kişisel erişim belirteciyle bağlanabilir. OAuth ile oturum açamayan bir istemci veya bir betik için bu yöntemi kullanın.

  1. Ayarlar'ı açın ve API Erişimi'ni seçin.
  2. Kişisel Erişim Belirteçleri altında Belirteç Oluştur'u seçin.
  3. Bir Ad girin, Erişim düzeyini ve Son Kullanma Tarihi'ni seçin, ardından Belirteç Oluştur'u seçin.
  4. Belirtecinizi Kopyalayın altında belirteci kopyalayın. Belirteç yalnızca bu aşamada gösterilir.

İstemcinin ihtiyaç duyduğu erişimi seçin:

  • Salt okunur: İstemci yalnızca okuma yapan araçları görür. Dvina'nızda arama yapabilir ve içerikleri okuyabilir, ancak hiçbir şey ekleyemez veya değiştiremez.
  • Okuma ve yazma: İstemci tüm araçları görür ve OAuth'ta olduğu gibi değişiklikler için yine onayınız istenir.

Belirteci Authorization üstbilgisinde, Bearer ifadesinden sonra gönderin. Örneğin Claude Code'da:

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

Başka bir istemcide, MCP sunucusu için üstbilgileri ayarlayabildiğiniz yere aynı üstbilgiyi ekleyin.

Belirteç, oluşturduğunuz çalışma alanında, oradaki mevcut rolünüzle sizin adınıza çalışır. Yenilemek için Kişisel Erişim Belirteçleri altında belirteci açın ve Yenile…'yi seçin: Yeni bir belirteç eskisinin yerini alır ve eski belirteç hemen çalışmayı durdurur. İptal etmek için İptal Et…'i seçin: Belirteci kullanan her şey hemen çalışmayı durdurur.

Belirteçler hakkında daha fazla bilgi için API erişimi sayfasına bakın.