All Products
Search

This Product

    Platform For AI:Hubungkan instans DSW ke agen melalui MCP

    Document Center

    Platform For AI:Hubungkan instans DSW ke agen melalui MCP

    Last Updated:Aug 01, 2026

    Aktifkan layanan MCP pada instans DSW untuk menghubungkannya ke klien agen. Setelah terhubung, agen dapat menjalankan perintah, membaca dan menulis file, serta mengeksekusi kode secara langsung pada instans tersebut, sehingga mengotomatiskan tugas-tugas pengembangan cloud yang rutin.

    Prasyarat

    Instans DSW atau kuota sumber daya dengan VPC dan grup keamanan yang telah dikonfigurasi.

    Kasus penggunaan

    Dengan instans DSW yang terhubung, agen memiliki akses ke mesin pengembangan cloud persisten, membebaskan Anda dari pekerjaan pengaturan manual. Agen dapat membaca dan menulis kode, menjalankan perintah, serta menjalankan eksperimen secara langsung pada instans tersebut. Kasus penggunaan umum meliputi:

    • Pengembangan dan debugging kode jarak jauh: Agen membuat dan memodifikasi kode pada instans, secara otomatis menemukan serta memperbaiki error, lalu menjalankannya kembali — menyelesaikan seluruh siklus pengembangan suatu fitur.

    • Pengaturan lingkungan dan manajemen dependensi: Agen menginstal dependensi Python atau sistem yang belum tersedia, memeriksa versi CUDA dan framework, serta memverifikasi lingkungan runtime — tanpa perlu mengetik perintah satu per satu.

    • Manajemen pekerjaan pelatihan dan eksperimen: Agen menjalankan skrip pelatihan, menunggu secara asinkron, memantau log dan output, lalu merangkum hasil setelah pelatihan selesai.

    • Pemrosesan data dan persiapan dokumen: Agen mengambil dan membersihkan file data secara batch, atau mengonversi halaman web, PDF, dan dokumen Office ke format Markdown untuk analisis lebih lanjut.

    Hubungkan ke agen

    Langkah 1: Buat instans DSW dan aktifkan layanan MCP

    Untuk mengaktifkan layanan MCP, lengkapi langkah-langkah berikut: nyalakan sakelar layanan, hasilkan kredensial akses, dan buka port pada grup keamanan. Setelah langkah-langkah ini selesai, agen dapat mengakses instans melalui protokol MCP.

    1. Aktifkan sakelar layanan MCP. Sebagai contoh, gunakan instans sumber daya publik dan konfigurasikan parameter utama berikut saat membuat instans DSW. Konfigurasikan parameter lain sesuai kebutuhan.

      Untuk instans yang sudah ada, klik Change configuration di kolom Actions pada halaman daftar instans untuk mengonfigurasi ulang instans DSW.

      • Resource Type: Pilih Public resource.

      • VPC Settings: Pilih VPC di wilayah yang sama. VPC diperlukan untuk mengaktifkan layanan MCP.

      • Security Group: Pilih grup keamanan.

      • VSwitch: Pilih vSwitch.

      • Enable MCP Service: Nyalakan sakelar. Secara default, layanan MCP akan mendengarkan pada port 9806 instans.

      Untuk mengakses instans DSW dari internet publik (misalnya, dari klien Agent lokal), konfigurasikan juga parameter berikut:

      • Service Access and Port Configuration:

        • Access over Internet: Pilih opsi ini.

        • Internet Access Port: Misalnya, 1078.

      • Public Network Access: Pilih DNAT + EIP.

        • NAT Gateway: Pilih Gateway NAT.

        • EIP: Pilih EIP yang terkait dengan Gateway NAT.

      Setelah mengonfigurasi parameter, klik OK untuk membuat instans.

    2. Hasilkan kredensial akses. Setelah instans DSW dibuat, klik nama instans untuk menuju halaman detail. Di bagian Access Configuration, klik Generate credentials. Kredensial ini digunakan untuk mengautentikasi agen saat memanggil layanan MCP dan disertakan dalam header permintaan sebagai bearer token.

      Sekarang Anda memiliki access endpoint dan kredensial akses MCP.

      Catatan

      Kredensial berlaku selama 7 hari secara default. Setelah kedaluwarsa, hasilkan ulang di lokasi yang sama dan perbarui kredensial tersebut dalam konfigurasi agen.

    Langkah 2: Tambahkan aturan grup keamanan masuk

    Di halaman detail DSW, klik nama grup keamanan pada bagian Network Information untuk menuju halaman detail grup keamanan. Di tab Inbound, klik Add rule dan konfigurasikan parameter berikut. Biarkan parameter lain pada nilai default-nya.

    • Source: Masukkan alamat IP tempat Agen dideploy (misalnya, IP publik mesin lokal yang menjalankan Agen).

    • Destination (this instance): Masukkan port 9806.

    Langkah 3: Hubungkan agen ke instans DSW

    Layanan MCP DSW menggunakan protokol Streamable HTTP standar yang kompatibel dengan klien agen umum. Buka klien agen (seperti Open Code atau Qoder CLI) dan kirim prompt berikut. Ganti <MCP access endpoint> dan <access credentials> dengan nilai aktualnya. Agen akan menyelesaikan koneksi MCP secara otomatis.

    Jika menghubungkan dari klien agen lokal ke instans DSW, gunakan endpoint akses internet publik sebagai endpoint MCP.
    Tambahkan server MCP bernama dsw-mcp dengan protokol Streamable HTTP, endpoint http://<MCP access endpoint>, dan header permintaan Authorization: Bearer <access credentials>. Selesaikan pengaturan secara otomatis menggunakan metode konfigurasi MCP Anda.

    Setelah koneksi terbentuk, jalankan perintah berikut di klien agen untuk memverifikasi konektivitas.

    Buat file Python hello_world di direktori /mnt/workspace pada instans DSW.

    Setelah perintah dijalankan, buka instans DSW dan periksa apakah file hello_world.py muncul di ruang kerja.

    Tool yang didukung

    Layanan MCP DSW menyediakan serangkaian tool melalui protokol Streamable HTTP standar. Saat agen terhubung, daftar tool akan dimuat secara otomatis. Tool tersebut dikelompokkan ke dalam lima kategori — shell, file, system, konversi format, dan code — dengan total 16 tool.

    Shell (5 alat)

    Jalankan perintah pada instans. Perintah berurutan berbagi direktori kerja yang sama, sehingga kategori ini cocok untuk menjalankan skrip, menginstal dependensi, dan memulai pekerjaan pelatihan.

    Tool

    Function

    Key parameters

    shell_exec

    Jalankan perintah shell

    cmd (wajib), cwd, new_session, timeout

    shell_view

    Lihat output dan status akumulasi sesi

    session_id, limit

    shell_wait

    Tunggu hingga perintah asinkron selesai

    session_id, seconds

    shell_write

    Kirim input ke proses yang sedang berjalan

    session_id, input, press_enter

    shell_kill

    Hentikan dan bersihkan sesi

    session_id

    File (7 tool)

    Baca, tulis, cari, dan edit file pada instans.

    Tool

    Function

    Key parameters

    file_read

    Baca konten file (dengan rentang baris opsional)

    path (wajib), start_line, end_line, sudo

    file_write

    Tulis atau tambahkan ke file, dengan dukungan biner base64

    path, content, encoding, append

    file_str_replace

    Ganti string secara global dalam file

    path, old_str, new_str

    file_search

    Cari konten file dengan regex

    path, regex

    file_find

    Cari file berdasarkan pola glob

    path, pattern

    file_list

    Daftar isi direktori, dengan filter rekursif dan jenis file

    path, recursive, file_types

    file_edit

    Editor dengan dukungan undo

    command (view/create/str_replace/insert/undo_edit), path, dan lainnya

    System (2 tool)

    Periksa lingkungan instans dan paket yang terinstal.

    Tool

    Function

    Key parameters

    system_info

    Periksa lingkungan instans (OS, Python, Node.js, tool yang tersedia)

    Tidak ada

    system_packages

    Daftar paket Python atau Node.js yang terinstal

    language

    Konversi format (1 tool)

    Tool

    Function

    Key parameters

    util_to_markdown

    Konversi halaman web, PDF, dokumen Office, dan gambar ke Markdown

    uri

    Code (1 tool)

    Tool

    Function

    Key parameters

    code_run

    Jalankan kode (Python didukung)

    code, language, timeout

    Semua tool tersedia segera setelah layanan MCP diaktifkan — tidak diperlukan konfigurasi tambahan.