DEV Community

Ayo
Ayo

Posted on

TestSprite MCP Sunucusu — Başlangıç Kılavuzu

#turkish #testsprite #mcp #testing

TestSprite MCP Sunucusu — Başlangıç Kılavuzu

TestSprite MCP, yazılım projeleriniz için otomatik test planları oluşturup çalıştırabilen, bulut tabanlı bir test otomasyon platformudur. Bu rehberde, TestSprite MCP'yi IDE'nize nasıl entegre edeceğinizi ve ilk testinizi nasıl çalıştıracağınızı adım adım öğreneceksiniz.

Kurulum

Ön Koşullar

API Anahtarınızı Alın

  1. https://www.testsprite.com/dashboard adresinden TestSprite Dashboard'a giriş yapın
  2. Ayarlar bölümünden API Anahtarları'na gidin
  3. "Yeni API Anahtarı"na tıklayın
  4. API anahtarınızı kopyalayın

IDE Yapılandırması

Cursor (Tek Tıkla Kurulum)

  1. API anahtarınızı alın
  2. Cursor için tek tıkla kurulum bağlantısına tıklayın
  3. Cursor'a API anahtarınızı girin
  4. Teste başlayın

Cursor (Manuel Kurulum)

  1. Cursor Ayarlarını açın
  2. Araçlar & Entegrasyonlar bölümüne gidin
  3. Özel MCP ekle'ye tıklayın
  4. Aşağıdaki yapılandırmayı ekleyin: 
{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode
  1. TestSprite MCP sunucu ikonunda yeşil bir nokta göründüğünden emin olun

Önemli — Cursor Sandbox Modu: Cursor, MCP araçlarını varsayılan olarak sandbox modunda çalıştırır ve bu da TestSprite'ın bazı yeteneklerini kısıtlar. Düzeltmek için:

  • Cursor → Ayarlar → Cursor Ayarları'na gidin
  • Sohbet → Otomatik Çalıştır → Otomatik Çalıştır Modu'na gidin
  • "Her Seferinde Sor" veya "Her Şeyi Çalıştır" olarak değiştirin

Claude Code 

cd /path/to/your/project
claude mcp add TestSprite --env API_KEY=your_api_key -- npx @testsprite/testsprite-mcp@latest
Enter fullscreen mode Exit fullscreen mode

Doğrulama için:

claude mcp list
Enter fullscreen mode Exit fullscreen mode

Beklenen çıktı: TestSprite: npx @testsprite/testsprite-mcp@latest - ✓ Bağlandı

VSCode

  1. Komut Paletini açın
  2. MCP: Sunucu Ekle komutunu çalıştırın
  3. Komut (stdio) türünü seçin
  4. Komut olarak npx @testsprite/testsprite-mcp@latest yazın
  5. Ad olarak TestSprite girin
  6. Ortam değişkeni yapılandırmasını ekleyin: 
{
  "servers": {
    "testsprite": {
      "command": "npx",
      "args": ["-y", "@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Diğer IDE'ler 

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Doğrulama

  • Yapay zeka asistanınız TestSprite MCP araçlarını görebilmeli
  • "command not found" (komut bulunamadı) hatası almamalısınız
  • Şunu deneyin: "Bu projeyi TestSprite ile test etmeme yardım et."

İlk Testiniz

1. Adım: Projenizi Hazırlayın

Uygulamanızı başlatın:

# Ön yüz uygulamaları için
npm run dev          # Genellikle 3000, 5173 veya 8080 portunda çalışır

# Arka uç uygulamaları için
node index.js        # Genellikle 8000, 3001 veya 4000 portunda çalışır
Enter fullscreen mode Exit fullscreen mode

Örnek proje dizin yapısı:

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

2. Adım: Sihirli Komut

IDE Sohbet penceresini açın ve:

  1. Yeni bir sohbet penceresi başlatın
  2. Sihirli komutu yazın: 
Can you test this project with TestSprite?
Enter fullscreen mode Exit fullscreen mode
  1. İsterseniz proje klasörünüzü sohbete sürükleyip bırakabilirsiniz
  2. Shift+Enter tuşuna basın

Yapay zeka asistanınız tüm test sürecini sizin için yönetecek ve sizi adım adım yönlendirecektir.

3. Adım: Yapılandırma (Zorunlu)

Test yapılandırma sayfası tarayıcınızda açıldığında aşağıdakileri tamamlayın:

  1. Test Türü

    • Frontend modu: Kullanıcı arayüzü ve kullanıcı akışlarını test eder (butonlar, formlar, gezinme)
    • Backend modu: API'ları, servisleri, sunucu mantığını test eder
    • Kod tabanı kapsamı: Tüm projede tarama
    • Kod Farkı kapsamı: Sadece commitlenmemiş Git değişiklikleri (tekrarlayan testler için daha hızlı)

  2. Test Hesabı Bilgileri (Uygulamanız giriş gerektiriyorsa)

    • Ön yüz: Kullanıcı adı: test@example.com / Şifre: your-test-password
    • Arka uç: Basic / Bearer token / API-key / Kimlik doğrulama yok

  3. Uygulama URL'leri:

   Ön yüz: http://localhost:5173
   Arka uç: http://localhost:4000
Enter fullscreen mode Exit fullscreen mode
  1. Ürün Gereksinimleri Dokümanı (PRD): Mevcut PRD'nizi yükleyin (taslak bile olabilir). TestSprite AI, bundan normalize edilmiş bir PRD üretir.

4. Adım: Otomatik İş Akışı

TestSprite tüm test sürecini otomatik olarak yönetir:

  • Proje kodunuzu analiz eder
  • Kapsamlı bir test planı oluşturur
  • Testleri bulutta çalıştırır
  • Detaylı raporlar üretir
  • Başarısızlıklar için otomatik düzeltme önerileri sunar

5. Adım: Test Sonuçlarını İnceleyin

Testler tamamlandıktan sonra projenizde şu dosyaları bulacaksınız:

testsprite_tests/
├── tmp/
│   ├── prd_files/                 # Yüklenen PRD dosyaları
│   ├── config.json                # Test yapılandırması
│   ├── code_summary.json          # Kod analizi özeti
│   ├── report_prompt.json         # AI analiz verisi
│   └── test_results.json          # Detaylı test sonuçları
├── standard_prd.json              # Normalize PRD
├── TestSprite_MCP_Test_Report.md  # İnsan tarafından okunabilir rapor
├── TestSprite_MCP_Test_Report.html # HTML rapor
├── TC001_Login_Success_with_Valid_Credentials.py
├── TC002_Login_Failure_with_Invalid_Credentials.py
└── ...                            # Ek test dosyaları
Enter fullscreen mode Exit fullscreen mode

Test raporu şunları gösterir: genel kapsam, başarı oranı, başarısız testler ve hata analizleri ile kategoriler (Fonksiyonel, UI/UX, Güvenlik, Performans).

Örnek test planı:

{
  "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"
      ]
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

Örnek test raporu özeti:

{
  "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"
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

6. Adım: Otomatik Hata Düzeltmeleri

Sonuçları inceledikten sonra şunu yazabilirsiniz:

Please fix the codebase based on TestSprite testing results.
Enter fullscreen mode Exit fullscreen mode

Yapay zeka şunları yapacaktır:

  • Başarısız testleri analiz eder
  • Sorunlu kod bölümlerini tespit eder
  • Hedefe yönelik otomatik düzeltmeler uygular
  • Düzeltmeleri doğrulamak için testleri tekrar çalıştırır
  • Tüm sorunlar çözülene kadar iterasyon yapar

Başarı İçin İpuçları

  • Teste başlamadan önce ön yüz ve arka uç uygulamalarınızın çalışır ve erişilebilir olduğundan emin olun
  • Bir paragraf bile olsa, kısa bir PRD yeterlidir
  • Bireysel değişikliklerin hızlı doğrulaması için Kod Farkı kapsamını kullanın
  • TestSprite, uygulamanız kararlı ve çalışır durumdayken en iyi sonucu verir

TestSprite MCP ile projelerinizi hızlıca test etmeye başlayabilir, otomatik hata tespiti ve düzeltme süreçleriyle yazılım kalitenizi üst seviyeye taşıyabilirsiniz.

Top comments (0)