Dvina MCP

Gunakan Dvina daripada aplikasi lain dengan MCP

Sambungkan klien MCP seperti Claude Code, ChatGPT atau Cursor ke Dvina, daftar masuk dan benarkan klien itu membaca serta menambah kandungan dalam Dvina anda dengan kelulusan anda.

Dvina mempunyai pelayan MCP sendiri. Sambungkan klien MCP, seperti Claude Code, ChatGPT atau Cursor, dan aplikasi itu boleh mencari dalam Dvina anda, membaca dokumen dan memori anda, serta menambah nota, tugasan dan peringatan bagi pihak anda.

Sebelum anda bermula

Anda memerlukan alamat pelayan:

https://api.dvina.ai/mcp

Jika syarikat anda menjalankan Dvina pada pelayannya sendiri, gunakan alamat API Dvina syarikat anda dengan /mcp di hujungnya. Minta alamat itu daripada pentadbir anda.

Pelayan menggunakan Streamable HTTP. Jika klien meminta anda memilih protokol pengangkutan, pilih HTTP.

Sambungkan klien

Claude Code

  1. Dalam terminal anda, jalankan:

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

  2. Mulakan Claude Code, jalankan /mcp, pilih dvina dan daftar masuk ke Dvina.

ChatGPT

  1. Buka bahagian dalam ChatGPT yang membolehkan anda menambah pelayan MCP.
  2. Masukkan https://api.dvina.ai/mcp sebagai alamat pelayan dan pilih OAuth jika diminta memilih cara untuk daftar masuk.
  3. Daftar masuk ke Dvina apabila diminta oleh ChatGPT.

Cursor

  1. Buka bahagian dalam Cursor yang membolehkan anda menambah pelayan MCP.
  2. Tambah pelayan bernama dvina dengan alamat https://api.dvina.ai/mcp.
  3. Daftar masuk ke Dvina apabila diminta oleh Cursor.

Anda tidak memerlukan ID klien atau rahsia klien. Klien mendaftarkan dirinya dengan Dvina kali pertama ia bersambung.

Daftar masuk

Pelayan MCP Dvina menggunakan OAuth untuk mendaftar masuk anda melalui pelayar:

  1. Daftar masuk ke Dvina seperti biasa.
  2. Jika anda tergolong dalam lebih daripada satu ruang kerja, pilih satu di bawah Pilih ruang kerja, kemudian pilih Teruskan. Klien hanya berfungsi dalam ruang kerja itu.
  3. Di bawah Benarkan akses, semak nama aplikasi, kemudian pilih Benarkan akses. Pilih Tolak jika anda tidak mengenalinya.

Klien kekal bersambung, jadi anda tidak perlu daftar masuk setiap kali.

Perkara yang boleh dilakukan oleh klien

Klien dapat melihat alat Dvina dan menggunakannya apabila diperlukan untuk memenuhi permintaan anda:

Bahagian Perkara yang boleh dilakukan oleh klien
Carian Cari sembang, dokumen, memori dan dunia anda serentak.
Memori Senaraikan dan baca fail memori anda, tambah fail baharu atau ubah fail sedia ada.
Dunia Senaraikan topik anda, tunjukkan perkara yang Dvina tahu tentang sesuatu topik atau apa-apa sahaja, dan senaraikan Suapan anda.
Dokumen Senaraikan, baca dan cari dalam Pustaka anda, cipta nota dan folder, muat naik fail, serta ganti, pindahkan atau namakan semula dokumen, atau pindahkannya ke tong sampah.
Kanvas Senaraikan dan baca kanvas anda, cipta kanvas atau tulis semula halaman.
Tugas dan matlamat Senaraikan tugas anda dan baca perkara yang telah dilakukannya, mulakan tugas atau tugas untuk mencapai matlamat, beri tugas lebih banyak kerja atau hentikannya.
Mesej berjadual Senaraikan mesej berjadual, jadualkan mesej atau peringatan sekali sahaja atau berulang, atau batalkannya.
Ejen dan kemahiran Senaraikan dan baca ejen dan kemahiran anda, cipta ejen, tambah kemahiran atau ubah salah satu daripadanya.
Projek Senaraikan projek anda dan tunjukkan folder serta tugas terkini sesuatu projek.
Perkongsian Lihat siapa yang mempunyai akses kepada sesuatu item dan perkara yang dikongsi oleh orang lain dengan anda, atau beri atau tarik balik akses seseorang.
Tetapan Tunjukkan keutamaan anda, atau hidupkan atau matikan memori.

Klien tidak boleh memadamkan apa-apa secara kekal, membuka pautan awam, menyambungkan atau memutuskan sambungan aplikasi, atau mengubah tetapan pentadbir atau pengebilan.

Luluskan perubahan

Tindakan klien mengikut peraturan yang sama seperti di seluruh Dvina:

  • Pembacaan dijalankan tanpa meminta kebenaran.
  • Penambahan sesuatu yang baharu, seperti nota, fail memori atau tugas, dijalankan tanpa meminta kebenaran. Ia tidak pernah mengubah perkara yang sudah ada.
  • Perubahan atau pengalihan sesuatu, seperti memindahkan dokumen ke tong sampah, menulis semula halaman kanvas, menghentikan tugas atau berkongsi item, memerlukan kebenaran anda terlebih dahulu. Klien menunjukkan ringkasan perubahan yang disediakan oleh Dvina sendiri, dan anda meluluskannya atau menolaknya. Apabila anda menolak, tiada apa-apa yang berubah.

Nota

Jika klien tidak boleh meminta pengesahan anda, Dvina tidak akan membuat perubahan melalui klien itu. Sebaliknya, buat perubahan dalam aplikasi Dvina atau gunakan klien yang boleh meminta pengesahan.

Akses anda dan peraturan syarikat anda

Klien bertindak bagi pihak anda, dengan akses kepada perkara yang anda boleh lihat dan lakukan dalam Dvina:

  • Klien hanya berfungsi selagi anda masih menjadi ahli ruang kerja, dan hanya dalam skop yang dibenarkan oleh peranan anda.
  • Jika pentadbir anda mematikan sesuatu ciri, seperti muat naik fail, klien juga tidak boleh menggunakannya.
  • Perkara yang ditambah atau diubah oleh klien tertakluk pada peraturan perlindungan data syarikat anda, sama seperti dalam aplikasi.
  • Perkara yang ditambah atau diubah direkodkan dalam log audit anda sebagai tindakan pembantu bagi pihak anda, berserta klien yang digunakan.
  • Tindakan klien dikira dalam penggunaan anda, dalam had biasa anda.

Sambungkan dengan kunci API dan bukannya OAuth

Dalam pelan Enterprise, klien boleh menyambung dengan token akses peribadi dan bukannya log masuk. Gunakan kaedah ini untuk klien yang tidak boleh log masuk dengan OAuth, atau untuk skrip.

  1. Buka Tetapan dan pilih Akses API.
  2. Di bawah Token Akses Peribadi, pilih Cipta Token.
  3. Masukkan Nama, pilih Akses dan masa Tamat Tempoh, kemudian pilih Cipta Token.
  4. Di bawah Salin Token Anda, salin token tersebut. Token hanya ditunjukkan pada masa ini.

Pilih akses yang diperlukan oleh klien:

  • Baca sahaja: klien hanya melihat alat yang digunakan untuk membaca. Klien boleh mencari dan membaca kandungan Dvina anda, tetapi tidak boleh menambah atau mengubah apa-apa.
  • Baca dan tulis: klien melihat semua alat, dan perubahan masih memerlukan kelulusan anda, sama seperti dengan OAuth.

Hantar token dalam pengepala Authorization, selepas Bearer. Contohnya, dalam Claude Code:

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

Dalam klien lain, tambah pengepala yang sama di bahagian yang membolehkan anda menetapkan pengepala untuk pelayan MCP.

Token bertindak bagi pihak anda dalam ruang kerja tempat anda menciptanya, mengikut peranan semasa anda di situ. Untuk menggantikannya, buka token di bawah Token Akses Peribadi dan pilih Ganti…: token baharu menggantikannya, dan token lama terus berhenti berfungsi. Untuk menghentikannya, pilih Tarik Balik…: apa-apa yang menggunakan token itu terus berhenti berfungsi.

Untuk maklumat lanjut tentang token, lihat Akses API.