Currents

resmi

Memungkinkan Agen AI untuk memperbaiki kegagalan tes Playwright yang dilaporkan ke Currents.

Apa yang bisa Anda lakukan dengan Currents MCP?

  • Diagnosis kegagalan CI — Tarik error, langkah, dan file di balik pengujian yang gagal dalam suatu run, file spec, atau pengujian tunggal dengan currents-get-context.
  • Periksa run dan hasil — Daftar dan filter run proyek, lalu ambil detail run, hasil instance spec, dan hasil pengujian historis berdasarkan signature.
  • Temukan pengujian flaky dan lambat — Kueri metrik performa pengujian dan file spec serta tren error teragregasi dalam rentang tanggal.
  • Kelola tindakan karantina — Buat, aktifkan, nonaktifkan, atau hapus tindakan dan daftar pengujian serta eksekusi yang terdampak.
  • Kumpulkan bukti pengujian — Kumpulkan screenshot, video, trace, dan lampiran dari run CI, atau buat tautan trace yang dapat dibagikan.
  • Kelola webhook dan Jira — Daftar, buat, perbarui, atau hapus webhook proyek dan buat atau tautkan issue Jira dari pengujian run.

Dokumentasi

Currents MCP Server

Unit Tests

Berikan agen coding AI Anda visibilitas penuh atas hasil pengujian CI Anda. Currents MCP Server menghubungkan alat seperti Cursor dan Claude langsung ke dasbor Currents Anda, sehingga agen dapat mendiagnosis pengujian yang flaky, menemukan titik kegagalan, dan bertindak berdasarkan data eksekusi nyata -- tanpa meninggalkan editor Anda.

  • Kueri run, file spec, dan hasil pengujian individual dari CI
  • Tampilkan tren error dan metrik performa di seluruh test suite Anda
  • Kelola aturan karantina, webhook, dan pengaturan proyek secara terprogram
  • Biarkan agen memperbaiki apa yang rusak menggunakan output pengujian yang sebenarnya, bukan tebakan

Install MCP Server

Alat

AlatDeskripsi
currents-list-actionsMenampilkan daftar semua aksi untuk sebuah proyek dengan penyaringan opsional.
currents-create-actionMembuat aksi baru untuk sebuah proyek.
currents-get-actionMengambil satu aksi berdasarkan ID.
currents-update-actionMemperbarui aksi yang sudah ada.
currents-delete-actionMenghapus (mengarsipkan) sebuah aksi.
currents-enable-actionMengaktifkan aksi yang dinonaktifkan.
currents-disable-actionMenonaktifkan aksi yang aktif.
currents-list-affected-testsMenampilkan daftar pengujian yang terdampak oleh aksi (karantina, lewati, tag) untuk sebuah proyek dalam rentang tanggal tertentu.
currents-get-affected-test-executionsBerdasarkan pengujian: menampilkan daftar eksekusi satu pengujian yang dikenai aksi, dalam rentang tanggal tertentu, beserta run, branch, dan commit masing-masing.
currents-get-action-executionsBerdasarkan aksi: menampilkan daftar eksekusi pengujian yang dikenai satu aturan, di seluruh pengujian yang tersentuh, dalam rentang tanggal tertentu.
currents-get-projectsMengambil proyek yang tersedia di platform Currents.
currents-get-projectMengambil satu proyek berdasarkan ID.
currents-get-project-insightsMengambil metrik agregat run dan pengujian untuk sebuah proyek dalam rentang tanggal tertentu.
currents-list-pull-requestsMenampilkan daftar kartu pull-request untuk sebuah proyek (run dikelompokkan berdasarkan meta.pr.id).
currents-list-project-termsMenampilkan daftar istilah proyek dengan paginasi kursor untuk satu tipe (tag, branch, authorName, dll.).
currents-create-jira-issueMembuat issue Jira dari pengujian run menggunakan integrasi Jira organisasi.
currents-link-jira-issueMenautkan issue Jira yang sudah ada ke pengujian run menggunakan integrasi Jira organisasi.
currents-list-jira-projectsMenampilkan daftar proyek Jira yang tersedia untuk integrasi organisasi.
currents-list-jira-issue-typesMenampilkan daftar tipe issue Jira dan field kustom untuk sebuah proyek Jira.
currents-get-runsMengambil daftar run untuk proyek tertentu dengan penyaringan opsional.
currents-get-run-detailsMengambil sebuah run: status, commit, branch, grup, dan file spec-nya, masing-masing dengan instanceId-nya, serta berapa banyak file yang dimiliki run berdasarkan level, tipe, dan sumber (attachmentCounts).
currents-find-runMenemukan run berdasarkan parameter kueri.
currents-cancel-runMembatalkan run yang sedang berlangsung.
currents-reset-runMengatur ulang file spec yang gagal dalam sebuah run agar dapat dieksekusi ulang.
currents-delete-runHapus sebuah run beserta semua data terkait.
currents-cancel-run-github-ciBatalkan sebuah run berdasarkan ID workflow run GitHub Actions dan nomor percobaan.
currents-get-spec-instanceMengambil hasil mentah dari eksekusi satu file spec berdasarkan instanceId: status dan percobaan setiap test, serta URL artefak.
currents-get-spec-files-performanceMengambil metrik performa file spec untuk proyek tertentu dalam rentang tanggal tertentu.
currents-get-tests-performanceMengambil metrik test teragregasi untuk proyek tertentu dalam rentang tanggal tertentu.
currents-get-tests-signaturesMenghasilkan signature test unik berdasarkan proyek, path file spec, dan judul test.
currents-get-test-resultsMengambil riwayat hasil eksekusi test untuk signature test tertentu.
currents-get-contextPanggil ini terlebih dahulu untuk mengetahui mengapa test gagal di CI, atau untuk memperbaikinya: mengembalikan error, langkah, dan file dari test yang gagal pada sebuah run, sebuah file spec (instance), atau satu test — konten yang sama dengan Fix di dasbor Currents.
currents-get-errors-explorerDapatkan metrik error teragregasi untuk sebuah proyek dalam rentang tanggal tertentu.
currents-get-test-evidenceKumpulkan artefak bukti (screenshot, video, trace, lampiran) yang dihasilkan oleh test dalam sebuah run CI, dengan URL unduhan bertanda tangan yang dikelompokkan per test.
currents-create-evidence-linksBuat tautan API trace yang dapat dibagikan ke bukti sebuah percobaan test, yang disajikan dari trace Playwright-nya, beserta URL menuju tautan tersebut: ringkasan trace markdown (URL digest) tentang apa yang dilakukan percobaan tersebut dan apa yang gagal, filmstrip, screencast animasi, snapshot DOM, permintaan jaringan, dan lampiran.
currents-create-sessionRekam sesi browser yang Anda jalankan sebagai sesi Currents, agar buktinya dapat dibaca dan dibagikan.
currents-add-attachmentsTambahkan lampiran ke sebuah sesi dari currents-create-session (kirim sessionId), atau ke sebuah run CI (kirim runId): log untuk sebuah file spec, sebuah test, atau run itu sendiri.
currents-list-webhooksDaftar semua webhook untuk sebuah proyek.
currents-create-share-linkBuat tautan publik ke hasil test yang dapat dibuka siapa saja tanpa masuk, hingga kedaluwarsa. purpose "fix" adalah konteks kegagalan, untuk agen yang akan memperbaiki test — konten yang sama dengan currents-get-context, dengan test flaky disertakan dan ditandai flaky. purpose "report" mencantumkan setiap test beserta percobaan dan filenya, untuk seseorang; untuk sebuah sesi, ini adalah halaman sesi: status, error, lampiran, dan trace.
currents-create-webhookBuat webhook baru untuk sebuah proyek.
currents-get-webhookDapatkan satu webhook berdasarkan ID.
currents-update-webhookPerbarui webhook yang sudah ada.
currents-delete-webhookHapus sebuah webhook.

Keterampilan

Keterampilan agen yang mengajarkan agen AI alur kerja Currents multi-langkah.

KeterampilanDeskripsi
browser-evidenceEksperimental: buktikan bahwa suatu perubahan berfungsi di browser yang Anda kendalikan sendiri, ketika tidak ada pengujian yang dapat dijalankan.
collect-evidenceTunjukkan bahwa pekerjaan yang Anda implementasikan benar-benar berfungsi, atau demokan, dari pengujian yang dijalankan di CI melalui Currents — tautan API trace yang ringkasan trace, filmstrip, dan snapshot aksesibilitasnya terbaca di dalam komentar, plus tangkapan layar, lampiran, dan video.
fix-failing-testsPerbaiki pengujian yang gagal di CI, menggunakan hasil yang direkam Currents — error, langkah, trace, tangkapan layar, dan output konsol.

Server mempublikasikan setiap keterampilan sebagai resource MCP, sehingga agen yang terhubung dapat mendaftar dan membacanya tanpa salinan lokal:

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

Agen yang memuat keterampilan hanya dari disk tetap memerlukan salinan — letakkan direktori keterampilan di lokasi keterampilan agen (misalnya .claude/skills/ untuk Claude Code).

Penyiapan

Kunci API

Dapatkan kunci API Currents dengan mengikuti instruksi di sini.

Penggunaan dengan Cursor

  1. Buka Cursor Settings > MCP > Enable
  2. Tambahkan berikut ini ke mcp.json Anda.
{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Jalankan perintah ini untuk menambahkan Currents MCP ke Claude Code

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

Tambahkan berikut ini untuk mengaktifkan Currents MCP di Claude Desktop (edit file claude_desktop_config.json):

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

VS Code dan GitHub Copilot

Install in VS Code menambahkan server yang dihosting. VS Code membuka halaman masuk Currents saat pertama kali terhubung; tidak ada kunci API yang perlu dimasukkan.

Untuk memasang plugin, yang menambahkan keterampilan serta server:

  • VS Code: buka vscode://chat-plugin/install?source=currents-dev/currents-mcp

  • Copilot CLI:

    copilot plugin marketplace add currents-dev/currents-mcp
    copilot plugin install currents@currents
    

Untuk menambahkan hanya server ke Copilot CLI:

copilot mcp add --transport http currents https://mcp.currents.dev/mcp

Endpoint MCP jarak jauh (dihosting)

Selain transport stdio lokal di atas, server yang sama dapat dijalankan sebagai endpoint Streamable HTTP yang dihosting (misalnya https://mcp.currents.dev/mcp) untuk digunakan dengan konektor jarak jauh seperti aplikasi web/mobile Claude.

Server yang dihosting tidak melakukan autentikasi sendiri. Setiap permintaan harus membawa kunci API Currents Anda sebagai token Bearer, yang diteruskan ke API Currents:

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

Contoh konfigurasi klien (konektor jarak jauh):

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

Menjalankan server HTTP sendiri:

# 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

Server Node menggunakan HTTP biasa; TLS dan domain publik diterminasi di reverse proxy / load balancer di depan kontainer. Endpoint GET /healthz disediakan untuk pemeriksaan liveness.

⚠️ Pemberitahuan

Dengan menghubungkan alat AI (misalnya, melalui MCP) ke Currents, Anda memberikan akses kepada mereka ke kunci API, hasil pengujian, dan metadata CI Anda. Merupakan tanggung jawab Anda untuk memeriksa agen atau layanan AI apa pun yang Anda gunakan, dan memastikan mereka menangani data Anda dengan aman.

Referensi