Currents

공식

AI 에이전트가 Currents에 보고된 Playwright 테스트 실패를 수정할 수 있도록 활성화합니다.

Currents MCP(으)로 무엇을 할 수 있나요?

  • CI 실패 진단 — currents-get-context를 사용하여 실행, 스펙 파일 또는 단일 테스트에서 실패한 테스트의 오류, 단계, 파일을 가져옵니다.
  • 실행 및 결과 검사 — 프로젝트 실행을 나열하고 필터링한 다음, 실행 세부 정보, 스펙 인스턴스 결과, 서명별 과거 테스트 결과를 가져옵니다.
  • 불안정하고 느린 테스트 찾기 — 날짜 범위에 걸쳐 테스트 및 스펙 파일 성능 지표와 집계된 오류 추세를 쿼리합니다.
  • 격리 조치 관리 — 조치를 생성, 활성화, 비활성화 또는 삭제하고 영향을 받은 테스트와 실행을 나열합니다.
  • 테스트 증거 수집 — CI 실행에서 스크린샷, 비디오, 트레이스, 첨부 파일을 수집하거나 공유 가능한 트레이스 링크를 생성합니다.
  • 웹훅 및 Jira 관리 — 프로젝트 웹훅을 나열, 생성, 업데이트 또는 삭제하고 실행 테스트에서 Jira 이슈를 생성하거나 연결합니다.

문서

Currents MCP 서버

Unit Tests

AI 코딩 에이전트가 CI 테스트 결과를 완전히 파악할 수 있도록 하세요. Currents MCP 서버는 Cursor, Claude 같은 도구를 Currents 대시보드에 직접 연결하여, 에이전트가 편집기를 떠나지 않고도 불안정한 테스트를 진단하고, 실패 지점을 정확히 찾아내며, 실제 실행 데이터를 바탕으로 조치할 수 있게 해줍니다.

  • CI에서 실행, 스펙 파일, 개별 테스트 결과 조회
  • 테스트 스위트 전반의 오류 추세와 성능 지표 확인
  • 격리 규칙, 웹훅, 프로젝트 설정을 프로그래밍 방식으로 관리
  • 에이전트가 추측이 아닌 실제 테스트 출력을 사용해 문제를 수정하도록 지원

Install MCP Server

도구

도구설명
currents-list-actions선택적 필터링을 사용하여 프로젝트의 모든 액션을 나열합니다.
currents-create-action프로젝트에 대한 새 액션을 생성합니다.
currents-get-actionID로 단일 액션을 가져옵니다.
currents-update-action기존 액션을 업데이트합니다.
currents-delete-action액션을 삭제(보관)합니다.
currents-enable-action비활성화된 액션을 활성화합니다.
currents-disable-action활성 액션을 비활성화합니다.
currents-list-affected-tests날짜 범위 내에서 프로젝트에 대해 액션(격리, 건너뛰기, 태그)의 영향을 받은 테스트를 나열합니다.
currents-get-affected-test-executions테스트 기준: 날짜 범위 내에서 액션이 적용된 한 테스트의 실행을 각 실행의 run, branch, commit과 함께 나열합니다.
currents-get-action-executions액션 기준: 날짜 범위 내에서 하나의 규칙이 적용된 테스트 실행을 해당 규칙이 영향을 준 모든 테스트에 걸쳐 나열합니다.
currents-get-projectsCurrents 플랫폼에서 사용 가능한 프로젝트를 검색합니다.
currents-get-projectID로 단일 프로젝트를 가져옵니다.
currents-get-project-insights날짜 범위 내에서 프로젝트의 집계된 실행 및 테스트 지표를 가져옵니다.
currents-list-pull-requests프로젝트의 풀 리퀘스트 카드를 나열합니다(meta.pr.id로 그룹화된 실행).
currents-list-project-terms한 유형(tag, branch, authorName 등)에 대한 커서 페이지네이션된 프로젝트 용어를 나열합니다.
currents-create-jira-issue조직 Jira 통합을 사용하여 실행 테스트에서 Jira 이슈를 생성합니다.
currents-link-jira-issue조직 Jira 통합을 사용하여 기존 Jira 이슈를 실행 테스트에 연결합니다.
currents-list-jira-projects조직 통합에 사용 가능한 Jira 프로젝트를 나열합니다.
currents-list-jira-issue-typesJira 프로젝트의 Jira 이슈 유형 및 사용자 정의 필드를 나열합니다.
currents-get-runs선택적 필터링을 사용하여 특정 프로젝트의 실행 목록을 검색합니다.
currents-get-run-details실행을 검색합니다: 상태, 커밋, 브랜치, 그룹 및 스펙 파일(각각의 instanceId 포함), 그리고 레벨, 유형 및 소스별로 실행이 가진 파일 수(attachmentCounts).
currents-find-run쿼리 매개변수로 실행을 찾습니다.
currents-cancel-run진행 중인 실행을 취소합니다.
currents-reset-run재실행을 허용하기 위해 실행에서 실패한 스펙 파일을 재설정합니다.
currents-delete-run실행(run)과 관련된 모든 데이터를 삭제합니다.
currents-cancel-run-github-ciGitHub Actions 워크플로 실행 ID와 시도 번호로 실행을 취소합니다.
currents-get-spec-instanceinstanceId로 단일 스펙 파일 실행의 원시 결과를 가져옵니다. 각 테스트의 상태와 시도, 아티팩트 URL을 포함합니다.
currents-get-spec-files-performance지정된 날짜 범위 내에서 특정 프로젝트의 스펙 파일 성능 지표를 가져옵니다.
currents-get-tests-performance지정된 날짜 범위 내에서 특정 프로젝트의 집계된 테스트 지표를 가져옵니다.
currents-get-tests-signatures프로젝트, 스펙 파일 경로, 테스트 제목을 기반으로 고유한 테스트 서명을 생성합니다.
currents-get-test-results특정 테스트 서명에 대한 과거 테스트 실행 결과를 가져옵니다.
currents-get-contextCI에서 테스트가 실패한 이유를 파악하거나 수정하려면 먼저 이 도구를 호출하세요. 실행, 스펙 파일(인스턴스) 또는 단일 테스트의 실패한 테스트에 대한 오류, 단계, 파일을 반환합니다. Currents 대시보드의 Fix와 동일한 내용입니다.
currents-get-errors-explorer지정된 날짜 범위 내에서 프로젝트의 집계된 오류 지표를 가져옵니다.
currents-get-test-evidenceCI 실행에서 테스트가 생성한 증거 아티팩트(스크린샷, 비디오, 트레이스, 첨부 파일)를 수집하며, 테스트별로 그룹화된 서명된 다운로드 URL을 제공합니다.
currents-create-evidence-links테스트 시도의 증거에 대한 공유 가능한 트레이스 API 링크를 생성하며, 해당 Playwright 트레이스에서 제공됩니다. 링크에는 시도가 수행한 작업과 실패한 내용에 대한 마크다운 트레이스 요약(digest URL), 필름스트립, 애니메이션 스크린캐스트, DOM 스냅샷, 네트워크 요청, 첨부 파일이 포함됩니다.
currents-create-session직접 구동한 브라우저 세션을 Currents 세션으로 기록하여 해당 증거를 읽고 공유할 수 있게 합니다.
currents-add-attachmentscurrents-create-session에서 생성한 세션(sessionId 전송) 또는 CI 실행(runId 전송)에 첨부 파일을 추가합니다. 스펙 파일, 테스트 또는 실행 자체에 대한 로그를 추가할 수 있습니다.
currents-list-webhooks프로젝트의 모든 웹훅을 나열합니다.
currents-create-share-link로그인 없이 누구나 열 수 있는 테스트 결과 공개 링크를 만료될 때까지 생성합니다. purpose "fix"는 테스트를 수정할 에이전트를 위한 실패 컨텍스트로, currents-get-context와 동일한 내용이며 불안정한 테스트가 포함되고 불안정으로 표시됩니다. purpose "report"는 사람을 위해 모든 테스트를 시도 및 파일과 함께 나열합니다. 세션의 경우 세션 페이지(상태, 오류, 첨부 파일, 트레이스)입니다.
currents-create-webhook프로젝트에 새 웹훅을 생성합니다.
currents-get-webhookID로 단일 웹훅을 가져옵니다.
currents-update-webhook기존 웹훅을 업데이트합니다.
currents-delete-webhook웹훅을 삭제합니다.

스킬

AI 에이전트에게 다단계 Currents 워크플로를 가르치는 에이전트 스킬입니다.

스킬설명
browser-evidence실험적: 실행할 테스트가 없을 때, 직접 구동한 브라우저에서 변경 사항이 작동함을 입증합니다.
collect-evidence구현한 작업이 실제로 작동함을 보여주거나 시연합니다. Currents를 통해 CI에서 실행된 테스트로부터 — 코멘트 안에서 읽히는 트레이스 요약, 필름스트립, 접근성 스냅샷이 포함된 트레이스 API 링크와 스크린샷, 첨부 파일, 비디오를 사용합니다.
fix-failing-testsCurrents가 기록한 결과 — 오류, 단계, 트레이스, 스크린샷, 콘솔 출력 — 을 사용하여 CI에서 실패한 테스트를 수정합니다.

서버는 모든 스킬을 MCP 리소스로 게시하므로, 연결된 에이전트는 로컬 복사본 없이도 스킬을 나열하고 읽을 수 있습니다:

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

스킬을 디스크에서만 로드하는 에이전트는 여전히 복사본이 필요합니다 — 스킬 디렉터리를 에이전트의 스킬 위치에 두세요 (예: Claude Code의 경우 .claude/skills/).

설정

API 키

여기 안내를 따라 Currents API 키를 발급받으세요.

Cursor와 함께 사용하기

  1. Cursor Settings > MCP > Enable로 이동
  2. mcp.json에 다음을 추가하세요.
{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Claude Code에 Currents MCP를 추가하려면 다음 명령을 실행하세요

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

Claude Desktop에서 Currents MCP를 활성화하려면 다음을 추가하세요 (claude_desktop_config.json 파일 편집):

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

VS Code 및 GitHub Copilot

VS Code에 설치하면 호스팅 서버가 추가됩니다. VS Code는 처음 연결할 때 Currents 로그인 페이지를 엽니다. 입력할 API 키는 없습니다.

서버와 함께 스킬을 추가하는 플러그인을 설치하려면:

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

  • Copilot CLI:

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

Copilot CLI에 서버만 추가하려면:

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

원격(호스팅) MCP 엔드포인트

위의 로컬 stdio 전송 외에도, 동일한 서버를 호스팅 Streamable HTTP 엔드포인트(예: https://mcp.currents.dev/mcp)로 실행하여 Claude 웹/모바일 앱과 같은 원격 커넥터와 함께 사용할 수 있습니다.

호스팅 서버는 자체 인증을 수행하지 않습니다. 각 요청은 Currents API 키를 Bearer 토큰으로 전달해야 하며, 이 토큰은 Currents API로 그대로 전달됩니다:

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

클라이언트 구성 예시 (원격 커넥터):

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

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

Node 서버는 일반 HTTP로 통신합니다. TLS와 공개 도메인은 컨테이너 앞의 리버스 프록시 / 로드 밸런서에서 종료됩니다. 활성 상태 확인을 위해 GET /healthz 엔드포인트가 제공됩니다.

⚠️ 주의

AI 도구(예: MCP를 통해)를 Currents에 연결하면 해당 도구에 API 키, 테스트 결과, CI 메타데이터에 대한 접근 권한을 부여하는 것입니다. 사용하는 AI 에이전트나 서비스를 검증하고 데이터를 안전하게 처리하는지 확인하는 것은 사용자의 책임입니다.

참고 자료