DEV Community

nurul hikmah
nurul hikmah

Posted on

Panduan Memulai TestSprite MCP Server: Dokumentasi Lengkap dalam Bahasa Indonesia

#testsprite #testing #ai #indonesia

Panduan Memulai TestSprite MCP Server: Terjemahan Dokumentasi Lengkap ke Bahasa Indonesia

Catatan Penerjemah: Artikel ini adalah terjemahan resmi-tidak-resmi dari dokumentasi TestSprite MCP Server ke Bahasa Indonesia. Blok kode tetap dalam Bahasa Inggris agar tidak mengubah fungsionalitas. Tujuannya sederhana: membantu developer Indonesia memahami TestSprite tanpa harus berjuang dengan bahasa teknis asing.

Daftar Isi

  1. Pengantar
  2. Instalasi
  3. Tes Pertama Anda
  4. Istilah-Istilah Penting

Pengantar

Apa Itu TestSprite?

TestSprite adalah agen pengujian perangkat lunak berbasis AI yang dirancang untuk melakukan pengujian secara penuh otonom — tanpa perlu kode manual dari developer. Siklus pengujian yang biasanya memakan waktu berhari-hari bisa diselesaikan dalam 10 hingga 20 menit. Dengan TestSprite, Anda bisa ship dengan percaya diri tanpa bergantung pada proses QA manual yang lambat dan melelahkan.

TestSprite MCP Server adalah integrasi berbasis Model Context Protocol (MCP) yang memungkinkan asisten AI di IDE Anda — seperti Cursor, VSCode Copilot, atau Claude — untuk mengatur dan menjalankan seluruh alur kerja TestSprite langsung dari editor Anda, tanpa harus berpindah-pindah aplikasi.

Apa yang Bisa Dilakukan TestSprite MCP Server?

Dengan TestSprite MCP Server yang terhubung ke IDE Anda, asisten AI Anda mendapatkan kemampuan baru:

  • Membuat rencana pengujian otomatis berdasarkan kode proyek dan dokumen persyaratan Anda
  • Menjalankan pengujian di cloud — tidak perlu menyiapkan infrastruktur testing sendiri
  • Menghasilkan laporan lengkap lengkap dengan analisis kegagalan dan rekomendasi perbaikan
  • Memperbaiki bug secara otomatis berdasarkan hasil pengujian
  • Merawat test suite agar tetap berjalan meskipun ada perubahan kode

Mulai dari Mana?

Dokumentasi ini mencakup empat halaman utama yang dibutuhkan untuk memulai:

Halaman Deskripsi
Ikhtisar (Overview) Pelajari semua yang bisa dilakukan TestSprite MCP Server
Instalasi Pasang TestSprite MCP Server di IDE Anda
Tes MCP Pertama Selesaikan pengujian otomatis pertama dalam 10 menit
Alur Kerja Pengujian Pahami proses pengujian secara lengkap

Untuk mengakses indeks dokumentasi lengkap, Anda bisa mengunjungi: https://docs.testsprite.com/llms.txt

Instalasi

Persiapan Sebelum Instalasi

Sebelum memasang TestSprite MCP Server, pastikan Anda sudah memiliki:

IDE yang Kompatibel
TestSprite mendukung berbagai IDE populer termasuk Trae, Cursor, Claude Code, VSCode, dan lainnya.

Akun TestSprite
Daftar gratis di situs resmi TestSprite. Tidak diperlukan kartu kredit untuk memulai.

Node.js versi 22 ke atas
MCP Server membutuhkan Node.js sebagai runtime. Untuk mengecek versi yang Anda punya:

node --version
# Output yang diharapkan: v22.x.x atau lebih tinggi
Enter fullscreen mode Exit fullscreen mode

Jika belum punya atau versinya lebih lama, unduh Node.js dari situs resminya.

Mendapatkan API Key

Langkah pertama sebelum instalasi adalah mendapatkan API key TestSprite Anda:

  1. Masuk ke TestSprite Dashboard
  2. Buka menu Settings → klik API Keys
  3. Klik tombol "New API Key"
  4. Salin API key Anda — Anda akan membutuhkannya saat instalasi

Tips: Simpan API key di tempat yang aman. Jangan commit ke repository publik.

Panduan Instalasi per IDE

Proses instalasi sedikit berbeda tergantung IDE yang Anda gunakan. Berikut panduan untuk beberapa IDE populer:

Trae

  1. Dapatkan API key Anda (lihat langkah di atas)
  2. Di Trae, buka AI Sidebar → klik AI Management
  3. Pilih MCP → Add → Add from Marketplace
  4. Cari "TestSprite" dan tambahkan ke daftar MCP Anda
  5. Masukkan API key Anda di Trae dan klik Confirm
  6. Pilih mode Builder with MCP dan mulai testing

Cursor

  1. Dapatkan API key Anda
  2. Di Cursor, buka Settings → MCP
  3. Tambahkan konfigurasi TestSprite MCP Server
  4. Masukkan API key Anda
  5. Restart Cursor dan verifikasi koneksi

VSCode

  1. Dapatkan API key Anda
  2. Buka Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
  3. Cari pengaturan MCP dan tambahkan TestSprite
  4. Masukkan API key Anda
  5. Reload window

Claude Code dan IDE Lainnya

Untuk IDE lain yang mendukung MCP, ikuti dokumentasi khusus IDE tersebut untuk menambahkan MCP server baru, lalu gunakan konfigurasi TestSprite yang disediakan di dashboard.

Verifikasi Instalasi

Setelah instalasi selesai, pastikan semuanya berjalan dengan benar:

Tanda-tanda Instalasi Berhasil:

  • Asisten AI di IDE Anda bisa melihat tools TestSprite MCP
  • Tidak ada error "command not found" di konsol
  • Asisten AI siap membantu testing proyek Anda

Uji Cepat:
Coba ketik prompt berikut di chat asisten AI Anda:

Help me test this project with TestSprite.
Enter fullscreen mode Exit fullscreen mode

Jika instalasi berhasil, asisten Anda akan menawarkan untuk menggunakan tools TestSprite MCP.

Menghapus Instalasi

Jika perlu menghapus TestSprite MCP Server:

  1. Hapus konfigurasi dari pengaturan MCP di IDE Anda
  2. Restart IDE

Tes Pertama Anda

Rasakan Keajaiban TestSprite dalam 10 Menit

Panduan ini akan membawa Anda menjalankan suite pengujian otomatis pertama. Di akhir panduan ini, Anda akan:

  • Melihat AI menghasilkan rencana pengujian yang komprehensif
  • Menyaksikan pengujian berjalan di cloud secara otomatis
  • Menerima laporan pengujian yang mendetail
  • Mendapatkan perbaikan bug secara otomatis

Prasyarat: Pastikan TestSprite MCP Server sudah terpasang dan IDE Anda sudah terbuka.

Langkah 1: Siapkan Proyek Anda

Jalankan aplikasi Anda secara lokal terlebih dahulu:

# Untuk aplikasi frontend (contoh)
npm run dev          # Biasanya berjalan di port 3000, 5173, atau 8080

# Untuk aplikasi backend (contoh)
node index.js        # Biasanya berjalan di port 8000, 3001, atau 4000
Enter fullscreen mode Exit fullscreen mode

Contoh struktur proyek yang umum digunakan:

my-project/
├── frontend/          # React, Vue, Angular, dll.
│   ├── src/
│   ├── package.json
│   └── ...
├── backend/           # Node.js, Python, dll.
│   ├── app.py
│   ├── requirements.txt
│   └── ...
├── README.md
└── package.json
Enter fullscreen mode Exit fullscreen mode

Langkah 2: Perintah Ajaib

Buka jendela chat di IDE Anda dan lakukan hal berikut:

  1. Buka jendela chat baru di IDE Anda
  2. Ketik perintah berikut: 
Can you test this project with TestSprite?
Enter fullscreen mode Exit fullscreen mode
  1. Seret dan jatuhkan (drag and drop) folder proyek Anda ke dalam chat jika ingin menguji sub-proyek tertentu
  2. Tekan ⇧ Enter

Hanya itu! Asisten AI Anda akan mengambil alih dan memandu Anda melalui seluruh proses pengujian.

Langkah 3: Konfigurasi (Wajib)

Halaman Testing Configuration akan terbuka di browser Anda. Selesaikan pengaturan di sini untuk melanjutkan pengujian.

Saat tool bootstrap terbuka, Anda harus mengonfigurasi:

Jenis Pengujian dan Mode:

  • Frontend: Pilih ini jika ingin menguji UI dan alur pengguna (misalnya tombol, formulir, navigasi)
  • Backend: Pilih ini jika ingin menguji API, layanan, atau logika server

Kredensial Akun Pengujian — Jika aplikasi Anda memerlukan login:

# Contoh Kredensial
Username: test@example.com
Password: kata-sandi-pengujian-anda
Enter fullscreen mode Exit fullscreen mode

URL Aplikasi:

# Contoh URL
Frontend: http://localhost:5173
Backend: http://localhost:4000
Enter fullscreen mode Exit fullscreen mode

Dokumen Persyaratan Produk (PRD):
Unggah PRD yang ada (wajib). Bahkan draft atau PRD berkualitas rendah pun tidak masalah. AI TestSprite akan menghasilkan PRD yang sudah dinormalisasi berdasarkan unggahan Anda.

Langkah 4: Alur Kerja Otomatis

Setelah konfigurasi selesai, asisten AI Anda akan secara otomatis menangani seluruh proses pengujian. Anda tidak perlu melakukan apa pun secara manual — AI mengurus semuanya mulai dari memahami proyek Anda hingga menjalankan pengujian yang sebenarnya.

Alur kerja lengkap ini mencakup:

  • Analisis kode proyek
  • Pembuatan PRD yang dinormalisasi
  • Generasi rencana pengujian
  • Eksekusi pengujian di cloud
  • Pengumpulan dan analisis hasil

Langkah 5: Tinjau Hasil Pengujian

Setelah pengujian selesai, Anda akan menemukan file-file berikut di proyek Anda:

testsprite_tests/
├── tmp/
│   ├── prd_files/                 # File PRD yang diunggah
│   ├── config.json               # Konfigurasi pengujian
│   ├── code_summary.json         # Analisis kode
│   ├── report_prompt.json        # Data analisis AI
│   └── test_results.json         # Hasil pengujian terperinci
├── standard_prd.json             # PRD yang sudah dinormalisasi
├── TestSprite_MCP_Test_Report.md # Laporan dalam format teks
├── TestSprite_MCP_Test_Report.html # Laporan dalam format HTML
├── TC001_Login_Success_with_Valid_Credentials.py
├── TC002_Login_Failure_with_Invalid_Credentials.py
└── ...                           # File pengujian tambahan
Enter fullscreen mode Exit fullscreen mode

Memahami Laporan Pengujian:

Laporan pengujian menampilkan:

  • Cakupan keseluruhan (overall coverage) — persentase kode yang diuji
  • Tingkat kelulusan (pass rate) — berapa persen tes yang berhasil
  • Tes yang gagal dengan analisis kegagalan terperinci
  • Kategori pengujian: Fungsional, UI/UX, Keamanan, Performa

Contoh ringkasan laporan:

{
  "summary": {
    "totalTests": 18,
    "passed": 12,
    "failed": 6,
    "passRate": "67%",
    "coverage": "85%"
  },
  "failures": [
    {
      "testId": "TC005",
      "title": "Admin Panel Access",
      "error": "Button not found: #admin-delete-btn",
      "recommendation": "Add missing delete button in admin panel"
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

Langkah 6: Perbaikan Bug Otomatis

Setelah meninjau hasil pengujian, cukup minta asisten AI Anda untuk memperbaiki masalah yang ditemukan:

Please fix the codebase based on TestSprite testing results.
Enter fullscreen mode Exit fullscreen mode

AI akan:

  1. Menganalisis tes yang gagal
  2. Mengidentifikasi bagian kode yang bermasalah
  3. Menerapkan perbaikan secara otomatis
  4. Menjalankan ulang tes untuk memverifikasi perbaikan
  5. Mengulangi prosesnya hingga semua masalah terselesaikan

Contoh Hasil Nyata

Berikut contoh rencana pengujian yang dihasilkan AI:

{
  "testCases": [
    {
      "id": "TC001",
      "title": "User Authentication Login",
      "description": "Test user login with valid credentials",
      "category": "Functional",
      "priority": "High",
      "steps": [
        "Navigate to login page",
        "Enter valid username and password",
        "Click login button",
        "Verify successful login"
      ]
    }
    // ... 17 kasus pengujian lainnya
  ]
}
Enter fullscreen mode Exit fullscreen mode

Tips untuk Hasil Terbaik

Pastikan Aplikasi Berjalan
TestSprite perlu terhubung ke aplikasi Anda yang sedang berjalan. Pastikan semua layanan aktif sebelum memulai pengujian.

Struktur Proyek yang Jelas
Proyek dengan struktur folder yang teratur dan README yang baik akan menghasilkan rencana pengujian yang lebih akurat.

Kredensial Pengujian
Siapkan akun khusus untuk pengujian agar data produksi Anda tidak terpengaruh.

Tinjau File yang Dihasilkan
Luangkan waktu untuk membaca laporan dan rencana pengujian yang dihasilkan — ini membantu Anda memahami cakupan dan kualitas pengujian.

Istilah-Istilah Penting

Berikut adalah konsep-konsep inti TestSprite yang perlu Anda pahami sebelum mulai bekerja dengan platform ini.

Generate & Regenerate (Buat & Buat Ulang)

Dua aksi ini mengontrol bagaimana TestSprite membuat dan memperbarui suite pengujian Anda.

Generate (Buat)

Membuat pengujian untuk pertama kalinya berdasarkan PRD dan proyek Anda.

Gunakan prompt ini untuk memulai pengujian proyek Anda:

Help me test this project with TestSprite.
Enter fullscreen mode Exit fullscreen mode

Kapan digunakan: Saat pertama kali ingin menguji sebuah proyek yang belum pernah diuji dengan TestSprite.

Regenerate (Buat Ulang)

Membuat ulang pengujian dari awal berdasarkan PRD dan kode yang sudah diperbarui.

Gunakan prompt ini untuk meregenerasi pengujian setelah ada perubahan signifikan:

Regenerate tests for the updated checkout flow.
Enter fullscreen mode Exit fullscreen mode

Kapan digunakan: Setelah ada perubahan besar pada aplikasi atau persyaratan yang membuat pengujian lama sudah tidak relevan.

Run & Rerun (Jalankan & Jalankan Ulang)

Dua aksi ini mengontrol bagaimana TestSprite mengeksekusi pengujian Anda.

Run (Jalankan)

Menjalankan pengujian yang baru dibuat untuk pertama kalinya.

Gunakan saat:

  • Setelah baru selesai generate pengujian
  • Validasi awal aplikasi Anda
  • Eksekusi pengujian pertama kali

Rerun (Jalankan Ulang)

Menjalankan ulang pengujian yang sudah ada tanpa membuat ulang.

Gunakan prompt ini untuk menjalankan ulang pengujian yang sudah ada:

Rerun the login and checkout tests with TestSprite.
Enter fullscreen mode Exit fullscreen mode

Kapan digunakan: Saat ingin menjalankan pengujian yang sama lagi tanpa mengubah atau membuat ulang kasusnya — misalnya setelah memperbaiki bug.

Healing (Penyembuhan Otomatis)

Healing adalah fitur unik TestSprite yang secara otomatis atau semi-otomatis memperbaiki pengujian yang rapuh — pengujian yang gagal bukan karena ada bug nyata di aplikasi, tetapi karena ada perubahan non-fungsional seperti perubahan nama class CSS atau ID elemen.

Cara Kerja Healing:

  1. Deteksi — TestSprite mendeteksi pengujian yang gagal
  2. Klasifikasi — Menentukan apakah kegagalan karena bug nyata atau karena perubahan non-fungsional
  3. Usul Perbaikan — Mengusulkan perbaikan spesifik untuk pengujian yang rapuh
  4. Terapkan — Menerapkan perbaikan secara otomatis
  5. Verifikasi — Memastikan pengujian kembali berjalan dengan benar

Skenario Healing yang Umum:

Masalah Contoh
Selektor UI berubah #login-btn berubah menjadi [data-testid="login"]
Masalah Timing Komponen loading lambat atau ada animasi
Data Pengujian Schema data berubah
Konfigurasi Lingkungan Port berubah, kredensial hilang
Kontrak API Respons API berubah format

Penting — Apa yang Healing BUKAN:

Bukan Healing Healing Sebenarnya
Menutupi bug nyata di produk Membuat pengujian tahan terhadap perubahan non-fungsional
Membuat pengujian lolos padahal harusnya gagal Mengurangi pekerjaan maintenance pengujian

Healing tidak akan pernah menyembunyikan masalah nyata di aplikasi Anda.

Test Scope (Cakupan Pengujian)

Test Scope mendefinisikan bagian mana dari codebase yang akan dianalisis dan diuji oleh TestSprite.

TestSprite menawarkan dua opsi cakupan:

Fitur Codebase Code Diff
Yang Diuji Seluruh proyek Hanya file/fitur yang berubah (berdasarkan git diff)
Kasus Penggunaan Proyek baru, rilis besar, audit menyeluruh Cabang fitur, pengembangan inkremental, validasi cepat
Kecepatan Lebih lambat Umpan balik cepat
Cakupan Penuh Hanya perubahan terbaru

Anda dapat mengatur cakupan di halaman bootstrapping saat memanggil tool testsprite_bootstrap_tests.

PRD & Normalized PRD

TestSprite menggunakan Dokumen Persyaratan Produk (PRD) untuk memahami proyek Anda dan menghasilkan pengujian yang tepat sasaran.

PRD (Dokumen Persyaratan Produk)

Dokumentasi asli Anda yang mendeskripsikan apa yang harus dilakukan produk Anda. Bisa berupa:

  • Catatan informal atau README
  • Dokumen spesifikasi formal
  • Tiket Jira atau user stories
  • Dokumen desain atau wiki

Tidak ada format khusus yang diperlukan — TestSprite menerima PRD dalam bentuk apa pun.

Normalized PRD (PRD yang Dinormalisasi)

Format PRD standar milik TestSprite yang memastikan generasi pengujian yang konsisten, terlepas dari format PRD asli Anda.

TestSprite menciptakan format ini untuk membuat generasi pengujian dapat diprediksi di semua jenis proyek.

Isi Normalized PRD:

  • Ikhtisar dan tujuan produk
  • Fitur inti beserta kriteria penerimaan (acceptance criteria)
  • Alur pengguna dan aturan validasi
  • Konteks teknis dari analisis kode

Test Plan (Rencana Pengujian)

Test Plan adalah daftar terstruktur kasus pengujian yang dihasilkan TestSprite berdasarkan Normalized PRD dan analisis kode Anda.

Contoh entri dalam rencana pengujian:

{
  "id": "TC001",
  "title": "Login with valid credentials",
  "category": "functional",
  "priority": "High",
  "steps": [...]
}
Enter fullscreen mode Exit fullscreen mode

Rencana pengujian disimpan sebagai frontend_test_plan.json atau backend_test_plan.json di direktori proyek Anda.

Kesimpulan

TestSprite MCP Server mengubah cara developer Indonesia melakukan pengujian perangkat lunak. Tidak perlu lagi menulis ratusan baris kode pengujian secara manual, tidak perlu lagi bergantung pada QA eksternal yang lambat — cukup dengan satu perintah di IDE Anda, AI akan mengurus semuanya.

Poin-poin utama yang perlu diingat:

  • Instalasi mudah — kurang dari 2 menit, langsung di IDE favorit Anda
  • Satu perintah — "Can you test this project with TestSprite?" sudah cukup untuk memulai
  • 10-20 menit untuk siklus pengujian lengkap
  • Healing otomatis — pengujian Anda tidak akan mudah rusak karena perubahan kode kecil
  • PRD fleksibel — tidak perlu format khusus, TestSprite akan normalisasi sendiri

Untuk informasi lebih lanjut, kunjungi dokumentasi resmi TestSprite atau bergabung dengan komunitas Discord mereka.

Artikel ini diterjemahkan dari dokumentasi resmi TestSprite MCP Server. Versi asli tersedia di docs.testsprite.com.

Tags: #testsprite #testing #ai #automation #indonesia #developer #mcp #softwaredevelopment

Top comments (0)