Dvina MCP

Gunakan Dvina dari aplikasi lain dengan MCP

Hubungkan klien MCP seperti Claude Code, ChatGPT, atau Cursor ke Dvina, masuk, lalu izinkan klien membaca dan menambahkan konten ke Dvina Anda dengan persetujuan Anda.

Dvina memiliki server MCP sendiri. Hubungkan klien MCP, seperti Claude Code, ChatGPT, atau Cursor, agar aplikasi tersebut dapat menelusuri Dvina Anda, membaca dokumen dan memori Anda, serta menambahkan catatan, tugas, dan pengingat atas nama Anda.

Sebelum memulai

Anda memerlukan alamat server:

https://api.dvina.ai/mcp

Jika perusahaan Anda menjalankan Dvina di server sendiri, gunakan alamat API Dvina perusahaan Anda dengan /mcp di bagian akhir. Minta alamatnya kepada admin Anda.

Server menggunakan Streamable HTTP. Jika klien meminta Anda memilih transport, pilih HTTP.

Hubungkan klien

Claude Code

  1. Di terminal Anda, jalankan:

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

  2. Jalankan Claude Code, jalankan /mcp, pilih dvina, lalu masuk ke Dvina.

ChatGPT

  1. Buka bagian ChatGPT tempat Anda dapat menambahkan server MCP.
  2. Masukkan https://api.dvina.ai/mcp sebagai alamat server, lalu pilih OAuth jika diminta memilih cara masuk.
  3. Masuk ke Dvina saat ChatGPT memintanya.

Cursor

  1. Buka bagian Cursor tempat Anda dapat menambahkan server MCP.
  2. Tambahkan server bernama dvina dengan alamat https://api.dvina.ai/mcp.
  3. Masuk ke Dvina saat Cursor memintanya.

Anda tidak memerlukan ID klien atau secret. Klien mendaftarkan dirinya ke Dvina saat pertama kali terhubung.

Masuk

Server MCP Dvina menggunakan OAuth untuk proses masuk melalui browser Anda:

  1. Masuk ke Dvina seperti biasa.
  2. Jika Anda tergabung dalam lebih dari satu ruang kerja, pilih salah satunya di bagian Pilih ruang kerja, lalu pilih Lanjutkan. Klien hanya bekerja di ruang kerja tersebut.
  3. Di bagian Izinkan akses, periksa nama aplikasi, lalu pilih Izinkan akses. Pilih Tolak jika Anda tidak mengenalinya.

Klien tetap terhubung, jadi Anda tidak perlu masuk setiap kali menggunakannya.

Yang dapat dilakukan klien

Klien dapat melihat alat-alat Dvina dan menggunakannya saat diperlukan untuk memenuhi permintaan Anda:

Area Yang dapat dilakukan klien
Pencarian Mencari di percakapan, dokumen, memori, dan dunia Anda sekaligus.
Memori Menampilkan daftar dan membaca file memori Anda, menambahkan file baru, atau mengubah file yang ada.
Dunia Menampilkan daftar topik Anda, menunjukkan apa yang diketahui Dvina tentang suatu topik atau hal lainnya, dan menampilkan daftar Feed Anda.
Dokumen Menampilkan daftar, membaca, dan mencari di Pustaka Anda, membuat catatan dan folder, mengunggah file, serta mengganti, memindahkan, mengganti nama dokumen, atau memindahkannya ke sampah.
Kanvas Menampilkan daftar dan membaca kanvas Anda, membuat kanvas, atau menulis ulang halaman.
Tugas dan tujuan Menampilkan daftar tugas Anda dan membaca apa yang telah dikerjakannya, memulai tugas atau tugas yang membantu mencapai tujuan, memberi tugas pekerjaan tambahan, atau menghentikannya.
Pesan terjadwal Menampilkan daftarnya, menjadwalkan pesan atau pengingat satu kali atau berulang, atau membatalkannya.
Agen dan keterampilan Menampilkan daftar dan membaca agen serta keterampilan Anda, membuat agen, menambahkan keterampilan, atau mengubah keduanya.
Proyek Menampilkan daftar proyek Anda serta folder dan tugas terbaru dalam suatu proyek.
Berbagi Melihat siapa yang memiliki akses ke suatu item dan apa yang dibagikan orang lain kepada Anda, atau memberikan maupun mencabut akses seseorang.
Pengaturan Menampilkan preferensi Anda, atau mengaktifkan maupun menonaktifkan memori.

Klien tidak dapat menghapus apa pun secara permanen, membuka tautan publik, menghubungkan atau memutuskan koneksi aplikasi, maupun mengubah pengaturan admin atau penagihan.

Setujui perubahan

Tindakan klien mengikuti aturan yang sama seperti di seluruh Dvina:

  • Membaca dilakukan tanpa meminta persetujuan.
  • Menambahkan sesuatu yang baru, seperti catatan, file memori, atau tugas, dilakukan tanpa meminta persetujuan. Tindakan ini tidak pernah mengubah apa yang sudah ada.
  • Mengubah atau menghapus sesuatu, seperti memindahkan dokumen ke sampah, menulis ulang halaman kanvas, menghentikan tugas, atau membagikan item, memerlukan persetujuan Anda terlebih dahulu. Klien menampilkan ringkasan perubahan dari Dvina, lalu Anda menyetujui atau menolaknya. Jika Anda menolak, tidak ada yang berubah.

Catatan

Jika klien tidak dapat meminta konfirmasi Anda, Dvina tidak akan melakukan perubahan melalui klien tersebut. Lakukan perubahan di aplikasi Dvina, atau gunakan klien yang dapat meminta konfirmasi.

Akses Anda dan aturan perusahaan Anda

Klien bertindak sebagai Anda, dengan akses yang sama untuk melihat dan melakukan tindakan di Dvina:

  • Klien hanya berfungsi selama Anda masih menjadi anggota ruang kerja, dan hanya sesuai izin peran Anda.
  • Jika admin Anda menonaktifkan fitur, seperti unggahan file, klien juga tidak dapat menggunakannya.
  • Apa pun yang ditambahkan atau diubah klien mengikuti aturan perlindungan data perusahaan Anda, sama seperti di aplikasi.
  • Apa pun yang ditambahkan atau diubah dicatat di log audit Anda sebagai tindakan asisten atas nama Anda, beserta klien asalnya.
  • Tindakan klien dihitung sebagai penggunaan Anda, dengan batas yang biasa berlaku.

Hubungkan dengan kunci API sebagai pengganti OAuth

Pada paket Enterprise, klien dapat terhubung dengan token akses pribadi tanpa perlu masuk. Gunakan cara ini untuk klien yang tidak dapat masuk dengan OAuth, atau untuk skrip.

  1. Buka Pengaturan dan pilih Akses API.
  2. Di bagian Token Akses Pribadi, pilih Buat Token.
  3. Masukkan Nama, pilih Akses dan waktu Kedaluwarsa, lalu pilih Buat Token.
  4. Di bagian Salin Token Anda, salin token tersebut. Token hanya ditampilkan kali ini.

Pilih akses yang diperlukan klien:

  • Hanya baca: klien hanya melihat alat untuk membaca. Klien dapat mencari dan membaca isi Dvina Anda, tetapi tidak dapat menambahkan atau mengubah apa pun.
  • Baca dan tulis: klien melihat semua alat, dan perubahan tetap memerlukan persetujuan Anda, sama seperti dengan OAuth.

Kirim token di header Authorization, setelah Bearer. Misalnya, di Claude Code:

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

Di klien lain, tambahkan header yang sama di bagian yang memungkinkan Anda mengatur header untuk server MCP.

Token bertindak sebagai Anda, di ruang kerja tempat Anda membuatnya, dengan peran Anda saat ini di sana. Untuk menggantinya, buka token di bagian Token Akses Pribadi dan pilih Rotasi…: token baru menggantikannya, dan token lama langsung berhenti berfungsi. Untuk menonaktifkannya, pilih Cabut…: apa pun yang menggunakan token tersebut langsung berhenti berfungsi.

Untuk informasi lebih lanjut tentang token, lihat Akses API.