TestSprite MCP Server — Panduan Lengkap untuk Developer Indonesia
Sumber asli: https://docs.testsprite.com
Bahasa: Indonesia | Diterjemahkan untuk developer Indonesia

TestSprite adalah agen pengujian perangkat lunak AI yang paling mudah digunakan untuk pengujian otomatis sepenuhnya. AI tanpa kode kami menyelesaikan siklus pengujian dalam 10–20 menit, sehingga Anda dapat merilis software dengan percaya diri tanpa pekerjaan QA manual.

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

Prasyarat
Sebelum memasang TestSprite MCP Server, pastikan Anda memiliki:

• IDE yang kompatibel — Cursor, Claude Code, Trae, VSCode, atau IDE lainnya
• Akun TestSprite — Daftar gratis di https://testsprite.com
• Node.js >= 22 — Unduh di https://nodejs.org (diperlukan untuk menjalankan MCP server)

Cara memeriksa versi Node.js:
node --version

Pastikan hasilnya v22.0.0 atau lebih baru

Mendapatkan API Key
Masuk ke TestSprite Dashboard di https://app.testsprite.com
Navigasi ke API Keys di bawah menu Settings
Klik "New API Key"
Salin API key Anda
⚠️ Jangan commit API key ke repository publik.

Instalasi per IDE

Cursor
Buka Cursor Settings → MCP, tambahkan konfigurasi berikut:
{
"mcpServers" : {
"testsprite" : {
"command" : "npx",
"args" : [
"-y",
"@testsprite/mcp@latest"
],
"env" : {
"TESTSPRITE_API_KEY" : "api-key-anda-di-sini"
}
}
}
}

Simpan dan restart Cursor.

Claude Code
Jalankan perintah berikut di terminal:
claude mcp add testsprite -e TESTSPRITE_API_KEY = api-key-anda -- npx -y @testsprite/mcp@latest

VSCode
Tambahkan ke settings.json :
{
"mcp.servers" : {
"testsprite" : {
"command" : "npx",
"args" : [
"-y",
"@testsprite/mcp@latest"
],
"env" : {
"TESTSPRITE_API_KEY" : "api-key-anda-di-sini"
}
}
}
}

Trae (ByteDance)
Navigasi ke AI Sidebar → AI Management
Pilih MCP → Add → Add from Marketplace
Cari "TestSprite" dan ikuti instruksi

Tes Pertama Anda — 5 Langkah

Langkah 1: Jalankan Aplikasi Lokal

Frontend (contoh)

npm run dev

Port 3000, 5173, atau 8080

Backend (contoh)

node index.js

Port 8000, 3001, atau 4000

Contoh struktur proyek:
my-project/
├── frontend/
│ ├── src/
│ │ ├── package.json
│ │ └── ...
│ └── ...
├── backend/
│ ├── app.py
│ ├── requirements.txt
│ └── ...
└── README.md

Langkah 2: Perintah Ajaib di IDE
Buka chat IDE Anda, ketik:
Bisakah kamu menguji proyek ini dengan TestSprite?
Seret folder proyek ke chat jika perlu, lalu tekan ⇧ Enter.
Asisten AI akan mengambil alih.

Langkah 3: Konfigurasi Pengujian
Halaman Konfigurasi Pengujian akan terbuka di browser. Konfigurasikan:
Tipe Pengujian:

• Frontend — uji UI, tombol, formulir, navigasi
• Backend — uji API, layanan, logika server

Kredensial Tes (jika aplikasi butuh login):

Frontend

Username : test@example.com
Password : password-test-anda

Backend

API_KEY : test-api-key-anda
BASE_URL : http://localhost:3000

Langkah 4: Jalankan & Tunggu
Klik "Start Testing".
TestSprite akan:

• Men-deploy cloud sandbox ephemeral untuk pengujian terisolasi
• Menganalisis struktur kodebase secara otomatis
• Menghasilkan rencana pengujian komprehensif
• Menjalankan semua tes di cloud
• Mengambil screenshot dan mencatat error

Langkah 5: Tinjau Laporan
Setelah selesai, Anda mendapat:

• Ringkasan tes — jumlah lulus/gagal
• Deskripsi bug — detail setiap masalah ditemukan
• Screenshot — bukti visual bug UI
• Saran perbaikan — rekomendasi kode dari AI
• Perbaikan otomatis — opsi biarkan AI memperbaiki langsung

Alur Kerja I

TestSprite 프로젝트 테스트 가이드

새로운 프로젝트 테스트 생성

이 프로젝트에 대한 완전한 테스트 스위트 (test suite) 를 TestSprite 을 사용하여 생성합니다.

특정 기능 테스트 추가

TestSprite 을 사용하여 체크아웃 (checkout) 기능을 위한 테스트를 추가합니다.

코드 변경 후 테스트 업데이트

컴포넌트 Cart 에서의 최신 변경 사항에 맞춰 TestSprite 테스트를 업데이트합니다.

GitHub CI/CD 통합

.github/workflows/testsprite.yml 파일을 구성합니다:

name: TestSprite CI
on:
  pull_request:
    branches:
      - main
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run TestSprite Tests
        uses: testsprite/action@v1
        with:
          api-key: ${{ secrets.TESTSPRITE_API_KEY }}

각 Pull Request 는 자동으로 테스트됩니다. 보고서는 PR 에 직접 전송됩니다.

문제 해결

npx: command not found 오류

• node --version: # v22 이상 필요
• npm --version: # 설치 확인 필요

TESTSPRITE_API_KEY 설정 안됨

IDE 의 MCP 구성을 확인하세요 — API key 에 공백이나 숨겨진 문자가 없도록 합니다.

Cursor 에서 MCP 서버 감지 실패

Cursor 를 완전히 재시작합니다 (리로드가 아님).
~/.cursor/mcp.json 을 확인하여 JSON 형식을 검증하고, 객체 끝에 불필요한 쉐이크를 제거하세요.

Claude Code 에서 MCP 서버 감지 실패

claude mcp list 를 실행하여 등록 여부를 확인하세요.

목록에 없다면 다시 추가합니다:

claude mcp add testsprite -e TESTSPRITE_API_KEY = your-key -- npx -y @testsprite/mcp@latest

TestSprite 에서 애플리케이션 발견 실패

테스트 시작 전에 애플리케이션이 작동하고 있는지 확인하세요.

• 포트 확인: http://localhost:3000 (프론트엔드) 또는 http://localhost:8000 (백엔드)
• 로컬 연결을 차단하는 방화벽 설정이 없는지 확인하세요.

테스트 타임아웃

TestSprite 구성에서 시간 제한을 추가합니다.
애플리케이션 성능을 확인하세요 — 느린 응답은 타임아웃을 유발합니다.
데이터베이스 중량 작업에는 모크 데이터를 사용하세요.

다음 단계

• 테스트 생성: 더 복잡한 커스텀 테스트 생성
• 대시보드 진행 상황: 모든 테스트 모니터링
• GitHub 통합: CI/CD 자동화
• 보안: 모범 사례 적용

자료

📖 문서: https://docs.testsprite.com
💬 Discord: https://discord.gg/testsprite
🌐 웹사이트: https://testsprite.com

모든 변수 이름, 터미널 명령어 및 코드 블록은 국제 프로그래밍 관례에 따라 원본 형식을 유지합니다. 서술문과 UI 라벨만 번역됩니다.