Currents
resmiAI 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-runsvecurrents-get-test-resultsile 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-contextile alın. - Collect test evidence — CI çalıştırmalarından ekran görüntüleri, videolar, izlemeler ve ekleri
currents-get-test-evidenceile toplayın. - Manage quarantine and actions — Karantina kuralları gibi eylemleri
currents-list-actionsvecurrents-create-actionile listeleyin, oluşturun, güncelleyin veya devre dışı bırakın. - Manage webhooks — Proje webhook'larını
currents-list-webhooksvecurrents-create-webhookile listeleyin, oluşturun, güncelleyin veya silin.
Dokümantasyon
Currents MCP Server
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
Araçlar
| Araç | Açıklama |
|---|---|
currents-list-actions | Bir proje için tüm eylemleri isteğe bağlı filtrelemeyle 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 | Bir proje için belirli bir tarih aralığında eylemlerden (karantina, atlama, etiket) etkilenen testleri listeler. |
currents-get-affected-test-executions | Belirli bir tarih aralığında, etkilenen belirli bir testin (imzaya göre) yürütme ayrıntılarını alır. |
currents-get-affected-executions | Belirli bir tarih aralığında belirli bir eylemin/kuralın uygulandığı test yürütmelerini 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 belirli bir tarih aralığında toplu çalıştırma ve test metriklerini alır. |
currents-list-pull-requests | Bir proje için pull-request kartlarını listeler (meta.pr.id'ye göre gruplanmış çalıştırmalar). |
currents-list-project-terms | Bir tür için (etiket, dal, yazarAdı vb.) imleç sayfalı proje terimlerini listeler. |
currents-create-jira-issue | Kuruluş Jira entegrasyonunu kullanarak bir çalıştırma testinden 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ı filtrelemeyle ç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 belirli bir tarih aralığında spec dosyası performans metriklerini alır. |
currents-get-tests-performance | Belirli bir proje için belirli bir 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 | Çalıştırma, örnek veya test düzeyinde AI hata ayıklaması için test hatası bağlamını alır. |
currents-get-errors-explorer | Bir proje için belirli bir tarih aralığında toplu hata metriklerini alır. |
currents-get-test-evidence | Bir 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-webhooks | Bir proje için tüm webhook'ları listeler. |
currents-create-webhook | Bir proje için yeni bir webhook oluşturur. |
currents-get-webhook | Kimliğe göre tek bir webhook'u alır. |
currents-update-webhook | Mevcut bir webhook'u günceller. |
currents-delete-webhook | Bir webhook'u siler. |
Beceriler
AI aracılarına çok adımlı Currents iş akışlarını öğreten aracı becerileri.
| Beceri | Açıklama |
|---|---|
collect-evidence | Uygulanan 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
- Cursor Ayarları > MCP > Etkinleştir 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
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.