Menghubungkan instans DSW ke Agent melalui MCP

Setelah mengaktifkan layanan MCP pada instans DSW, Anda dapat menghubungkan instans tersebut ke klien Agent. Agent kemudian dapat menjalankan perintah, membaca dan menulis file, serta mengeksekusi kode secara langsung di dalam instans, sehingga memungkinkan Anda mendelegasikan tugas pengembangan berbasis cloud kepada AI.

Prasyarat

VPC dan security group telah dikonfigurasi untuk instans DSW atau kuota sumber daya tempat instans tersebut berada.

Kasus penggunaan

Menghubungkan instans DSW ke Agent menyediakan mesin pengembangan cloud siap pakai bagi Agent. Agent dapat membaca dan menulis kode, menjalankan perintah, serta menjalankan eksperimen secara langsung di dalam instans, sehingga membebaskan Anda dari operasi lingkungan yang berulang. Skenario umum meliputi:

Pengembangan dan debugging kode jarak jauh: Minta Agent membuat dan memodifikasi kode di dalam instans, menjalankannya, menemukan kesalahan, memperbaikinya, lalu menjalankannya kembali untuk menyelesaikan siklus pengembangan penuh.
Persiapan lingkungan dan manajemen dependensi: Minta Agent menginstal dependensi Python atau sistem yang belum tersedia, memeriksa versi CUDA dan framework, serta memverifikasi lingkungan runtime, sehingga Anda tidak perlu mengetik perintah satu per satu.
Hosting pelatihan dan eksperimen: Agent menjalankan skrip pelatihan dan menunggu secara asinkron, memantau log dan output, lalu merangkum hasil secara otomatis setelah pelatihan selesai.
Pemrosesan data dan pengorganisasian dokumentasi: Melakukan pencarian dan pembersihan file data secara batch di dalam instans, atau mengonversi halaman web, PDF, dan dokumen Office ke format Markdown untuk analisis selanjutnya.

Langkah 1: Buat instans DSW dan aktifkan layanan MCP

Aktifkan layanan MCP dalam tiga langkah: nyalakan sakelar layanan, hasilkan kredensial akses, dan buka port di security group. Setelah itu, Agent dapat mengakses instans melalui protokol MCP.

Aktifkan sakelar layanan MCP. Contoh berikut menunjukkan cara membuat instans menggunakan sumber daya publik. Konfigurasikan parameter utama seperti yang dijelaskan di bagian ini. Anda dapat mengonfigurasi parameter lain sesuai kebutuhan.

Untuk instans yang sudah ada, buka daftar instans, klik Change Configuration di kolom Actions, lalu konfigurasi ulang instans DSW.
- Resource Type: Pilih sumber daya publik.
- VPC Settings: Pilih VPC di wilayah yang sama. VPC diperlukan untuk mengaktifkan layanan MCP.
- Security Group: Pilih security group yang telah dibuat.
- VSwitch: Pilih vSwitch yang telah dibuat.
- Enable MCP Service: Nyalakan sakelar. Saat sakelar menyala, layanan bernama MCP akan muncul dan mendengarkan pada port 9806 instans secara default.
Jika Anda ingin mengakses instans DSW dari internet (misalnya, melalui klien Agent lokal), konfigurasikan parameter berikut:
- Service Access and Port Configuration:
  - Access over Internet: Centang kotak pilihan.
  - Internet Access Port: Misalnya, 1078.
- Public Network Access: Pilih DNAT + EIP
  - NAT Gateway: Pilih gateway NAT yang telah dibuat di wilayah yang sama.
  - EIP: Pilih EIP yang terkait dengan gateway NAT tersebut.
    
    Penting
    Penting: Untuk mengizinkan instans DSW mengakses internet, konfigurasikan entri SNAT untuk gateway NAT. Untuk informasi lebih lanjut, lihat Tingkatkan kecepatan akses publik melalui gateway khusus.
Setelah konfigurasi selesai, klik OK untuk membuat instans.
Hasilkan kredensial akses. Setelah instans DSW dibuat, klik nama instans untuk membuka halaman detail. Di bagian Access Configuration, klik Generate Access Credentials. Kredensial ini digunakan untuk mengotentikasi Agent saat memanggil layanan MCP. Masukkan kredensial sebagai Bearer Token dalam header permintaan.

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. Setelah menghasilkan ulang, perbarui kredensial tersebut di konfigurasi Agent.

Langkah 2: Buka port dan IP di security group

Di halaman detail DSW, pada bagian Network Information, klik nama security group untuk membuka halaman detail security group. Di tab Inbound, klik Add Rule. Konfigurasikan parameter berikut. Anda dapat menggunakan nilai default untuk parameter lainnya.

Source: Masukkan alamat IP lokasi penerapan Agent (misalnya, alamat IP publik komputer lokal yang menjalankan Agent).
Destination (this instance): Masukkan port 9806.

Langkah 3: Hubungkan Agent ke instans DSW

Layanan MCP DSW menggunakan protokol Streamable HTTP standar dan kompatibel dengan klien Agent utama. Buka klien Agent (seperti Open Code atau Qoder CLI) dan kirimkan prompt berikut ke Agent, ganti <MCP access endpoint> dan <access credentials> dengan nilai aktual. Agent akan secara otomatis menyelesaikan koneksi MCP.

Jika Anda menggunakan klien Agent lokal untuk menghubungkan ke instans DSW, gunakan access endpoint publik.

Tambahkan server MCP bernama dsw-mcp dengan protokol Streamable HTTP, titik akhir http://<MCP access endpoint>, dan header permintaan Authorization: Bearer <access credentials>. Selesaikan penyiapan secara otomatis menggunakan metode konfigurasi MCP Anda.

Setelah koneksi terbentuk, masukkan perintah berikut di klien Agent untuk menguji konektivitas.

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

Setelah perintah dijalankan, buka instans DSW. File hello_world.py akan muncul di ruang kerja.

Tool yang didukung

Layanan MCP DSW mengekspos serangkaian tool melalui protokol Streamable HTTP standar. Agent secara otomatis memuat daftar tool setelah terhubung. Tool tersebut dikelompokkan ke dalam lima kategori: Shell, File, System, Format conversion, dan Code, dengan total 16 tool.

Tool Shell

Jalankan perintah di dalam instans. Perintah berurutan berbagi direktori kerja, yang berguna untuk menjalankan skrip, menginstal dependensi, dan memulai pekerjaan pelatihan.

Tool	Fungsi	Parameter utama
`shell_exec`	Jalankan perintah shell	cmd (wajib), cwd, new_session, timeout
`shell_view`	Lihat output terakumulasi dan status 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

Tool File

Baca, tulis, cari, dan edit file di dalam instans.

Tool	Fungsi	Parameter utama
`file_read`	Baca konten file (berdasarkan rentang baris)	path (wajib), start_line, end_line, sudo
`file_write`	Tulis atau tambahkan ke file; mendukung 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 berdasarkan ekspresi reguler	path, regex
`file_find`	Temukan file berdasarkan pola glob	path, pattern
`file_list`	Daftar direktori (rekursif, filter berdasarkan jenis)	path, recursive, file_types
`file_edit`	Editor yang mendukung undo	command (view/create/str_replace/insert/undo_edit), path, dan lainnya

Tool System

Kueri lingkungan instans dan dependensi yang telah diinstal.

Tool	Fungsi	Parameter utama
`system_info`	Kueri lingkungan instans (OS, Python, Node, tool yang tersedia)	Tidak ada
`system_packages`	Daftar paket Python atau Node.js yang telah diinstal	language

Tool konversi format

Tool	Fungsi	Parameter utama
`util_to_markdown`	Konversi halaman web, PDF, file Office, gambar, dan lainnya ke Markdown	uri

Tool Code

Tool	Fungsi	Parameter utama
`code_run`	Jalankan kode (saat ini mendukung Python)	code, language, timeout

Setelah layanan MCP diaktifkan, tool tersebut langsung tersedia. Tidak diperlukan konfigurasi tambahan.