# 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: ```text 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 ::: tabs === Claude Code 1. Dalam terminal anda, jalankan: ```sh 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. > [!NOTE] > 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](/docs/teams/audit-log) 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: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer " ``` 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](/docs/dvina-mcp/api-access). ## Berkaitan - [Aplikasi tersuai dan pelayan MCP](/docs/connectors/custom-apps) - [Akses API](/docs/dvina-mcp/api-access) - [Gunakan arahan dvina](/docs/dvina-mcp/cli) - [Gambaran keseluruhan pasukan](/docs/teams/overview)