Currents
resmiMemungkinkan 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
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
Alat
| Alat | Deskripsi |
|---|---|
currents-list-actions | Menampilkan daftar semua aksi untuk sebuah proyek dengan penyaringan opsional. |
currents-create-action | Membuat aksi baru untuk sebuah proyek. |
currents-get-action | Mengambil satu aksi berdasarkan ID. |
currents-update-action | Memperbarui aksi yang sudah ada. |
currents-delete-action | Menghapus (mengarsipkan) sebuah aksi. |
currents-enable-action | Mengaktifkan aksi yang dinonaktifkan. |
currents-disable-action | Menonaktifkan aksi yang aktif. |
currents-list-affected-tests | Menampilkan daftar pengujian yang terdampak oleh aksi (karantina, lewati, tag) untuk sebuah proyek dalam rentang tanggal tertentu. |
currents-get-affected-test-executions | Berdasarkan pengujian: menampilkan daftar eksekusi satu pengujian yang dikenai aksi, dalam rentang tanggal tertentu, beserta run, branch, dan commit masing-masing. |
currents-get-action-executions | Berdasarkan aksi: menampilkan daftar eksekusi pengujian yang dikenai satu aturan, di seluruh pengujian yang tersentuh, dalam rentang tanggal tertentu. |
currents-get-projects | Mengambil proyek yang tersedia di platform Currents. |
currents-get-project | Mengambil satu proyek berdasarkan ID. |
currents-get-project-insights | Mengambil metrik agregat run dan pengujian untuk sebuah proyek dalam rentang tanggal tertentu. |
currents-list-pull-requests | Menampilkan daftar kartu pull-request untuk sebuah proyek (run dikelompokkan berdasarkan meta.pr.id). |
currents-list-project-terms | Menampilkan daftar istilah proyek dengan paginasi kursor untuk satu tipe (tag, branch, authorName, dll.). |
currents-create-jira-issue | Membuat issue Jira dari pengujian run menggunakan integrasi Jira organisasi. |
currents-link-jira-issue | Menautkan issue Jira yang sudah ada ke pengujian run menggunakan integrasi Jira organisasi. |
currents-list-jira-projects | Menampilkan daftar proyek Jira yang tersedia untuk integrasi organisasi. |
currents-list-jira-issue-types | Menampilkan daftar tipe issue Jira dan field kustom untuk sebuah proyek Jira. |
currents-get-runs | Mengambil daftar run untuk proyek tertentu dengan penyaringan opsional. |
currents-get-run-details | Mengambil 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-run | Menemukan run berdasarkan parameter kueri. |
currents-cancel-run | Membatalkan run yang sedang berlangsung. |
currents-reset-run | Mengatur ulang file spec yang gagal dalam sebuah run agar dapat dieksekusi ulang. |
currents-delete-run | Hapus sebuah run beserta semua data terkait. |
currents-cancel-run-github-ci | Batalkan sebuah run berdasarkan ID workflow run GitHub Actions dan nomor percobaan. |
currents-get-spec-instance | Mengambil hasil mentah dari eksekusi satu file spec berdasarkan instanceId: status dan percobaan setiap test, serta URL artefak. |
currents-get-spec-files-performance | Mengambil metrik performa file spec untuk proyek tertentu dalam rentang tanggal tertentu. |
currents-get-tests-performance | Mengambil metrik test teragregasi untuk proyek tertentu dalam rentang tanggal tertentu. |
currents-get-tests-signatures | Menghasilkan signature test unik berdasarkan proyek, path file spec, dan judul test. |
currents-get-test-results | Mengambil riwayat hasil eksekusi test untuk signature test tertentu. |
currents-get-context | Panggil 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-explorer | Dapatkan metrik error teragregasi untuk sebuah proyek dalam rentang tanggal tertentu. |
currents-get-test-evidence | Kumpulkan 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-links | Buat 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-session | Rekam sesi browser yang Anda jalankan sebagai sesi Currents, agar buktinya dapat dibaca dan dibagikan. |
currents-add-attachments | Tambahkan 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-webhooks | Daftar semua webhook untuk sebuah proyek. |
currents-create-share-link | Buat 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-webhook | Buat webhook baru untuk sebuah proyek. |
currents-get-webhook | Dapatkan satu webhook berdasarkan ID. |
currents-update-webhook | Perbarui webhook yang sudah ada. |
currents-delete-webhook | Hapus sebuah webhook. |
Keterampilan
Keterampilan agen yang mengajarkan agen AI alur kerja Currents multi-langkah.
| Keterampilan | Deskripsi |
|---|---|
browser-evidence | Eksperimental: buktikan bahwa suatu perubahan berfungsi di browser yang Anda kendalikan sendiri, ketika tidak ada pengujian yang dapat dijalankan. |
collect-evidence | Tunjukkan 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-tests | Perbaiki 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
- Buka Cursor Settings > MCP > Enable
- Tambahkan berikut ini ke
mcp.jsonAnda.
{
"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.