DEV Community

asta yui
asta yui

Posted on

Panduan Memulai TestSprite MCP Server — Dokumentasi Bahasa Indonesia

#testing #indonesia #mcp #tutorial

Panduan Memulai TestSprite MCP Server — Terjemahan Bahasa Indonesia

Dokumen ini adalah terjemahan resmi dari dokumentasi TestSprite untuk developer Indonesia.
Sumber asli: https://docs.testsprite.com

Daftar Isi

  1. Pengenalan TestSprite
  2. Prasyarat Sistem
  3. Mendapatkan API Key
  4. Instalasi MCP Server
  5. Verifikasi Instalasi
  6. Menjalankan Test Pertama
  7. Konsep Utama
  8. Troubleshooting

Pengenalan TestSprite

TestSprite adalah agen pengujian perangkat lunak AI yang sepenuhnya otonom dan paling mudah digunakan. AI kami menyelesaikan seluruh siklus pengujian dalam 10–20 menit, sehingga Anda dapat merilis kode dengan penuh keyakinan tanpa perlu melakukan pekerjaan QA secara manual.

TestSprite MCP Server adalah integrasi Model Context Protocol yang memungkinkan asisten AI di IDE Anda (seperti Cursor, Claude Code, atau VS Code) untuk mengatur seluruh alur kerja TestSprite langsung dari editor.

Mengapa TestSprite?

  • Tanpa kode: Tidak perlu menulis skrip pengujian secara manual
  • Otonom: AI menganalisis proyek Anda dan membuat test case secara otomatis
  • Cepat: Siklus pengujian lengkap selesai dalam 10–20 menit
  • Terintegrasi: Bekerja langsung di dalam IDE favorit Anda

Prasyarat Sistem

Sebelum menginstal TestSprite MCP Server, pastikan Anda memiliki:

IDE yang Didukung

TestSprite mendukung IDE dan editor berikut:

  • Trae (Direkomendasikan)
  • Cursor
  • Claude Code
  • VS Code (dengan ekstensi Copilot)
  • Antigravity
  • IDE lainnya yang mendukung protokol MCP

Akun TestSprite

  • Daftar gratis di testsprite.com
  • Tidak memerlukan kartu kredit untuk memulai

Node.js versi 22 ke atas

TestSprite MCP Server membutuhkan Node.js versi 22 atau lebih baru.

Cara memeriksa versi Node.js Anda:

node --version
Enter fullscreen mode Exit fullscreen mode

Jika versi di bawah 22, unduh versi terbaru dari nodejs.org.

Mendapatkan API Key

API Key diperlukan untuk semua metode instalasi. Berikut cara mendapatkannya:

  1. Masuk ke Dashboard TestSprite
  2. Navigasi ke menu Settings → API Keys
  3. Klik tombol "New API Key"
  4. Salin API Key Anda — simpan di tempat yang aman, karena hanya ditampilkan sekali

⚠️ Penting: Jangan bagikan API Key Anda ke siapa pun. Perlakukan seperti kata sandi.

Instalasi MCP Server

Pilih metode instalasi sesuai IDE yang Anda gunakan:

Trae (Direkomendasikan)

  1. Dapatkan API Key Anda (lihat bagian di atas)
  2. Di Trae, buka AI Sidebar → 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 pengujian

Cursor

  1. Buka Settings di Cursor
  2. Navigasi ke bagian MCP Servers
  3. Tambahkan konfigurasi berikut: 
{
  "mcpServers": {
    "testsprite": {
      "command": "npx",
      "args": ["-y", "@testsprite/mcp-server"],
      "env": {
        "TESTSPRITE_API_KEY": "api-key-anda-di-sini"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode
  1. Ganti api-key-anda-di-sini dengan API Key Anda yang sebenarnya
  2. Restart Cursor

Claude Code

  1. Jalankan perintah berikut di terminal: 
claude mcp add testsprite \
  -e TESTSPRITE_API_KEY=api-key-anda \
  -- npx -y @testsprite/mcp-server
Enter fullscreen mode Exit fullscreen mode
  1. Ganti api-key-anda dengan API Key Anda yang sebenarnya
  2. Verifikasi dengan menjalankan: claude mcp list

VS Code

  1. Instal ekstensi GitHub Copilot jika belum ada
  2. Buka file .vscode/mcp.json di proyek Anda (buat jika belum ada)
  3. Tambahkan konfigurasi berikut: 
{
  "servers": {
    "testsprite": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@testsprite/mcp-server"],
      "env": {
        "TESTSPRITE_API_KEY": "api-key-anda-di-sini"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Verifikasi Instalasi

Tanda-tanda Instalasi Berhasil

Setelah instalasi, periksa hal-hal berikut:

✅ Asisten AI Anda dapat melihat dan menggunakan tool TestSprite MCP

✅ Tidak ada pesan error "command not found" di terminal

✅ Status MCP server menunjukkan "connected" atau "running"

Uji Cepat

Coba prompt berikut di asisten AI Anda:

Bantu saya menguji proyek ini menggunakan TestSprite.
Enter fullscreen mode Exit fullscreen mode

Asisten Anda seharusnya menawarkan penggunaan tool TestSprite MCP. Jika berhasil, instalasi sudah benar.

Menjalankan Test Pertama

Setelah instalasi berhasil, berikut cara menjalankan test pertama Anda:

Langkah 1: Buka Proyek Anda

Pastikan proyek yang ingin diuji sudah terbuka di IDE Anda.

Langkah 2: Minta TestSprite Menganalisis Proyek

Ketik prompt berikut di asisten AI:

Gunakan TestSprite untuk membuat test case untuk proyek ini.
Enter fullscreen mode Exit fullscreen mode

TestSprite akan:

  1. Menganalisis struktur kode Anda secara otomatis
  2. Memahami alur utama aplikasi
  3. Membuat test case yang komprehensif
  4. Menjalankan pengujian di sandbox cloud

Langkah 3: Pantau Progres

Anda dapat memantau progres pengujian melalui:

  • Dashboard TestSprite: Login ke testsprite.com/dashboard
  • Output IDE: Hasil langsung ditampilkan di panel AI asisten Anda

Langkah 4: Tinjau Hasil

Setelah pengujian selesai, TestSprite akan memberikan:

  • Laporan detail tentang bug yang ditemukan
  • Saran perbaikan yang spesifik dan actionable
  • Skor kualitas kode berdasarkan hasil pengujian

Konsep Utama

MCP (Model Context Protocol)

MCP adalah protokol standar yang memungkinkan asisten AI untuk berinteraksi dengan tool dan layanan eksternal secara aman. TestSprite menggunakan MCP agar asisten AI di IDE Anda bisa mengontrol proses pengujian.

Test Case Otonom

Berbeda dengan framework testing tradisional (seperti Jest, Cypress, atau Selenium) yang mengharuskan Anda menulis kode test secara manual, TestSprite menghasilkan test case secara otomatis berdasarkan analisis kode Anda.

Cloud Sandbox

Setiap sesi pengujian dijalankan di lingkungan cloud yang terisolasi (sandbox), memastikan pengujian tidak mengganggu lingkungan pengembangan lokal Anda.

Autonomous Patching

TestSprite tidak hanya menemukan bug — ia juga dapat memberikan saran perbaikan yang siap diterapkan langsung ke kode Anda melalui asisten AI.

Troubleshooting

Error: "command not found" atau "npx not found"

Penyebab: Node.js belum terinstal atau versinya terlalu lama.

Solusi:

# Periksa versi Node.js
node --version

# Jika belum ada atau < v22, instal via nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
Enter fullscreen mode Exit fullscreen mode

Error: "Invalid API Key" atau "Unauthorized"

Penyebab: API Key salah atau sudah kadaluwarsa.

Solusi:

  1. Login ke Dashboard TestSprite
  2. Buat API Key baru di Settings → API Keys
  3. Perbarui konfigurasi MCP di IDE Anda dengan key yang baru

MCP Server Tidak Terdeteksi di IDE

Penyebab: File konfigurasi MCP salah format atau IDE perlu di-restart.

Solusi:

  1. Periksa format JSON konfigurasi MCP (pastikan tidak ada koma berlebih)
  2. Restart IDE sepenuhnya (bukan hanya reload window)
  3. Periksa log error di Output panel IDE Anda

Aplikasi Tidak Terdeteksi oleh TestSprite

Penyebab: TestSprite perlu mendeteksi aplikasi yang berjalan untuk melakukan pengujian.

Solusi:

  1. Pastikan aplikasi Anda sudah berjalan di port lokal sebelum meminta TestSprite mengujinya
  2. Berikan URL aplikasi secara eksplisit: "Uji aplikasi di http://localhost:3000"

Langkah Selanjutnya

Setelah berhasil menjalankan test pertama, eksplorasi fitur lanjutan:

Bergabung dengan Komunitas

  • 💬 Discord: Bergabunglah dengan komunitas developer TestSprite
  • 🐙 GitHub: github.com/testsprite
  • 💼 LinkedIn: Ikuti perkembangan terbaru TestSprite

Dokumen ini diterjemahkan dari dokumentasi resmi TestSprite. Untuk versi terbaru, kunjungi docs.testsprite.com.

Diterjemahkan oleh: bandrex_asta — Developer Indonesia

Top comments (0)