Currents
chính thứcCho phép AI Agent sửa các lỗi kiểm thử Playwright được báo cáo lên Currents.
Bạn có thể làm gì với Currents MCP?
- Chẩn đoán lỗi CI — Lấy lỗi, các bước và tệp liên quan đến những bài kiểm thử thất bại trong một lượt chạy, tệp đặc tả hoặc bài kiểm thử riêng lẻ bằng
currents-get-context. - Kiểm tra lượt chạy và kết quả — Liệt kê và lọc các lượt chạy của dự án, sau đó lấy thông tin chi tiết về lượt chạy, kết quả của từng phiên bản đặc tả và kết quả kiểm thử trước đây theo chữ ký.
- Tìm bài kiểm thử chập chờn và chậm — Truy vấn các chỉ số hiệu năng của bài kiểm thử và tệp đặc tả, cùng xu hướng lỗi tổng hợp trong một khoảng thời gian.
- Quản lý các thao tác cách ly — Tạo, bật, tắt hoặc xóa thao tác, đồng thời liệt kê các bài kiểm thử và lần thực thi bị ảnh hưởng.
- Thu thập bằng chứng kiểm thử — Thu thập ảnh chụp màn hình, video, dấu vết và tệp đính kèm từ các lượt chạy CI, hoặc tạo liên kết dấu vết có thể chia sẻ.
- Quản lý webhook và Jira — Liệt kê, tạo, cập nhật hoặc xóa webhook của dự án, đồng thời tạo hoặc liên kết vấn đề Jira từ các bài kiểm thử trong lượt chạy.
Tài liệu
Currents MCP Server
Cung cấp cho các tác nhân lập trình AI khả năng quan sát đầy đủ kết quả kiểm thử CI. Currents MCP Server kết nối trực tiếp các công cụ như Cursor và Claude với trang tổng quan Currents, giúp các tác nhân chẩn đoán kiểm thử không ổn định, xác định chính xác lỗi và hành động dựa trên dữ liệu thực thi thực tế -- mà không cần rời khỏi trình soạn thảo.
- Truy vấn các lượt chạy, tệp đặc tả và kết quả kiểm thử riêng lẻ từ CI
- Hiển thị xu hướng lỗi và chỉ số hiệu năng trên toàn bộ bộ kiểm thử
- Quản lý quy tắc cách ly, webhook và cài đặt dự án theo cách lập trình
- Cho phép các tác nhân sửa những gì bị lỗi bằng đầu ra kiểm thử thực tế, thay vì phỏng đoán
Công cụ
| Công cụ | Mô tả |
|---|---|
currents-list-actions | Liệt kê tất cả hành động của một dự án, có thể lọc tùy chọn. |
currents-create-action | Tạo hành động mới cho một dự án. |
currents-get-action | Lấy một hành động theo ID. |
currents-update-action | Cập nhật một hành động hiện có. |
currents-delete-action | Xóa (lưu trữ) một hành động. |
currents-enable-action | Bật một hành động đã bị tắt. |
currents-disable-action | Tắt một hành động đang hoạt động. |
currents-list-affected-tests | Liệt kê các bài kiểm thử bị ảnh hưởng bởi hành động (cách ly, bỏ qua, gắn thẻ) của một dự án trong một khoảng thời gian. |
currents-get-affected-test-executions | Dựa trên bài kiểm thử: liệt kê các lần thực thi của một bài kiểm thử mà hành động đã áp dụng trong một khoảng thời gian, kèm theo lần chạy, nhánh và commit của từng lần. |
currents-get-action-executions | Dựa trên hành động: liệt kê các lần thực thi bài kiểm thử mà một quy tắc đã áp dụng, trên tất cả bài kiểm thử mà quy tắc tác động đến, trong một khoảng thời gian. |
currents-get-projects | Truy xuất các dự án có trên nền tảng Currents. |
currents-get-project | Lấy một dự án theo ID. |
currents-get-project-insights | Lấy các chỉ số tổng hợp về lần chạy và bài kiểm thử của một dự án trong một khoảng thời gian. |
currents-list-pull-requests | Liệt kê các thẻ yêu cầu kéo của một dự án (các lần chạy được nhóm theo meta.pr.id). |
currents-list-project-terms | Liệt kê các thuật ngữ của dự án được phân trang bằng con trỏ cho một loại (tag, branch, authorName, v.v.). |
currents-create-jira-issue | Tạo sự cố Jira từ bài kiểm thử trong một lần chạy bằng tích hợp Jira của tổ chức. |
currents-link-jira-issue | Liên kết sự cố Jira hiện có với bài kiểm thử trong một lần chạy bằng tích hợp Jira của tổ chức. |
currents-list-jira-projects | Liệt kê các dự án Jira có sẵn cho tích hợp của tổ chức. |
currents-list-jira-issue-types | Liệt kê các loại sự cố và trường tùy chỉnh của Jira cho một dự án Jira. |
currents-get-runs | Truy xuất danh sách các lần chạy của một dự án cụ thể, có thể lọc tùy chọn. |
currents-get-run-details | Truy xuất một lần chạy: trạng thái, commit, nhánh, nhóm và tệp đặc tả, mỗi mục có instanceId, cùng số lượng tệp của lần chạy theo cấp độ, loại và nguồn (attachmentCounts). |
currents-find-run | Tìm một lần chạy bằng các tham số truy vấn. |
currents-cancel-run | Hủy một lần chạy đang diễn ra. |
currents-reset-run | Đặt lại các tệp đặc tả thất bại trong một lần chạy để cho phép thực thi lại. |
currents-delete-run | Xóa một lượt chạy và tất cả dữ liệu liên quan. |
currents-cancel-run-github-ci | Hủy một lượt chạy theo ID lượt chạy quy trình GitHub Actions và số lần thử. |
currents-get-spec-instance | Truy xuất kết quả thô của một lần thực thi tệp spec theo instanceId: trạng thái và các lần thử của từng bài kiểm thử, cùng URL của các hiện vật. |
currents-get-spec-files-performance | Truy xuất các chỉ số hiệu suất của tệp spec cho một dự án cụ thể trong một khoảng ngày. |
currents-get-tests-performance | Truy xuất các chỉ số tổng hợp của bài kiểm thử cho một dự án cụ thể trong một khoảng ngày. |
currents-get-tests-signatures | Tạo chữ ký kiểm thử duy nhất dựa trên dự án, đường dẫn tệp spec và tiêu đề bài kiểm thử. |
currents-get-test-results | Truy xuất kết quả thực thi trong quá khứ của một bài kiểm thử cụ thể theo chữ ký kiểm thử. |
currents-get-context | Gọi công cụ này trước tiên để tìm hiểu lý do bài kiểm thử thất bại trong CI hoặc để sửa chúng: trả về lỗi, các bước và tệp của những bài kiểm thử thất bại trong một lượt chạy, một tệp spec (instance) hoặc một bài kiểm thử — cùng nội dung với Fix trong bảng điều khiển Currents. |
currents-get-errors-explorer | Lấy các chỉ số lỗi tổng hợp của một dự án trong một khoảng ngày. |
currents-get-test-evidence | Thu thập các hiện vật bằng chứng (ảnh chụp màn hình, video, trace, tệp đính kèm) do các bài kiểm thử tạo ra trong một lượt chạy CI, kèm URL tải xuống có chữ ký được nhóm theo từng bài kiểm thử. |
currents-create-evidence-links | Tạo liên kết API trace có thể chia sẻ đến bằng chứng của một lần thử bài kiểm thử, được cung cấp từ trace Playwright của lần thử đó, cùng các URL: bản tóm tắt trace dạng markdown (URL digest) về những gì lần thử đã thực hiện và những gì thất bại, dải ảnh, video màn hình động, ảnh chụp DOM, yêu cầu mạng và tệp đính kèm. |
currents-create-session | Ghi lại phiên trình duyệt bạn đã điều khiển dưới dạng phiên Currents để có thể đọc và chia sẻ bằng chứng. |
currents-add-attachments | Thêm tệp đính kèm vào một phiên từ currents-create-session (gửi sessionId), hoặc vào một lượt chạy CI (gửi runId): nhật ký cho một tệp spec, một bài kiểm thử hoặc chính lượt chạy đó. |
currents-list-webhooks | Liệt kê tất cả webhook của một dự án. |
currents-create-share-link | Tạo liên kết công khai đến kết quả kiểm thử mà bất kỳ ai cũng có thể mở mà không cần đăng nhập, cho đến khi liên kết hết hạn. purpose "fix" là ngữ cảnh lỗi dành cho tác nhân sẽ sửa bài kiểm thử — cùng nội dung với currents-get-context, bao gồm các bài kiểm thử chập chờn được đánh dấu là chập chờn. purpose "report" liệt kê mọi bài kiểm thử cùng các lần thử và tệp của chúng, dành cho người dùng; với một phiên, đây là trang phiên: trạng thái, lỗi, tệp đính kèm và trace. |
currents-create-webhook | Tạo webhook mới cho một dự án. |
currents-get-webhook | Lấy một webhook theo ID. |
currents-update-webhook | Cập nhật webhook hiện có. |
currents-delete-webhook | Xóa webhook. |
Kỹ năng
Các kỹ năng dành cho tác nhân, hướng dẫn tác nhân AI thực hiện quy trình làm việc nhiều bước với Currents.
| Kỹ năng | Mô tả |
|---|---|
browser-evidence | Thử nghiệm: chứng minh một thay đổi hoạt động trong trình duyệt do chính bạn điều khiển, khi không có bài kiểm thử nào để chạy. |
collect-evidence | Cho thấy công việc bạn triển khai thực sự hoạt động hoặc trình diễn công việc đó, dựa trên các bài kiểm thử đã chạy trong CI qua Currents — một liên kết API trace có phần tóm tắt trace, filmstrip và ảnh chụp nhanh khả năng truy cập được hiển thị trong một bình luận, cùng với ảnh chụp màn hình, tệp đính kèm và video. |
fix-failing-tests | Sửa các bài kiểm thử thất bại trong CI bằng kết quả Currents đã ghi lại — lỗi, bước, trace, ảnh chụp màn hình và đầu ra bảng điều khiển. |
Máy chủ cung cấp mọi kỹ năng dưới dạng tài nguyên MCP, vì vậy tác nhân đã kết nối có thể liệt kê và đọc chúng mà không cần bản sao cục bộ:
skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md
Tác nhân chỉ tải kỹ năng từ đĩa vẫn cần một bản sao — hãy đặt thư mục kỹ năng
vào vị trí lưu kỹ năng của tác nhân (ví dụ: .claude/skills/ cho Claude
Code).
Thiết lập
API Key
Lấy API key Currents bằng cách làm theo hướng dẫn tại đây.
Sử dụng với Cursor
- Vào Cursor Settings > MCP > Enable
- Thêm nội dung sau vào
mcp.json.
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
Claude
Chạy lệnh này để thêm Currents MCP vào Claude Code
claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp
Thêm nội dung sau để bật Currents MCP trên Claude Desktop (chỉnh sửa tệp claude_desktop_config.json):
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
VS Code và GitHub Copilot
Install in VS Code thêm máy chủ được lưu trữ. VS Code mở trang đăng nhập Currents khi kết nối lần đầu; bạn không cần nhập API key.
Để cài đặt plugin, bổ sung cả kỹ năng lẫn máy chủ:
-
VS Code: mở
vscode://chat-plugin/install?source=currents-dev/currents-mcp -
Copilot CLI:
copilot plugin marketplace add currents-dev/currents-mcp copilot plugin install currents@currents
Để chỉ thêm máy chủ vào Copilot CLI:
copilot mcp add --transport http currents https://mcp.currents.dev/mcp
MCP từ xa (được lưu trữ)
Ngoài phương thức truyền tải stdio cục bộ ở trên, cùng máy chủ đó có thể chạy dưới dạng
điểm cuối Streamable HTTP được lưu trữ (ví dụ: https://mcp.currents.dev/mcp) để dùng với các
trình kết nối từ xa như ứng dụng web/di động Claude.
Máy chủ được lưu trữ không tự xác thực. Mỗi yêu cầu phải gửi API key Currents của bạn dưới dạng Bearer token; khóa này được chuyển tiếp đến API Currents:
Authorization: Bearer <your-currents-api-key>
Ví dụ cấu hình ứng dụng khách (trình kết nối từ xa):
{
"mcpServers": {
"currents": {
"url": "https://mcp.currents.dev/mcp",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
}
Tự chạy máy chủ HTTP:
# 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
Máy chủ Node sử dụng HTTP thuần; TLS và tên miền công khai được kết thúc tại
reverse proxy / bộ cân bằng tải phía trước container. Có một điểm cuối GET /healthz
để kiểm tra trạng thái hoạt động.
⚠️ Lưu ý
Khi kết nối các công cụ AI (ví dụ: qua MCP) với Currents, bạn cấp cho chúng quyền truy cập vào API key, kết quả kiểm thử và siêu dữ liệu CI của mình. Bạn có trách nhiệm kiểm tra mọi tác nhân hoặc dịch vụ AI mà mình sử dụng, đồng thời đảm bảo chúng xử lý dữ liệu của bạn một cách an toàn.