Currents

resmi

AI Ajanlarının, Currents'a bildirilen Playwright test hatalarını düzeltmesini sağlayın.

Currents MCP ile neler yapabilirsiniz?

  • Query runs and test results — Son CI çalıştırmalarını veya geçmiş sonuçları currents-get-runs ve currents-get-test-results ile sorun.
  • Diagnose failures with context — Çalıştırma, örnek veya test düzeyinde AI hata ayıklama için hata bağlamını currents-get-context ile alın.
  • Collect test evidence — CI çalıştırmalarından ekran görüntüleri, videolar, izlemeler ve ekleri currents-get-test-evidence ile toplayın.
  • Manage quarantine and actions — Karantina kuralları gibi eylemleri currents-list-actions ve currents-create-action ile listeleyin, oluşturun, güncelleyin veya devre dışı bırakın.
  • Manage webhooks — Proje webhook'larını currents-list-webhooks ve currents-create-webhook ile listeleyin, oluşturun, güncelleyin veya silin.

Dokümantasyon

Currents MCP Server

Unit Tests

AI kodlama aracılarınıza CI test sonuçlarınız üzerinde tam görünürlük sağlayın. Currents MCP Sunucusu, Cursor ve Claude gibi araçları doğrudan Currents panelinize bağlar; böylece aracılar, editörünüzden ayrılmadan kararsız (flaky) testleri teşhis edebilir, hataları tespit edebilir ve gerçek yürütme verilerine dayanarak harekete geçebilir.

  • CI'dan çalıştırmaları, spec dosyalarını ve bireysel test sonuçlarını sorgulayın
  • Test paketiniz genelinde hata eğilimlerini ve performans metriklerini görünür kılın
  • Karantina kurallarını, webhook'ları ve proje ayarlarını programatik olarak yönetin
  • Aracıların tahmin yürütmek yerine gerçek test çıktısını kullanarak bozuk olanı düzeltmesine izin verin

Install MCP Server

Araçlar

AraçAçıklama
currents-list-actionsBir proje için tüm eylemleri isteğe bağlı filtrelemeyle listeler.
currents-create-actionBir proje için yeni bir eylem oluşturur.
currents-get-actionKimliğe göre tek bir eylemi alır.
currents-update-actionMevcut bir eylemi günceller.
currents-delete-actionBir eylemi siler (arşivler).
currents-enable-actionDevre dışı bırakılmış bir eylemi etkinleştirir.
currents-disable-actionEtkin bir eylemi devre dışı bırakır.
currents-list-affected-testsBir proje için belirli bir tarih aralığında eylemlerden (karantina, atlama, etiket) etkilenen testleri listeler.
currents-get-affected-test-executionsBelirli bir tarih aralığında, etkilenen belirli bir testin (imzaya göre) yürütme ayrıntılarını alır.
currents-get-affected-executionsBelirli bir tarih aralığında belirli bir eylemin/kuralın uygulandığı test yürütmelerini listeler.
currents-get-projectsCurrents platformunda bulunan projeleri alır.
currents-get-projectKimliğe göre tek bir projeyi alır.
currents-get-project-insightsBir proje için belirli bir tarih aralığında toplu çalıştırma ve test metriklerini alır.
currents-list-pull-requestsBir proje için pull-request kartlarını listeler (meta.pr.id'ye göre gruplanmış çalıştırmalar).
currents-list-project-termsBir tür için (etiket, dal, yazarAdı vb.) imleç sayfalı proje terimlerini listeler.
currents-create-jira-issueKuruluş Jira entegrasyonunu kullanarak bir çalıştırma testinden Jira sorunu oluşturur.
currents-link-jira-issueKuruluş Jira entegrasyonunu kullanarak mevcut bir Jira sorununu bir çalıştırma testine bağlar.
currents-list-jira-projectsKuruluş entegrasyonu için kullanılabilir Jira projelerini listeler.
currents-list-jira-issue-typesBir Jira projesi için Jira sorun türlerini ve özel alanları listeler.
currents-get-runsBelirli bir proje için isteğe bağlı filtrelemeyle çalıştırma listesini alır.
currents-get-run-detailsBelirli bir test çalıştırmasının ayrıntılarını alır.
currents-find-runSorgu parametrelerine göre bir çalıştırma bulur.
currents-cancel-runDevam eden bir çalıştırmayı iptal eder.
currents-reset-runYeniden yürütmeye izin vermek için bir çalıştırmadaki başarısız spec dosyalarını sıfırlar.
currents-delete-runBir çalıştırmayı ve ilişkili tüm verileri siler.
currents-cancel-run-github-ciGitHub Actions iş akışı çalıştırma kimliği ve deneme numarasına göre bir çalıştırmayı iptal eder.
currents-get-spec-instanceinstanceId ile bir test spec dosyasının belirli bir yürütmesinden hata ayıklama verilerini alır.
currents-get-spec-files-performanceBelirli bir proje için belirli bir tarih aralığında spec dosyası performans metriklerini alır.
currents-get-tests-performanceBelirli bir proje için belirli bir tarih aralığında toplu test metriklerini alır.
currents-get-tests-signaturesProje, spec dosya yolu ve test başlığına dayalı benzersiz bir test imzası oluşturur.
currents-get-test-resultsBelirli bir test imzası için geçmiş test yürütme sonuçlarını alır.
currents-get-contextÇalıştırma, örnek veya test düzeyinde AI hata ayıklaması için test hatası bağlamını alır.
currents-get-errors-explorerBir proje için belirli bir tarih aralığında toplu hata metriklerini alır.
currents-get-test-evidenceBir CI çalıştırmasında testler tarafından üretilen kanıt yapılarını (ekran görüntüleri, videolar, izler, ekler) test başına gruplanmış imzalı indirme URL'leriyle toplar.
currents-list-webhooksBir proje için tüm webhook'ları listeler.
currents-create-webhookBir proje için yeni bir webhook oluşturur.
currents-get-webhookKimliğe göre tek bir webhook'u alır.
currents-update-webhookMevcut bir webhook'u günceller.
currents-delete-webhookBir webhook'u siler.

Beceriler

AI aracılarına çok adımlı Currents iş akışlarını öğreten aracı becerileri.

BeceriAçıklama
collect-evidenceUygulanan işin çalıştığını gösterin veya CI test yapılarını kullanarak tanıtın — önce/sonra ekran görüntüleri, metin ekleri, videolar, izler.

Sunucu her beceriyi bir MCP kaynağı olarak yayınlar; böylece bağlı bir aracı, yerel bir kopya olmadan bunları listeleyebilir ve okuyabilir:

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

Becerileri yalnızca diskten yükleyen aracıların yine de bir kopyaya ihtiyacı vardır — beceri dizinini aracının beceri konumuna yerleştirin (ör. Claude Code için .claude/skills/).

Kurulum

API Anahtarı

Currents API anahtarını buradaki talimatları izleyerek edinin.

Cursor ile Kullanım

  1. Cursor Ayarları > MCP > Etkinleştir bölümüne gidin
  2. Aşağıdakini mcp.json dosyanıza ekleyin.
{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Currents MCP'yi Claude Code'a eklemek için bu komutu çalıştırın

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

Claude Desktop'ta Currents MCP'yi etkinleştirmek için aşağıdakini ekleyin (claude_desktop_config.json dosyasını düzenleyin):

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Uzak (barındırılan) MCP uç noktası

Yukarıdaki yerel stdio aktarımına ek olarak, aynı sunucu, Claude web/mobil uygulamaları gibi uzak bağlayıcılarla kullanım için barındırılan bir Streamable HTTP uç noktası (ör. https://mcp.currents.dev/mcp) olarak çalıştırılabilir.

Barındırılan sunucu kendi kimlik doğrulamasını yapmaz. Her istek, Currents API'sine iletilen Currents API anahtarınızı bir Bearer belirteci olarak taşımalıdır:

Authorization: Bearer <your-currents-api-key>

Örnek istemci yapılandırması (uzak bağlayıcı):

{
  "mcpServers": {
    "currents": {
      "url": "https://mcp.currents.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

HTTP sunucusunu kendiniz çalıştırma:

# from the mcp-server package
npm run build && PORT=3000 npm run start:http
# or via Docker (serves /mcp, exposes the configured PORT)
docker build -t currents-mcp . && docker run -p 3000:3000 currents-mcp

Node sunucusu düz HTTP kullanır; TLS ve genel alan adı, kapsayıcının önündeki ters proxy / yük dengeleyicide sonlandırılır. Canlılık kontrolleri için bir GET /healthz uç noktası sağlanır.

⚠️ Bildirim

AI araçlarını (ör. MCP aracılığıyla) Currents'a bağlayarak, onlara API anahtarınıza, test sonuçlarınıza ve CI meta verilerinize erişim izni vermiş olursunuz. Kullandığınız AI aracılarını veya hizmetlerini denetlemek ve verilerinizi güvenli bir şekilde işlediklerinden emin olmak sizin sorumluluğunuzdadır.

Referanslar