Currents
resmiAI Ajanlarının, Currents'a bildirilen Playwright test hatalarını düzeltmesini sağlayın.
Currents MCP ile neler yapabilirsiniz?
- CI hatalarını teşhis edin — Başarısız testlerin arkasındaki hataları, adımları ve dosyaları bir çalıştırma, spec dosyası veya tek bir test için
currents-get-contextile alın. - Çalıştırmaları ve sonuçları inceleyin — Proje çalıştırmalarını listeleyip filtreleyin; ardından çalıştırma ayrıntılarını, spec örneği sonuçlarını ve imzaya göre geçmiş test sonuçlarını alın.
- Kararsız ve yavaş testleri bulun — Bir tarih aralığındaki test ve spec dosyası performans ölçümlerini ve toplu hata eğilimlerini sorgulayın.
- Karantina işlemlerini yönetin — İşlemler oluşturun, etkinleştirin, devre dışı bırakın veya silin; ayrıca bunların etkilediği testleri ve yürütmeleri listeleyin.
- Test kanıtlarını toplayın — CI çalıştırmalarından ekran görüntülerini, videoları, izleri ve ekleri toplayın veya paylaşılabilir iz bağlantıları oluşturun.
- Webhook'ları ve Jira'yı yönetin — Proje webhook'larını listeleyin, oluşturun, güncelleyin veya silin; ayrıca çalıştırma testlerinden Jira sorunları oluşturun ya da bunları ilişkilendirin.
Dokümantasyon
Currents MCP Server
Yapay zekâ kodlama ajanlarınıza CI test sonuçlarınız hakkında tam görünürlük sağlayın. Currents MCP Server, Cursor ve Claude gibi araçları doğrudan Currents panonuza bağlayarak ajanların kararsız testleri teşhis etmesini, hataları belirlemesini ve gerçek yürütme verileriyle işlem yapmasını sağlar -- üstelik düzenleyicinizden ayrılmadan.
- CI'dan çalıştırmaları, spec dosyalarını ve tek tek test sonuçlarını sorgulayın
- Test paketiniz genelindeki hata eğilimlerini ve performans ölçümlerini görünür kılın
- Karantina kurallarını, web kancalarını ve proje ayarlarını programatik olarak yönetin
- Ajanların tahminlere değil, gerçek test çıktılarına dayanarak sorunları düzeltmesini sağlayın
Araçlar
| Araç | Açıklama |
|---|---|
currents-list-actions | İsteğe bağlı filtreleme ile bir projedeki tüm eylemleri listeler. |
currents-create-action | Bir proje için yeni bir eylem oluşturur. |
currents-get-action | Kimliğe göre tek bir eylemi getirir. |
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 | Bir tarih aralığında, bir proje için eylemlerden (karantinaya alma, atlama, etiketleme) etkilenen testleri listeler. |
currents-get-affected-test-executions | Bir test temelinde, bir tarih aralığında, bir eylemin uygulandığı tek bir testin yürütmelerini; her birinin çalıştırma, dal ve commit bilgileriyle listeler. |
currents-get-action-executions | Bir eylem temelinde, bir tarih aralığında, bir kuralın dokunduğu tüm testlerde uygulandığı test yürütmelerini listeler. |
currents-get-projects | Currents platformunda kullanılabilen projeleri getirir. |
currents-get-project | Kimliğe göre tek bir projeyi getirir. |
currents-get-project-insights | Bir tarih aralığında bir proje için toplu çalıştırma ve test ölçümlerini getirir. |
currents-list-pull-requests | Bir proje için çekme isteği kartlarını listeler (çalıştırmalar meta.pr.id değerine göre gruplandırılır). |
currents-list-project-terms | Tek bir tür için imleçle sayfalandırılmış proje terimlerini listeler (tag, branch, authorName vb.). |
currents-create-jira-issue | Kuruluşun Jira entegrasyonunu kullanarak bir çalıştırma testinden Jira sorunu oluşturur. |
currents-link-jira-issue | Kuruluşun Jira entegrasyonunu kullanarak mevcut bir Jira sorununu bir çalıştırma testine bağlar. |
currents-list-jira-projects | Kuruluş entegrasyonunda kullanılabilen Jira projelerini listeler. |
currents-list-jira-issue-types | Bir Jira projesinin Jira sorun türlerini ve özel alanlarını listeler. |
currents-get-runs | İsteğe bağlı filtreleme ile belirli bir projedeki çalıştırmaların listesini getirir. |
currents-get-run-details | Bir çalıştırmayı getirir: durumunu, commit'ini, dalını, gruplarını ve belirtim dosyalarını; her birinin instanceId değerini ve çalıştırmanın düzey, tür ve kaynağa (attachmentCounts) göre kaç dosyası olduğunu. |
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 belirtim dosyalarını sıfırlar. |
currents-delete-run | Bir çalıştırmayı ve ilişkili tüm verileri siler. |
currents-cancel-run-github-ci | Bir GitHub Actions iş akışı çalıştırma kimliği ve deneme numarasıyla bir çalıştırmayı iptal eder. |
currents-get-spec-instance | instanceId ile bir spec dosyası yürütmesinin ham sonucunu alır: her testin durumunu ve denemelerini, ayrıca yapıt URL'lerini. |
currents-get-spec-files-performance | Belirli bir proje için tarih aralığındaki spec dosyası performans ölçümlerini alır. |
currents-get-tests-performance | Belirli bir proje için tarih aralığındaki toplu test ölçümlerini alır. |
currents-get-tests-signatures | Proje, spec dosyası yolu ve test başlığına göre benzersiz bir test imzası oluşturur. |
currents-get-test-results | Belirli bir test imzasının geçmiş test yürütme sonuçlarını alır. |
currents-get-context | CI'da testlerin neden başarısız olduğunu öğrenmek veya bunları düzeltmek için önce bunu çağırın: bir çalıştırmadaki, spec dosyasındaki (instance) veya tek bir testteki başarısız testlerin hatalarını, adımlarını ve dosyalarını döndürür — Currents panosundaki Fix ile aynı içerik. |
currents-get-errors-explorer | Bir proje için tarih aralığındaki toplu hata ölçümlerini alır. |
currents-get-test-evidence | Bir CI çalıştırmasındaki testlerin oluşturduğu kanıt yapıtlarını (ekran görüntüleri, videolar, izler, ekler) toplar ve testlere göre gruplandırılmış imzalı indirme URL'leri sunar. |
currents-create-evidence-links | Bir test denemesinin kanıtlarına yönelik, Playwright izinden sunulan ve şu URL'leri içeren paylaşılabilir bir iz API bağlantısı oluşturur: denemenin ne yaptığını ve neyin başarısız olduğunu açıklayan bir Markdown iz özeti (digest URL'si), film şeridi, animasyonlu ekran kaydı, DOM anlık görüntüleri, ağ istekleri ve ekler. |
currents-create-session | Yönettiğiniz bir tarayıcı oturumunu Currents oturumu olarak kaydeder; böylece kanıtları okunabilir ve paylaşılabilir. |
currents-add-attachments | currents-create-session ile oluşturulan bir oturuma (sessionId gönderin) veya bir CI çalıştırmasına (runId gönderin) ekler ekler: bir spec dosyasının, testin veya çalıştırmanın kendisinin günlükleri. |
currents-list-webhooks | Bir projedeki tüm web kancalarını listeler. |
currents-create-share-link | Herkesin oturum açmadan, bağlantının süresi dolana kadar açabileceği test sonuçlarına yönelik herkese açık bir bağlantı oluşturur. "fix" amacı, testleri düzeltecek bir aracı için başarısızlık bağlamını sunar — Currents panosundaki currents-get-context ile aynı içerik; kararsız testler de dahil edilir ve kararsız olarak işaretlenir. "report" amacı, bir kişi için her testi denemeleri ve dosyalarıyla listeler; oturumlar için oturum sayfasını sunar: durum, hata, ekler ve iz. |
currents-create-webhook | Bir proje için yeni bir web kancası oluşturur. |
currents-get-webhook | Kimliğine göre tek bir web kancasını alır. |
currents-update-webhook | Mevcut bir web kancasını günceller. |
currents-delete-webhook | Bir web kancasını siler. |
Beceriler
Yapay zekâ ajanlarına çok adımlı Currents iş akışlarını öğreten ajan becerileri.
| Beceri | Açıklama |
|---|---|
browser-evidence | Deneysel: Çalıştırılacak bir test olmadığında, kendi kullandığınız bir tarayıcıda değişikliğin işe yaradığını kanıtlayın. |
collect-evidence | Uyguladığınız çalışmanın gerçekten işe yaradığını gösterin veya demosunu yapın. Bunun için Currents aracılığıyla CI'da çalıştırılan testlerden yararlanın — iz özeti, film şeridi ve erişilebilirlik anlık görüntülerinin bir yorum içinde görüntülendiği bir iz API bağlantısının yanı sıra ekran görüntüleri, ekler ve videolar. |
fix-failing-tests | Currents'ın kaydettiği sonuçları — hataları, adımları, izleri, ekran görüntülerini ve konsol çıktısını — kullanarak CI'da başarısız olan testleri düzeltin. |
Sunucu, her beceriyi bir MCP kaynağı olarak yayımlar; böylece bağlı bir ajan bunları yerel bir kopyaya ihtiyaç duymadan listeleyip 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 yerleştirin (ör. Claude
Code için .claude/skills/).
Kurulum
API Anahtarı
Buradaki talimatları izleyerek bir Currents API anahtarı alın.
Cursor ile Kullanım
- Cursor Settings > MCP > Enable bölümüne gidin
- Aşağıdakini
mcp.jsondosyanı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
Currents MCP'yi Claude Desktop'ta 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"
}
}
}
}
VS Code ve GitHub Copilot
VS Code'a yükle, barındırılan sunucuyu ekler. VS Code ilk bağlantı kurduğunda bir Currents oturum açma sayfası açar; girmeniz gereken bir API anahtarı yoktur.
Sunucunun yanı sıra becerileri de ekleyen eklentiyi yüklemek için:
-
VS Code:
vscode://chat-plugin/install?source=currents-dev/currents-mcpdosyasını açın -
Copilot CLI:
copilot plugin marketplace add currents-dev/currents-mcp copilot plugin install currents@currents
Copilot CLI'ye yalnızca sunucuyu eklemek için:
copilot mcp add --transport http currents https://mcp.currents.dev/mcp
Uzak (barındırılan) MCP uç noktası
Yukarıdaki yerel stdio aktarımına ek olarak, aynı sunucu uzak
bağlayıcılarla (ör. https://mcp.currents.dev/mcp) kullanılmak üzere barındırılan bir
Streamable HTTP uç noktası olarak çalışabilir; Claude web/mobil uygulamaları da buna dahildir.
Barındırılan sunucu kendi başına kimlik doğrulaması yapmaz. Her istek, Currents API'ye iletilen bir Bearer token olarak Currents API anahtarınızı 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.
⚠️ Uyarı
Yapay zekâ 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 yapay zekâ ajanlarını veya hizmetlerini incelemek ve verilerinizi güvenli biçimde işlemelerini sağlamak sizin sorumluluğunuzdadır.