# 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: ```text 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 ::: tabs === Claude Code 1. Di terminal Anda, jalankan: ```sh 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. > [!NOTE] > 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](/docs/teams/audit-log) 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: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer " ``` 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](/docs/dvina-mcp/api-access). ## Terkait - [Aplikasi kustom dan server MCP](/docs/connectors/custom-apps) - [Akses API](/docs/dvina-mcp/api-access) - [Gunakan perintah dvina](/docs/dvina-mcp/cli) - [Gambaran umum tim](/docs/teams/overview)