TestSprite MCP Server — Panduan Memulai (Bahasa Indonesia)

Dokumentasi resmi: https://docs.testsprite.com

---

Pengantar

TestSprite adalah agen pengujian perangkat lunak AI yang paling mudah digunakan untuk pengujian otomatis penuh. AI kami menyelesaikan siklus pengujian dalam 10–20 menit, sehingga kamu bisa merilis aplikasi dengan percaya diri tanpa perlu kerja QA manual.

TestSprite MCP Server adalah integrasi berbasis Model Context Protocol (MCP) yang menghubungkan asisten AI di IDE kamu (seperti Cursor atau Windsurf) dengan mesin pengujian cerdas milik TestSprite. Dengan ini, seluruh alur pengujian dapat diotomatisasi langsung dari editor kamu.

---

Gambaran Umum

Apa itu TestSprite MCP Server?

TestSprite MCP Server menghubungkan asisten AI di IDE-mu dengan mesin pengujian TestSprite, memungkinkan alur kerja pengujian otomatis penuh langsung di lingkungan pengembangan kamu.

Cara Kerjanya

Setelah memasang TestSprite MCP di IDE-mu, cukup gunakan perintah bahasa alami:

Help me test this project with TestSprite.

TestSprite MCP Server akan menangani semua proses selanjutnya secara otomatis.

Alur Kerja 8 Langkah

1. Membaca PRD Pengguna — Memahami kebutuhan dan tujuan produkmu
2. Menganalisis Kode — Memindai struktur proyek, fitur, dan implementasi
3. Membuat TestSprite PRD — Menghasilkan dokumen kebutuhan produk yang ternormalisasi
4. Membuat Rencana Pengujian — Menghasilkan test case komprehensif berdasarkan PRD dan kode
5. Menghasilkan Kode Pengujian — Membuat skrip pengujian yang bisa dijalankan (Playwright, Cypress, dll.)
6. Menjalankan Pengujian — Menjalankan tes di lingkungan cloud yang aman
7. Memberikan Hasil — Menyampaikan laporan detail dengan wawasan yang bisa ditindaklanjuti
8. Mengaktifkan Perbaikan — IDE menggunakan analisis kami untuk secara otomatis memperbaiki masalah

Keunggulan Utama

Untuk Developer:

• Rilis lebih cepat dengan tanpa penulisan tes manual
• Dapatkan umpan balik dalam hitungan menit (bukan jam)
• Perbaiki masalah otomatis dengan analisis berbasis AI — semuanya tanpa keluar dari IDE

Untuk Tim:

• Kualitas yang dapat diprediksi dan rilis lebih cepat
• Cakupan luas dan konsisten, termasuk kasus tepi (edge cases)
• Mengurangi upaya QA manual dan overhead pemeliharaan tes

Perbandingan dengan Pengujian Tradisional

Fitur	Pengujian Tradisional	TestSprite MCP Server
Pembuatan test case	Menulis test case secara manual	AI menghasilkan test case otomatis
Pengaturan	Menyiapkan framework yang kompleks	Hampir tanpa pengaturan
Debugging	Men-debug kegagalan secara manual	Menganalisis dan memperbaiki masalah untuk kamu
Integrasi	Menjalankan tes terpisah dari pengembangan	Terintegrasi ke dalam alur kerja coding
Cakupan	Cakupan terbatas yang melewatkan edge case kritis	Cakupan otomatis yang komprehensif

---

Instalasi

Prasyarat

Sebelum memasang TestSprite MCP Server, pastikan kamu memiliki:

1. IDE yang Kompatibel — Trae, Cursor, Claude Code, Windsurf, VS Code, atau GitHub Copilot
2. Akun TestSprite — Daftar gratis
3. Node.js >= 22 — Unduh Node.js

Untuk memeriksa versi Node.js-mu:

node --version

Dapatkan API Key

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

Metode Instalasi

Cursor

Instalasi Satu Klik:

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

Instalasi Manual:

1. Buka Cursor Settings (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"
      }
    }
  }
}

Penting: Mode "Run in Sandbox" bawaan Cursor membatasi fungsionalitas TestSprite. Ubah pengaturan ke "Ask Everytime" atau "Run Everything" di Cursor → Settings → Chat → Auto-Run.

Claude Code

1. Navigasi ke direktori proyekmu di terminal:

cd /path/ke/proyekmu

1. Jalankan perintah instalasi:

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. Verifikasi instalasi:
   

claude mcp list

Kamu akan melihat:

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

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 nama identifier MCP server
6. Tambahkan konfigurasi env:

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

IDE Lainnya (Windsurf, Trae, dll.)

Tambahkan konfigurasi berikut ke pengaturan MCP-mu:

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

Verifikasi Instalasi

Tanda-tanda keberhasilan:

• Asisten AI-mu dapat melihat TestSprite MCP tools
• Tidak ada error "command not found"
• Siap untuk memulai pengujian proyekmu

---

Pengujian Pertamamu

Langkah 1: Persiapkan Proyekmu

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

Langkah 2: Perintah Ajaib

Buka chat IDE-mu dan lakukan:

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 chat jika ingin menguji sub-proyek tertentu
2. Tekan Shift + Enter

Itu saja! Asisten AI-mu akan mengambil alih dan memandu kamu melalui seluruh proses pengujian.

Langkah 3: Konfigurasi (Wajib)

Halaman Konfigurasi Pengujian akan terbuka di browser-mu. Kamu perlu mengisi:

1. Tipe Pengujian:

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

Lingkup Pengujian:

• Codebase: Menjalankan tes terhadap seluruh proyek. Gunakan ini untuk pemeriksaan menyeluruh
• Code Diff: Menjalankan tes hanya terhadap perubahan terbaru (perubahan Git yang belum di-commit). Gunakan ini untuk memvalidasi pekerjaan baru dengan cepat

2. Kredensial Akun Uji (jika aplikasimu memerlukan login):

Username: [e-mail]
Password: password-uji-kamu

Untuk backend, pilih tipe autentikasi: Basic, Bearer, API-key, atau None.

3. URL Aplikasi:

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

4. Product Requirements Document (PRD):
Unggah PRD yang ada (wajib). Bahkan draf atau PRD berkualitas rendah pun tidak masalah — AI TestSprite akan menghasilkan PRD yang ternormalisasi berdasarkan unggahanmu.

PRD bisa berupa:

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

Langkah 4: Alur Kerja Otomatis

Asisten AI-mu akan secara otomatis menangani seluruh proses pengujian — dari memahami proyekmu hingga menjalankan tes yang sebenarnya, tanpa kamu perlu melakukan pekerjaan secara manual.

Langkah 5: Tinjau Hasil Pengujian

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 detail
├── standard_prd.json             # PRD yang ternormalisasi
├── TestSprite_MCP_Test_Report.md # Laporan yang bisa 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 beserta analisis kegagalan detail, dan kategori (Fungsional, UI/UX, Keamanan, Performa).

Langkah 6: Perbaikan Otomatis

Setelah meninjau hasil tes, cukup minta:

Please fix the codebase based on TestSprite testing results.

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

---

Konsep-Konsep Penting

Generate vs Regenerate

• Generate: Membuat tes untuk pertama kalinya berdasarkan PRD dan proyekmu. Gunakan saat memulai proyek baru atau menambahkan tes ke proyek yang belum memiliki tes.

• Regenerate: Membuat ulang tes dari awal berdasarkan PRD dan kode yang diperbarui. Gunakan saat aplikasimu berubah secara signifikan (fitur baru, alur yang di-refactor) atau saat kamu ingin cakupan tes segar yang mencerminkan kondisi terkini.

Run vs Rerun

• Run: Menjalankan tes yang baru dihasilkan untuk pertama kalinya. Gunakan setelah menghasilkan tes atau untuk validasi awal.

• Rerun: Menjalankan tes yang sebelumnya dihasilkan lagi tanpa mengubahnya. Gunakan untuk memvalidasi perbaikan yang baru diterapkan atau untuk pemeriksaan cepat (smoke test).

Healing (Penyembuhan)

Healing adalah perbaikan otomatis atau semi-otomatis pada tes yang rapuh yang gagal karena perubahan non-fungsional (bukan bug nyata), sehingga tes menjadi lebih kuat tanpa menutupi masalah produk yang sebenarnya.

Skenario healing umum:

• UI Selector: Diperbarui saat ID/kelas elemen berubah (contoh: #login-btn → [data-testid="login"])
• Masalah Timing: Menyesuaikan jeda untuk komponen atau animasi yang lambat dimuat
• Data Uji: Memperbarui fixture saat skema data berubah
• Lingkungan: Memperbaiki ketidakcocokan port, kredensial yang hilang, atau masalah konfigurasi

Healing Bukan	Healing Adalah
Menutupi bug produk yang nyata	Membuat tes tahan terhadap perubahan kode non-fungsional
Membuat tes lulus padahal seharusnya gagal	Mengurangi pekerjaan pemeliharaan tes yang membosankan

Lingkup Pengujian (Test Scope)

Fitur	Codebase	Code Diff
Apa yang diuji	Menguji seluruh proyek	Menguji hanya file/fitur yang berubah (berdasarkan git diff)
Kasus penggunaan	Proyek baru, rilis besar, audit komprehensif	Branch fitur, pengembangan inkremental, validasi cepat
Kecepatan	Membutuhkan waktu lebih lama	Umpan balik cepat
Cakupan	Cakupan penuh	Hanya perubahan terbaru

PRD dan Normalized PRD

• PRD (Product Requirements Document): Dokumentasi originalmu yang mendeskripsikan apa yang harus dilakukan produkmu. Bisa berupa catatan informal, README, dokumen spesifikasi formal, tiket Jira, atau wiki desain.

• Normalized PRD: Format PRD standar milik TestSprite yang memastikan pembuatan tes yang konsisten dan lancar terlepas dari gaya PRD originalmu. Berisi gambaran produk dan tujuan, fitur inti dengan kriteria penerimaan, alur pengguna dan aturan validasi, serta konteks teknis dari analisis kode.

Rencana Pengujian (Test Plan)

Daftar terstruktur dari test case yang dihasilkan oleh TestSprite berdasarkan Normalized PRD dan analisis kode. Contoh:

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

Rencana pengujian disimpan sebagai frontend_test_plan.json atau backend_test_plan.json.

---

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

---

Kemampuan Pengujian

Pengujian Frontend (Business-Flow E2E):

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

Pengujian Backend (API & Integrasi):

• Alur Kerja API Fungsional
• Validasi Kontrak & Skema
• Penanganan Error & Ketahanan
• Otorisasi & Autentikasi
• Kasus Batas & Tepi (Boundary & Edge Cases)
• Integritas Data & Persistensi
• Pengujian Keamanan

---

Hasil Nyata

TestSprite MCP Server memberikan peningkatan yang terukur:

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

---

Tips untuk Keberhasilan

• 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 Uji: Siapkan akun pengguna uji dengan data non-produksi
• Tinjau File yang Dihasilkan: Periksa PRD dan rencana pengujian yang dihasilkan untuk memastikan akurasi

---

Langkah Selanjutnya

Setelah menyelesaikan panduan ini, kamu bisa:

• Menjelajahi Alur Kerja Pengujian Lengkap
• Melihat Contoh Nyata
• Bergabung dengan Komunitas Discord
• Mempelajari Integrasi GitHub

---

Diterjemahkan dari dokumentasi resmi TestSprite: https://docs.testsprite.com
Bahasa: Bahasa Indonesia | Negara: Indonesia