TestSprite MCP Server — Panduan Memulai (Bahasa Indonesia)

Dokumentasi resmi TestSprite diterjemahkan ke Bahasa Indonesia untuk developer Indonesia yang ingin memulai pengujian perangkat lunak berbasis AI secara otomatis.

Sumber asli: https://docs.testsprite.com

Diterjemahkan oleh: Developer Indonesia untuk komunitas developer Indonesia

Daftar Isi

1. Pengenalan TestSprite
2. Gambaran Umum — Apa itu TestSprite MCP Server?
3. Instalasi — Cara Memasang TestSprite MCP Server
4. Tes Pertama — Jalankan Tes Otomatis dalam 10 Menit
5. Membuat Tes untuk Proyek Baru
6. Istilah Penting dalam TestSprite

1. Pengenalan TestSprite

TestSprite adalah agen pengujian perangkat lunak berbasis AI yang paling mudah digunakan untuk pengujian sepenuhnya otonom. AI tanpa kode kami menyelesaikan siklus pengujian dalam 10–20 menit, sehingga kamu bisa merilis produk dengan percaya diri tanpa perlu pekerjaan QA manual.

TestSprite MCP Server adalah integrasi Model Context Protocol — sebuah standar open-source untuk menghubungkan aplikasi AI ke sistem eksternal — yang memungkinkan asisten AI di IDE-mu untuk mengatur seluruh alur kerja TestSprite langsung dari editor.

2. Gambaran Umum — Apa itu TestSprite MCP Server?

TestSprite MCP Server adalah integrasi Model Context Protocol yang menghubungkan asisten AI di IDE-mu (seperti Cursor atau Windsurf) dengan mesin pengujian cerdas TestSprite. Ini memungkinkan alur kerja pengujian yang sepenuhnya otomatis langsung di dalam lingkungan pengembangan kamu.

Cara Kerjanya

Setelah menginstal TestSprite MCP di IDE kamu, kamu bisa menggunakan prompt bahasa alami yang sederhana untuk membiarkan agen pengujian AI kami menangani seluruh alur kerja pengujian untuk kamu.

Cukup gunakan prompt berikut, seret folder proyek ke dalam chat, atau deskripsikan kebutuhan pengujianmu. TestSprite MCP Server akan menangani sisanya.

Help me test this project with TestSprite.

Cara TestSprite Bekerja dalam 8 Langkah Mudah

1. Membaca PRD Pengguna — Memahami persyaratan dan tujuan produkmu.
2. Menganalisis Kode — Memindai struktur proyek, fitur, dan implementasi.
3. Menghasilkan PRD TestSprite — Membuat dokumen persyaratan produk yang ternormalisasi.
4. Membuat Rencana Tes — Menghasilkan kasus tes komprehensif berdasarkan PRD dan kode.
5. Menghasilkan Kode Tes — Membuat skrip tes yang dapat dieksekusi (Playwright, Cypress, dll.).
6. Mengeksekusi Tes — Menjalankan tes di lingkungan cloud yang aman.
7. Memberikan Hasil — Menyampaikan laporan terperinci dengan wawasan yang dapat ditindaklanjuti.
8. Memungkinkan Perbaikan — IDE menggunakan analisis kami untuk secara otomatis memperbaiki masalah.

Manfaat Utama

• Untuk Developer: Rilis lebih cepat dengan nol penulisan tes, dapatkan umpan balik dalam hitungan menit (bukan jam), dan perbaiki masalah secara otomatis dengan analisis bertenaga AI — semuanya tanpa meninggalkan IDE-mu.

• Untuk Tim: Capai kualitas yang dapat diprediksi dan rilis lebih cepat dengan cakupan yang luas dan konsisten — termasuk kasus tepi — sambil mengurangi upaya QA manual dan overhead pemeliharaan tes.

Perbandingan dengan Pengujian Tradisional

Kemampuan Pengujian

Pengujian Frontend (Business-Flow E2E):

• Navigasi Perjalanan Pengguna
• Alur Formulir & Validasi
• Status Visual & Tata Letak
• Komponen Interaktif & UI Stateful
• Alur Otorisasi & Autentikasi
• Penanganan Kesalahan (UI)

Pengujian Backend (API & Integrasi):

• Alur Kerja API Fungsional
• Validasi Kontrak & Skema
• Penanganan Kesalahan & Ketahanan
• Otorisasi & Autentikasi
• Kasus Batas & Tepi
• Integritas Data & Persistensi
• Pengujian Keamanan

Teknologi yang Didukung

Framework Frontend:

• React, Vue, Angular, Svelte, Next.js, Vite, Vanilla JavaScript/TypeScript

Teknologi Backend:

• Node.js, Python, Java, Go, Express.js, FastAPI, Spring Boot, REST APIs, GraphQL

Hasil Nyata

• 90%+ Kualitas Kode — Capai kualitas kode tingkat profesional
• 10x Pengujian Lebih Cepat — Dari jam menjadi menit
• Nol Kurva Belajar — Tidak diperlukan keahlian pengujian
• Perbaikan Bug Otomatis — AI memperbaiki masalah secara otomatis

3. Instalasi — Cara Memasang TestSprite MCP Server

Pasang TestSprite MCP Server di IDE-mu dalam waktu kurang dari 2 menit.

Prasyarat

Sebelum menginstal TestSprite MCP Server, pastikan kamu memiliki:

1. IDE yang Kompatibel — TestSprite mendukung Trae, Cursor, Claude Code, Windsurf, VS Code, dan GitHub Copilot.
2. Akun TestSprite — Daftar gratis di sini
3. Node.js >= 22 — Unduh Node.js (diperlukan untuk menjalankan server MCP)

Cara memeriksa versi Node.js:

node --version

Mendapatkan API Key

Pertama, kamu memerlukan API key TestSprite untuk metode instalasi apa pun:

1. Masuk ke TestSprite Dashboard
2. Navigasi ke API Keys di bawah Settings
3. Klik "New API Key"
4. Salin API key-mu (kamu akan membutuhkannya untuk instalasi)

Instalasi per IDE

Trae

1. Dapatkan API key kamu.
2. Di Trae, navigasi ke AI Sidebar > AI Management.
3. Pilih MCP > Add > Add from Marketplace.
4. Cari TestSprite dan tambahkan ke daftar MCP kamu.
5. Masukkan API key-mu di Trae dan tekan Confirm
6. Pilih Builder with MCP dan mulai pengujian.

Cursor

Penting: Mode default "Run in Sandbox" milik Cursor membatasi fungsionalitas TestSprite. Lihat konfigurasi di bawah.

Instalasi Satu-Klik (Paling Mudah):

1. Dapatkan API key kamu.
2. Klik tautan instalasi satu-klik ini.
3. Masukkan API key-mu di Cursor.
4. Mulai pengujian.

Instalasi Manual:

1. Buka Pengaturan Cursor (Cmd/Ctrl + Shift + J)
2. Navigasi ke Tools & Integration
3. Klik Add custom MCP
4. Tambahkan konfigurasi berikut:

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "api-key-kamu"
      }
    }
  }
}

Konfigurasi Cursor Sandbox Mode:

Untuk memastikan fungsionalitas penuh TestSprite MCP Server di Cursor:

1. Buka Cursor → Settings → Cursor Settings
2. Buka Chat → Auto-Run → Auto-Run Mode dan ubah pengaturan ke "Ask Everytime" atau "Run Everything"

Claude Code

1. Navigasi ke direktori proyekmu di terminal:

   cd /path/to/your/project

1. Tempelkan perintah instalasi ke terminal:

   claude mcp add TestSprite --env API_KEY=api_key_kamu -- npx @testsprite/testsprite-mcp@latest

1. Ganti api_key_kamu dengan API key TestSprite yang sebenarnya

2. Jalankan perintah instalasi

3. Verifikasi instalasi dengan menjalankan perintah ini di direktori proyekmu:
   

   claude mcp list

Kamu seharusnya melihat:

   TestSprite: npx @testsprite/testsprite-mcp@latest - ✓ Connected

Catatan: Menginstal server MCP dengan cara ini hanya menambahkan TestSprite ke Claude Code di direktori proyek saat ini. Jika kamu menggunakan Claude Code di direktori proyek lain, kamu perlu menambahkan server MCP lagi.

VS Code

1. Buka Command Palette (Cmd/Ctrl + Shift + P)
2. Jalankan perintah MCP: Add Server
3. Pilih tipe instalasi Command (stdio)
4. Ketik npx @testsprite/testsprite-mcp@latest untuk Command to run
5. Ketik TestSprite untuk identifier/nama server MCP
6. Pilih cakupan di mana kamu ingin server MCP dikonfigurasi
7. Tambahkan konfigurasi env:

{
  "servers": {
    "testsprite": {
      "command": "npx",
      "args": ["-y", "@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "api-key-kamu"
      }
    }
  }
}

1. Setelah instalasi, klik tombol start di atas entri TestSprite MCP di file mcp.json yang baru kamu konfigurasi.

IDE Lainnya

Tambahkan konfigurasi ini ke pengaturan MCP-mu:

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "api-key-kamu"
      }
    }
  }
}

Verifikasi Instalasi

Indikator Keberhasilan:

• Asisten AI kamu dapat melihat alat TestSprite MCP
• Tidak ada kesalahan "command not found"
• Siap untuk mulai menguji proyekmu

Tes Cepat:
Coba beri prompt:

Help me test this project with TestSprite.

Asisten kamu seharusnya menawarkan untuk menggunakan alat TestSprite MCP.

Menghapus Instalasi

Untuk menghapus TestSprite MCP Server:

1. Hapus konfigurasi dari pengaturan MCP IDE-mu
2. Restart IDE-mu

4. Tes Pertama — Jalankan Tes Otomatis dalam 10 Menit

Rasakan keajaiban TestSprite MCP Server dengan tes otomatis pertamamu dalam kurang dari 10 menit.

Di akhir panduan ini, kamu akan telah menjalankan suite tes otomatis pertamamu, melihat AI menghasilkan rencana tes komprehensif, menyaksikan tes dieksekusi di cloud, menerima laporan tes terperinci, dan menerapkan perbaikan bug otomatis.

Sebelum memulai, pastikan kamu telah menginstal TestSprite MCP Server dan IDE-mu sudah terbuka.

Langkah 1: Persiapkan Proyekmu

Jalankan Aplikasimu — Pastikan aplikasimu berjalan secara lokal:

# 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

Contoh Struktur Proyek:

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

Langkah 2: Perintah Ajaib

Buka Chat IDE-mu dan ikuti langkah-langkah berikut:

1. Buka jendela chat baru di IDE-mu
2. Ketik perintah ajaib:

Can you test this project with TestSprite?

1. Seret dan lepas folder proyekmu ke dalam chat jika kamu ingin menguji sub-proyek tertentu
2. Tekan Shift + Enter

Itu saja! Asisten AI kamu sekarang akan mengambil alih dan membimbing kamu melalui seluruh proses pengujian.

Langkah 3: Konfigurasi (Wajib)

Catatan: Halaman Konfigurasi Pengujian akan terbuka di browser. Selesaikan pengaturan di sini untuk melanjutkan tesmu.

Ketika alat bootstrap terbuka, kamu harus mengkonfigurasi:

1. Tipe Pengujian:

• Mode:

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

• Cakupan (Scope):

  • Codebase: Menjalankan tes terhadap seluruh proyek. Gunakan ini jika kamu ingin sweeping tes penuh atau belum pernah menjalankan MCP sebelumnya.
  • Code Diff: Menjalankan tes hanya terhadap perubahan terbaru kamu (perubahan Git yang belum di-commit). Gunakan ini untuk memvalidasi pekerjaan baru dengan cepat tanpa menguji semuanya lagi.

2. Kredensial Akun Tes — Jika aplikasimu memerlukan login:

Untuk Frontend:

Username: test@example.com
Password: password-tes-kamu

Untuk Backend, tipe autentikasi yang didukung:

3. URL Aplikasi:

Frontend: http://localhost:5173
Backend: http://localhost:4000

4. Dokumen Persyaratan Produk (PRD):

Upload PRD yang ada (wajib). Bahkan draft atau PRD berkualitas rendah pun tidak apa-apa. AI TestSprite akan menghasilkan PRD ternormalisasi berdasarkan unggahanmu.

Langkah 4: Alur Kerja Otomatis

Asisten AI-mu akan secara otomatis menangani seluruh proses pengujian dengan menjalankan langkah-langkah berikut. Ini mengurus segalanya mulai dari memahami proyekmu hingga menjalankan tes aktual, sehingga kamu tidak perlu melakukan pekerjaan apa pun secara manual.

Langkah 5: Tinjau Hasil Tes

Setelah pengujian, kamu akan menemukan file-file ini di proyekmu:

testsprite_tests/
├── tmp/
│   ├── prd_files/                 # File PRD yang diunggah
│   ├── config.json               # Konfigurasi tes
│   ├── code_summary.json         # Analisis kode
│   ├── report_prompt.json        # Data analisis AI
│   └── test_results.json         # Hasil tes terperinci
├── standard_prd.json             # PRD ternormalisasi
├── TestSprite_MCP_Test_Report.md # Laporan yang dapat dibaca manusia
├── TestSprite_MCP_Test_Report.html # Laporan HTML
├── TC001_Login_Success_with_Valid_Credentials.py
├── TC002_Login_Failure_with_Invalid_Credentials.py
└── ...                           # File tes tambahan

Memahami Hasil Tes — Laporan tes menampilkan cakupan keseluruhan, tingkat kelulusan, tes yang gagal dengan analisis kegagalan terperinci, dan kategori (Fungsional, UI/UX, Keamanan, Performa).

Langkah 6: Perbaikan Bug Otomatis

Minta Perbaikan — Setelah meninjau hasil tes, cukup tanyakan:

Please fix the codebase based on TestSprite testing results.

AI akan menganalisis tes yang gagal, mengidentifikasi bagian kode yang bermasalah, menerapkan perbaikan yang ditargetkan secara otomatis, menjalankan ulang tes untuk memverifikasi perbaikan, dan melakukan iterasi hingga masalah teratasi.

Contoh Output

Rencana Tes yang Dihasilkan:

{
  "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 tes lainnya
  ]
}

Ringkasan Laporan Tes:

{
  "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"
    }
  ]
}

Tips untuk Sukses

• Pastikan Aplikasi Berjalan: Frontend dan backend harus dapat diakses di port standar
• Struktur Proyek: Sertakan README dengan instruksi pengaturan dan nama folder yang deskriptif
• Kredensial Tes: Siapkan akun pengguna tes dengan data non-produksi
• Tinjau File yang Dihasilkan: Periksa PRD dan rencana tes yang dihasilkan untuk akurasi

5. Membuat Tes untuk Proyek Baru

Hasilkan suite tes komprehensif untuk proyek baru menggunakan TestSprite MCP Server.

Kapan Menggunakan Ini

Gunakan panduan ini saat onboarding proyek yang memiliki sedikit atau tidak ada tes otomatis. Alur kerja MCP akan menganalisis codebase-mu, menurunkan PRD ternormalisasi, menghasilkan rencana tes frontend dan backend, membuat tes yang dapat dijalankan, mengeksekusinya, dan menghasilkan laporan.

Prasyarat

• TestSprite MCP telah diinstal dan dikonfigurasi di IDE-mu
• Aplikasi dapat berjalan secara lokal (server dev frontend atau API backend)
• Kredensial tes dasar jika autentikasi diperlukan

Quick Start (All-in-One)

Tanyakan kepada asisten IDE-mu:

Help me test this project with TestSprite.

Asisten akan mengatur alur penuh secara otomatis.

Alur Kerja Pengujian Lengkap

TestSprite mengikuti proses 8 langkah sistematis untuk mengubah kodemu menjadi perangkat lunak yang telah diuji secara menyeluruh:

Bootstrap Lingkungan → Baca PRD Pengguna → Analisis Kode
→ Hasilkan PRD TestSprite → Buat Rencana Tes
→ Hasilkan Kode Tes → Eksekusi Tes → Hasil & Analisis → AI Perbaiki Masalah

Langkah 1: Bootstrap Lingkungan Pengujian

AI memanggil testsprite_bootstrap_tests untuk menginisialisasi lingkungan pengujian.

Proses:

1. Deteksi Proyek: Mengidentifikasi tipe proyek (frontend atau backend)
2. Penemuan Port: Menemukan aplikasi yang berjalan dan port-nya
3. Portal Konfigurasi: Membuka antarmuka konfigurasi TestSprite
4. Definisi Cakupan: Menentukan cakupan pengujian (codebase untuk proyek penuh)

testsprite_bootstrap_tests({
  localPort: 5173, // atau port-mu
  type: "frontend", // atau "backend"
  projectPath: "/absolute/path/to/your/project",
  testScope: "codebase" // uji seluruh proyek
})

{
  "projectType": "frontend",
  "localPort": 5173,
  "testScope": "codebase",
  "needLogin": true,
  "credentials": {
    "username": "test@example.com",
    "password": "testpassword123"
  }
}

6. Istilah Penting dalam TestSprite

Generate & Regenerate

Tindakan ini mengontrol bagaimana TestSprite membuat dan memperbarui suite tesmu.

Generate (Hasilkan)

Buat tes untuk pertama kali berdasarkan PRD dan proyekmu.

Contoh prompt:

Help me test this project with TestSprite.

Kapan digunakan: Gunakan Generate saat kamu perlu membuat tes untuk pertama kalinya:

• Memulai proyek baru
• Menambahkan tes ke proyek yang sudah ada tanpa tes
• Membuat cakupan tes awal

Yang terjadi:

1. Menganalisis kodemu
2. Membuat rencana tes
3. Menghasilkan file tes
4. Mengeksekusi tes

Regenerate (Hasilkan Ulang)

Buat ulang tes dari awal berdasarkan PRD dan kode yang diperbarui.

Contoh prompt:

Regenerate tests for the updated checkout flow.

Kapan digunakan: Gunakan Regenerate saat kamu perlu membuat ulang tes dari awal:

• Aplikasimu berubah secara signifikan (fitur baru, alur yang di-refactor)
• Rencana tes perlu diperbarui agar sesuai dengan persyaratan baru
• Kamu ingin cakupan tes segar yang mencerminkan keadaan saat ini

Run & Rerun

Tindakan ini mengontrol bagaimana TestSprite mengeksekusi tesmu.

Run (Jalankan)

Eksekusi tes yang baru dihasilkan untuk pertama kalinya.

Kapan digunakan: Gunakan Run saat mengeksekusi tes untuk pertama kalinya:

• Setelah menghasilkan tes
• Validasi awal aplikasimu
• Eksekusi tes pertama kali

Rerun (Jalankan Ulang)

Eksekusi tes yang sebelumnya dihasilkan kembali tanpa mengubahnya.

Contoh prompt:

Rerun the login and checkout tests with TestSprite.

Kapan digunakan: Gunakan Rerun saat mengeksekusi tes yang ada kembali:

• Memvalidasi perbaikan yang baru kamu terapkan
• Mengonfirmasi tes lulus setelah aplikasi restart
• Pemeriksaan smoke cepat dengan tes yang ada

Healing (Penyembuhan)

Perbaikan otomatis atau semi-otomatis terhadap tes rapuh yang gagal karena perubahan non-fungsional (bukan bug nyata), membuat tes kuat tanpa menyembunyikan masalah produk aktual.

Skenario healing yang umum:

• Pemilih UI: Memperbarui ketika ID/kelas elemen berubah (misalnya, #login-btn → [data-testid="login"])
• Masalah Waktu: Menyesuaikan tunggu untuk komponen yang memuat lambat atau animasi
• Data Tes: Memperbarui fixture saat skema data berubah
• Lingkungan: Mengoreksi ketidakcocokan port, kredensial yang hilang, atau masalah konfigurasi
• Kontrak API: Mengencangkan pernyataan skema agar sesuai dengan respons API aktual

Cara kerjanya:

1. Detect: TestSprite mengidentifikasi kerapuhan tes (bukan bug produk)
2. Classify: Menentukan apakah itu drift pemilih, ketidakcocokan waktu, masalah env, atau pelanggaran kontrak
3. Propose Fix: Menghasilkan perbaikan yang aman
4. Apply: Diterapkan secara otomatis jika risiko rendah, atau meminta persetujuan untuk perubahan yang lebih besar
5. Verify: Menjalankan ulang tes untuk memvalidasi perbaikan berhasil

Apa yang Healing Bukan vs. Apa yang Healing Adalah:

Test Scope (Cakupan Tes)

Mendefinisikan bagian mana dari codebase-mu yang akan dianalisis dan diuji TestSprite.

PRD & Normalized PRD

TestSprite menggunakan Dokumen Persyaratan Produk (PRD) untuk memahami proyekmu dan menghasilkan tes yang sesuai.

PRD (Dokumen Persyaratan Produk)

Dokumentasi aslimu yang mendeskripsikan apa yang harus dilakukan produkmu.

Dapat berupa:

• Catatan informal atau README
• Dokumen spesifikasi formal
• Tiket Jira atau cerita pengguna
• Dokumen desain atau wiki

Normalized PRD (PRD Ternormalisasi)

Format Dokumen Persyaratan Produk standar TestSprite yang memastikan pembuatan tes yang konsisten dan lancar terlepas dari gaya PRD aslimu.

Yang ada di dalamnya:

• Gambaran umum dan tujuan produk
• Fitur inti dengan kriteria penerimaan
• Alur pengguna dan aturan validasi
• Konteks teknis dari analisis kode

Catatan: TestSprite menciptakan format ini untuk membuat pembuatan tes dapat diprediksi di berbagai jenis proyek.

Test Plan (Rencana Tes)

Daftar terstruktur dari kasus tes yang dihasilkan oleh TestSprite berdasarkan normalized PRD dan analisis kode.

Contoh:

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

Biasanya berisi:

• ID kasus tes (TC001, TC002, dll.)
• Deskripsi dan langkah-langkah
• Kategori (fungsional, keamanan, UI, dll.)
• Prioritas (Tinggi, Sedang, Rendah)
• Hasil yang diharapkan

Rencana disimpan sebagai frontend_test_plan.json atau backend_test_plan.json.

Sumber Daya Tambahan

• Dokumentasi Lengkap (Bahasa Inggris): https://docs.testsprite.com
• Website TestSprite: https://www.testsprite.com
• Komunitas Discord: https://discord.gg/QQB9tJ973e
• GitHub: https://github.com/wangy44624/docs

Dokumen terjemahan ini dibuat untuk membantu developer Indonesia memahami dan menggunakan TestSprite dalam Bahasa Indonesia. Semua nama variabel, perintah kode, dan blok kode tetap dalam Bahasa Inggris sesuai standar internasional pemrograman.

Total kata terjemahan: 2.000+ kata