Currents

Currents MCP Sunucusu

Yapay zeka kodlama ajanlarınıza CI test sonuçlarınız üzerinde tam görünürlük kazandırın. Currents MCP Sunucusu, Cursor ve Claude gibi araçları doğrudan Currents panelinize bağlar; böylece ajanlar, editörünüzden ayrılmadan 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
• Karantina kurallarını, webhook'ları ve proje ayarlarını programatik olarak yönetin
• Ajanların, tahmin yürütmek yerine gerçek test çıktısını kullanarak bozuk olanı düzeltmesine izin verin

Araçlar

Araç	Açıklama
currents-list-actions	Bir proje için tüm eylemleri isteğe bağlı filtreleme ile listeler.
currents-create-action	Bir proje için yeni bir eylem oluşturur.
currents-get-action	Kimliğe göre tek bir eylemi alır.
currents-update-action	Mevcut bir eylemi günceller.
currents-delete-action	Bir eylemi siler (arşivler).
currents-enable-action	Devre dışı bırakılmış bir eylemi etkinleştirir.
currents-disable-action	Etkin bir eylemi devre dışı bırakır.
currents-list-affected-tests	Eylemlerden etkilenen testleri (karantina, atlama, etiket) bir proje için tarih aralığında listeler.
currents-get-affected-test-executions	Bir teste göre anahtarlanır: bir eylemin uygulandığı bir testin yürütmelerini, tarih aralığında, her birinin çalıştırması, dalı ve commit'i ile birlikte listeler.
currents-get-action-executions	Bir eyleme göre anahtarlanır: bir kuralın uygulandığı test yürütmelerini, dokunduğu her testte, tarih aralığında listeler.
currents-get-projects	Currents platformunda bulunan projeleri alır.
currents-get-project	Kimliğe göre tek bir projeyi alır.
currents-get-project-insights	Bir proje için tarih aralığında toplu çalıştırma ve test metriklerini alır.
currents-list-pull-requests	Bir proje için çekme isteği kartlarını listeler (çalıştırmalar meta.pr.id'ye göre gruplanır).
currents-list-project-terms	Bir tür için imleçle sayfalanan proje terimlerini listeler (etiket, dal, yazarAdı, vb.).
currents-create-jira-issue	Kuruluş Jira entegrasyonunu kullanarak bir çalıştırma testinden bir Jira sorunu oluşturur.
currents-link-jira-issue	Kuruluş Jira entegrasyonunu kullanarak mevcut bir Jira sorununu bir çalıştırma testine bağlar.
currents-list-jira-projects	Kuruluş entegrasyonu için kullanılabilir Jira projelerini listeler.
currents-list-jira-issue-types	Bir Jira projesi için Jira sorun türlerini ve özel alanları listeler.
currents-get-runs	Belirli bir proje için isteğe bağlı filtreleme ile çalıştırma listesini alır.
currents-get-run-details	Belirli bir test çalıştırmasının ayrıntılarını alır.
currents-find-run	Sorgu parametrelerine göre bir çalıştırma bulur.
currents-cancel-run	Devam eden bir çalıştırmayı iptal eder.
currents-reset-run	Yeniden yürütmeye izin vermek için bir çalıştırmadaki başarısız spec dosyalarını sıfırlar.
currents-delete-run	Bir çalıştırmayı ve ilişkili tüm verileri siler.
currents-cancel-run-github-ci	GitHub Actions iş akışı çalıştırma kimliği ve deneme numarasına göre bir çalıştırmayı iptal eder.
currents-get-spec-instance	instanceId ile bir test spec dosyasının belirli bir yürütmesinden hata ayıklama verilerini alır.
currents-get-spec-files-performance	Belirli bir proje için tarih aralığında spec dosyaları performans metriklerini alır.
currents-get-tests-performance	Belirli bir proje için tarih aralığında toplu test metriklerini alır.
currents-get-tests-signatures	Proje, spec dosya yolu ve test başlığına dayalı benzersiz bir test imzası oluşturur.
currents-get-test-results	Belirli bir test imzası için geçmiş test yürütme sonuçlarını alır.
currents-get-context	CI'da başarısız olan testleri düzeltmek için kullanın: bir çalıştırmanın, bir spec dosyasının (örnek) veya tek bir testin başarısız testlerinin hatalarını, adımlarını ve dosyalarını döndürür — Currents panosundaki Fix ile aynı içerik.
currents-get-errors-explorer	Bir tarih aralığında bir proje için toplu hata metriklerini alır.
currents-get-test-evidence	Bir CI çalıştırmasındaki testlerin ürettiği kanıt yapılarını (ekran görüntüleri, videolar, izlemeler, ekler) toplar; test başına gruplandırılmış imzalı indirme URL'leriyle birlikte.
currents-create-evidence-links	Bir test denemesinin kanıtlarına, Playwright izlemesinden sunulan ve üzerindeki URL'lere paylaşılabilir bir bağlantı oluşturur: denemenin ne yaptığının ve neyin başarısız olduğunun bir markdown özeti, bir film şeridi, animasyonlu bir ekran kaydı, DOM anlık görüntüleri, ağ istekleri ve ekler.
currents-create-session	Sürdüğünüz bir tarayıcı oturumunu bir Currents çalıştırması olarak kaydeder; böylece kanıtları bir CI çalıştırması gibi okunabilir ve paylaşılabilir.
currents-list-webhooks	Bir proje için tüm webhook'ları listeler.
currents-create-share-link	Oturum açmadan herkesin açabileceği, süresi dolana kadar geçerli olan test sonuçlarına genel bir bağlantı oluşturur. "fix" amacı, testleri düzeltecek bir ajan için başarısızlık bağlamıdır — currents-get-context ile aynı içerik, flaky testler dahil ve flaky olarak işaretlenmiş. "report" amacı, bir kişi için her testi denemeleri ve dosyalarıyla birlikte listeler.
currents-create-webhook	Bir proje için yeni bir webhook oluşturur.
currents-get-webhook	Kimliğe göre tek bir webhook alır.
currents-update-webhook	Mevcut bir webhook'u günceller.
currents-delete-webhook	Bir webhook'u siler.

Beceriler

Yapay zeka ajanlarına çok adımlı Currents iş akışlarını öğreten ajan becerileri.

Beceri	Açıklama
browser-evidence	Deneysel.
collect-evidence	Uyguladığınız işin gerçekten çalıştığını gösterin veya tanıtın; Currents üzerinden CI'da çalışan testlerden — yorum içinde okunan özet, film şeridi ve erişilebilirlik anlık görüntüleri ile birlikte ekran görüntüleri, ekler ve videolar içeren bir iz bağlantısı.
fix-failing-tests	CI'da başarısız olan testleri, Currents'ın kaydettiği sonuçları kullanarak düzeltin — hatalar, adımlar, izler, ekran görüntüleri ve konsol çıktısı.

Sunucu her beceriyi bir MCP kaynağı olarak yayınlar; böylece bağlı bir ajan, 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 ajanların yine de bir kopyaya ihtiyacı vardır — beceri dizinini ajanın beceri konumuna koyun (ör. Claude Code için .claude/skills/).

Kurulum

API Anahtarı

Buradaki talimatları izleyerek bir Currents API anahtarı edinin.

Cursor ile Kullanım

1. Cursor Ayarları > MCP > Etkinleştir bölümüne gidin
2. mcp.json dosyanıza aşağıdakini 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 başına hiçbir kimlik doğrulaması 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 konuşur; 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 ajanlarını veya hizmetlerini denetlemek ve verilerinizi güvenli bir şekilde işlemelerini sağlamak sizin sorumluluğunuzdadır.

Referanslar

• Currents
• Currents Dokümantasyonu
• Katkı Rehberi
• Yayınlama ve Dağıtım
• Lisans