Currents

chính thức

Cho 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

Unit Tests

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

Install MCP Server

Công cụ

Công cụMô tả
currents-list-actionsLiệt kê tất cả hành động của một dự án, có thể lọc tùy chọn.
currents-create-actionTạo hành động mới cho một dự án.
currents-get-actionLấy một hành động theo ID.
currents-update-actionCập nhật một hành động hiện có.
currents-delete-actionXóa (lưu trữ) một hành động.
currents-enable-actionBật một hành động đã bị tắt.
currents-disable-actionTắt một hành động đang hoạt động.
currents-list-affected-testsLiệ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-executionsDự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-executionsDự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-projectsTruy xuất các dự án có trên nền tảng Currents.
currents-get-projectLấy một dự án theo ID.
currents-get-project-insightsLấ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-requestsLiệ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-termsLiệ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-issueTạ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-issueLiê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-projectsLiệt kê các dự án Jira có sẵn cho tích hợp của tổ chức.
currents-list-jira-issue-typesLiệ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-runsTruy 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-detailsTruy 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-runTìm một lần chạy bằng các tham số truy vấn.
currents-cancel-runHủ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-runXóa một lượt chạy và tất cả dữ liệu liên quan.
currents-cancel-run-github-ciHủ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-instanceTruy 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-performanceTruy 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-performanceTruy 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-signaturesTạ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-resultsTruy 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-contextGọ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-explorerLấ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-evidenceThu 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-linksTạ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-sessionGhi 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-attachmentsThê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-webhooksLiệt kê tất cả webhook của một dự án.
currents-create-share-linkTạ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-webhookTạo webhook mới cho một dự án.
currents-get-webhookLấy một webhook theo ID.
currents-update-webhookCập nhật webhook hiện có.
currents-delete-webhookXó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ăngMô tả
browser-evidenceThử 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-evidenceCho 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-testsSử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

  1. Vào Cursor Settings > MCP > Enable
  2. 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.

Tài liệu tham khảo