Panduan Memulai TestSprite MCP Server — Dokumentasi Bahasa Indonesia

Dokumentasi resmi TestSprite diterjemahkan ke Bahasa Indonesia untuk memudahkan developer lokal memulai pengujian AI secara otomatis.
Sumber asli: https://docs.testsprite.com

---

Daftar Isi

1. Pengenalan
2. Ikhtisar — Apa Itu TestSprite MCP Server?
3. Instalasi
4. Tes MCP Pertama Kamu

---

Pengenalan

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

TestSprite MCP Server adalah integrasi Model Context Protocol yang memungkinkan asisten AI di IDE kamu untuk mengatur seluruh alur kerja TestSprite langsung dari editor kamu.

---

Ikhtisar

Apa Itu TestSprite MCP Server?

TestSprite MCP Server adalah integrasi Model Context Protocol yang menghubungkan asisten AI di IDE kamu (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 perintah bahasa alami sederhana untuk membiarkan agen pengujian AI kami menangani seluruh alur kerja pengujian.

Cukup ketik:

Bantu saya menguji proyek ini dengan TestSprite.

TestSprite MCP Server akan menangani sisanya.

Cara Kerja TestSprite dalam 8 Langkah Sederhana:

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

Keunggulan Utama

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

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

Perbandingan dengan Pengujian Tradisional

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

Kemampuan Pengujian

Pengujian Frontend (E2E Business-Flow):

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

Pengujian Backend (API & Integrasi):

• Alur Kerja API Fungsional
• Validasi Kontrak & Schema
• Penanganan Error & Ketahanan
• Otorisasi & Autentikasi
• Kasus Batas & Edge Case
• Integritas & Persistensi Data
• 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
• Pengujian 10x Lebih Cepat — Dari jam menjadi menit
• Tanpa Kurva Pembelajaran — Tidak diperlukan keahlian pengujian
• Perbaikan Bug Otomatis — AI memperbaiki masalah secara otomatis

---

Instalasi

Siapkan dan jalankan TestSprite MCP Server di IDE kamu dalam waktu kurang dari 2 menit.

Prasyarat

Sebelum menginstal 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 (diperlukan untuk menjalankan MCP server)

Untuk memeriksa versi Node.js kamu, jalankan:

node --version

Dapatkan API Key Kamu

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

Cara 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 kamu di Trae dan tekan Confirm.
6. Pilih Builder with MCP dan mulai pengujian.

Cursor

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

Instalasi Satu Klik:

1. Dapatkan API key kamu.
2. Klik tautan instalasi satu klik.
3. Masukkan API key kamu 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"
      }
    }
  }
}

Konfigurasi Cursor Sandbox Mode:

Mode Sandbox Cursor membatasi fungsionalitas alat MCP. Untuk memastikan fungsionalitas penuh TestSprite MCP Server:

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 proyek kamu di terminal:

   cd /path/to/your/project

1. Tempel perintah instalasi ke terminal kamu:

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

1. Ganti api_key_kamu dengan API key TestSprite kamu yang sebenarnya

2. Verifikasi instalasi dengan menjalankan:
   

   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 identifier/nama MCP server
6. Pilih scope di mana kamu ingin MCP server dikonfigurasi
7. Tambahkan konfigurasi env:

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

IDE Lainnya

Tambahkan konfigurasi ini ke pengaturan MCP kamu:

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

Verifikasi Instalasi

Indikator Berhasil:

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

Tes Cepat:
Coba prompt berikut:

Bantu saya menguji proyek ini dengan TestSprite.

Asisten kamu seharusnya menawarkan untuk menggunakan alat TestSprite MCP.

Uninstalasi

Untuk menghapus TestSprite MCP Server:

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

---

Tes MCP Pertama

Rasakan keajaiban TestSprite MCP Server dengan tes otomatis pertama kamu dalam waktu kurang dari 10 menit.

Di akhir panduan ini, kamu akan sudah:

• Menjalankan suite pengujian otomatis pertama kamu
• Melihat AI menghasilkan rencana pengujian komprehensif
• Menyaksikan pengujian dijalankan di cloud
• Menerima laporan pengujian terperinci
• Menerapkan perbaikan bug otomatis

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

Langkah 1: Siapkan Proyek Kamu

Jalankan Aplikasi Kamu — Pastikan aplikasi kamu 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 kamu dan ikuti langkah-langkah ini:

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

Bisakah kamu menguji proyek ini dengan TestSprite?

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

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

Langkah 3: Konfigurasi (Wajib)

Saat alat bootstrap terbuka, kamu harus mengkonfigurasi:

1. Tipe Pengujian:

• Mode:

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

• Scope:

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

2. Kredensial Akun Pengujian — Jika aplikasi kamu memerlukan login:

Untuk Frontend:

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

Untuk Backend, pilih tipe autentikasi:
| Tipe Autentikasi | Deskripsi |
|:---|:---|
| Basic | Menggunakan username & password |
| Bearer | Autentikasi berbasis token yang aman |
| API-key | Menggunakan API key unik untuk akses |
| None | Tidak diperlukan autentikasi |

3. URL Aplikasi:

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

4. Product Requirements Document (PRD) — Upload PRD yang ada (wajib). Bahkan draft atau PRD berkualitas rendah pun tidak masalah. TestSprite AI akan menghasilkan PRD yang dinormalisasi berdasarkan unggahan kamu.

Langkah 4: Alur Kerja Otomatis

Asisten AI kamu akan secara otomatis menangani seluruh proses pengujian dengan menjalankan langkah-langkah berikut. Ia menangani segalanya mulai dari memahami proyek kamu hingga menjalankan pengujian yang sebenarnya, sehingga kamu tidak perlu melakukan pekerjaan manual apa pun.

Langkah 5: Tinjau Hasil Pengujian

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

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 dinormalisasi
├── 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 pengujian tambahan

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

Contoh ringkasan laporan:

{
  "summary": {
    "totalTests": 18,
    "passed": 12,
    "failed": 6,
    "passRate": "67%",
    "coverage": "85%"
  },
  "failures": [
    {
      "testId": "TC005",
      "title": "Akses Panel Admin",
      "error": "Tombol tidak ditemukan: #admin-delete-btn",
      "recommendation": "Tambahkan tombol hapus yang hilang di panel admin"
    }
  ]
}

Langkah 6: Perbaikan Bug Otomatis

Minta Perbaikan — Setelah meninjau hasil pengujian, cukup tanyakan:

Tolong perbaiki codebase berdasarkan hasil pengujian TestSprite.

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

Tips untuk Sukses

• Pastikan Aplikasi Berjalan — Frontend dan backend harus dapat diakses di port standar
• Struktur Proyek — Sertakan README dengan instruksi setup dan nama folder yang deskriptif
• Kredensial Pengujian — Siapkan akun pengguna pengujian dengan data non-produksi
• Tinjau File yang Dihasilkan — Periksa keakuratan PRD dan rencana pengujian yang dihasilkan

---

Langkah Selanjutnya

Selamat! Kamu telah berhasil menjalankan tes otomatis pertama dengan TestSprite MCP Server.

• Alur Kerja Pengujian Lengkap
• Lihat Contoh Nyata
• Bergabung dengan Discord
• Dokumentasi Lengkap (English)

---

Diterjemahkan dari dokumentasi resmi TestSprite: https://docs.testsprite.com

Bahasa: Indonesia (id-ID)

Tanggal terjemahan: 2 Mei 2026