Currents

Currents MCP 서버

AI 코딩 에이전트에게 CI 테스트 결과에 대한 전체 가시성을 제공하세요. Currents MCP 서버는 Cursor 및 Claude와 같은 도구를 Currents 대시보드에 직접 연결하여, 에이전트가 편집기를 벗어나지 않고도 플레이키 테스트를 진단하고, 실패를 정확히 찾아내며, 실제 실행 데이터를 기반으로 조치를 취할 수 있게 합니다.

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

도구

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

스킬

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

스킬	설명
browser-evidence	실험적 기능입니다.
collect-evidence	직접 구현한 작업이 실제로 작동한다는 것을 보여주거나, Currents를 통해 CI에서 실행된 테스트로 데모합니다 — 댓글 안에서 읽히는 다이제스트, 필름스트립, 접근성 스냅샷이 포함된 추적 링크와 스크린샷, 첨부 파일, 비디오를 제공합니다.
fix-failing-tests	Currents가 기록한 결과(오류, 단계, 추적, 스크린샷, 콘솔 출력)를 사용하여 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 설정 > MCP > 활성화로 이동합니다.
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"
      }
    }
  }
}

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

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

호스팅 서버는 자체 인증을 수행하지 않습니다. 각 요청은 Bearer 토큰으로 Currents API 키를 포함해야 하며, 이 키는 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 에이전트나 서비스를 검증하고, 데이터를 안전하게 처리하도록 하는 것은 사용자의 책임입니다.

참고 자료

• Currents
• Currents 문서
• 기여 가이드
• 릴리스 및 게시
• 라이선스