Currents

resmi

AI 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-context ile 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

Unit Tests

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

Install MCP Server

Araçlar

AraçAçıklama
currents-list-actionsİsteğe bağlı filtreleme ile bir projedeki tüm eylemleri listeler.
currents-create-actionBir proje için yeni bir eylem oluşturur.
currents-get-actionKimliğe göre tek bir eylemi getirir.
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 tarih aralığında, bir proje için eylemlerden (karantinaya alma, atlama, etiketleme) etkilenen testleri listeler.
currents-get-affected-test-executionsBir 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-executionsBir eylem temelinde, bir tarih aralığında, bir kuralın dokunduğu tüm testlerde uygulandığı test yürütmelerini listeler.
currents-get-projectsCurrents platformunda kullanılabilen projeleri getirir.
currents-get-projectKimliğe göre tek bir projeyi getirir.
currents-get-project-insightsBir tarih aralığında bir proje için toplu çalıştırma ve test ölçümlerini getirir.
currents-list-pull-requestsBir 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-termsTek bir tür için imleçle sayfalandırılmış proje terimlerini listeler (tag, branch, authorName vb.).
currents-create-jira-issueKuruluşun Jira entegrasyonunu kullanarak bir çalıştırma testinden Jira sorunu oluşturur.
currents-link-jira-issueKuruluşun Jira entegrasyonunu kullanarak mevcut bir Jira sorununu bir çalıştırma testine bağlar.
currents-list-jira-projectsKuruluş entegrasyonunda kullanılabilen Jira projelerini listeler.
currents-list-jira-issue-typesBir 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-detailsBir ç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-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 belirtim dosyalarını sıfırlar.
currents-delete-runBir çalıştırmayı ve ilişkili tüm verileri siler.
currents-cancel-run-github-ciBir GitHub Actions iş akışı çalıştırma kimliği ve deneme numarasıyla bir çalıştırmayı iptal eder.
currents-get-spec-instanceinstanceId 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-performanceBelirli bir proje için tarih aralığındaki spec dosyası performans ölçümlerini alır.
currents-get-tests-performanceBelirli bir proje için tarih aralığındaki toplu test ölçümlerini alır.
currents-get-tests-signaturesProje, spec dosyası yolu ve test başlığına göre benzersiz bir test imzası oluşturur.
currents-get-test-resultsBelirli bir test imzasının geçmiş test yürütme sonuçlarını alır.
currents-get-contextCI'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-explorerBir proje için tarih aralığındaki toplu hata ölçümlerini alır.
currents-get-test-evidenceBir 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-linksBir 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-sessionYönettiğiniz bir tarayıcı oturumunu Currents oturumu olarak kaydeder; böylece kanıtları okunabilir ve paylaşılabilir.
currents-add-attachmentscurrents-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-webhooksBir projedeki tüm web kancalarını listeler.
currents-create-share-linkHerkesin 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-webhookBir proje için yeni bir web kancası oluşturur.
currents-get-webhookKimliğine göre tek bir web kancasını alır.
currents-update-webhookMevcut bir web kancasını günceller.
currents-delete-webhookBir web kancasını siler.

Beceriler

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

BeceriAçıklama
browser-evidenceDeneysel: Ç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-evidenceUyguladığı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-testsCurrents'ı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

  1. Cursor Settings > MCP > Enable 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

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-mcp dosyası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.

Referanslar