Currents
公式AIエージェントがCurrentsに報告されたPlaywrightテストの失敗を修正できるようにします。
Currents MCPで何ができますか?
- CI の失敗を診断 —
currents-get-contextを使って、実行・spec ファイル・単一テストで失敗したテストの背後にあるエラー、ステップ、ファイルを取得します。 - 実行と結果を検査 — プロジェクトの実行を一覧表示・フィルタリングし、実行の詳細、spec インスタンスの結果、シグネチャ別の過去のテスト結果を取得します。
- 不安定なテストと遅いテストを特定 — 日付範囲を指定して、テストと spec ファイルのパフォーマンス指標および集計されたエラー傾向をクエリします。
- 隔離アクションを管理 — アクションの作成、有効化、無効化、削除を行い、それらが影響したテストと実行を一覧表示します。
- テストの証跡を収集 — CI 実行からスクリーンショット、動画、トレース、添付ファイルを収集するか、共有可能なトレースリンクを作成します。
- Webhook と Jira を管理 — プロジェクトの Webhook を一覧表示・作成・更新・削除するか、実行のテストから Jira 課題を作成またはリンクします。
ドキュメント
Currents MCP Server
AIコーディングエージェントにCIテスト結果への完全な可視性を提供します。Currents MCP Serverは、CursorやClaudeなどのツールをCurrentsダッシュボードに直接接続するため、エージェントはエディタを離れることなく、不安定なテストの診断、失敗箇所の特定、実際の実行データに基づく対応が可能になります。
- CIから実行、スペックファイル、個々のテスト結果を照会する
- テストスイート全体のエラー傾向とパフォーマンス指標を可視化する
- 隔離ルール、Webhook、プロジェクト設定をプログラムで管理する
- 推測ではなく実際のテスト出力を使用して、エージェントに問題の修正を任せる
ツール
| ツール | 説明 |
|---|---|
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 | 指定した日付範囲内で、プロジェクトのアクション(quarantine、skip、tag)によって影響を受けるテストを一覧表示します。 |
currents-get-affected-test-executions | テストをキーとして、指定した日付範囲内でアクションが適用された1つのテストの実行を、各実行の run、branch、commit とともに一覧表示します。 |
currents-get-action-executions | アクションをキーとして、指定した日付範囲内で1つのルールが適用されたテスト実行を、そのルールが影響したすべてのテストにわたって一覧表示します。 |
currents-get-projects | Currents プラットフォームで利用可能なプロジェクトを取得します。 |
currents-get-project | ID で単一のプロジェクトを取得します。 |
currents-get-project-insights | 指定した日付範囲内で、プロジェクトの集計された run および test のメトリクスを取得します。 |
currents-list-pull-requests | プロジェクトのプルリクエストカードを一覧表示します(meta.pr.id でグループ化された run)。 |
currents-list-project-terms | 1つのタイプ(tag、branch、authorName など)について、カーソルページネーションされたプロジェクトの用語を一覧表示します。 |
currents-create-jira-issue | 組織の Jira 連携を使用して、run test から Jira 課題を作成します。 |
currents-link-jira-issue | 組織の Jira 連携を使用して、既存の Jira 課題を run test にリンクします。 |
currents-list-jira-projects | 組織の連携で利用可能な Jira プロジェクトを一覧表示します。 |
currents-list-jira-issue-types | Jira プロジェクトの Jira 課題タイプとカスタムフィールドを一覧表示します。 |
currents-get-runs | 特定のプロジェクトの run の一覧を、任意のフィルタリング付きで取得します。 |
currents-get-run-details | run を取得します。そのステータス、commit、branch、グループ、spec ファイル(それぞれの instanceId 付き)、およびレベル、タイプ、ソース別のファイル数(attachmentCounts)を含みます。 |
currents-find-run | クエリパラメータで run を検索します。 |
currents-cancel-run | 進行中の run をキャンセルします。 |
currents-reset-run | run 内の失敗した spec ファイルをリセットして再実行できるようにします。 |
currents-delete-run | 実行と関連するすべてのデータを削除します。 |
currents-cancel-run-github-ci | GitHub Actions のワークフロー実行 ID と試行番号で実行をキャンセルします。 |
currents-get-spec-instance | instanceId を指定して、1 つのスペックファイル実行の生の結果を取得します。各テストの状態と試行、およびアーティファクトの URL が含まれます。 |
currents-get-spec-files-performance | 指定した期間内の特定プロジェクトのスペックファイルパフォーマンスメトリクスを取得します。 |
currents-get-tests-performance | 指定した期間内の特定プロジェクトの集計テストメトリクスを取得します。 |
currents-get-tests-signatures | プロジェクト、スペックファイルのパス、テストタイトルに基づいて一意のテストシグネチャを生成します。 |
currents-get-test-results | 特定のテストシグネチャに対する過去のテスト実行結果を取得します。 |
currents-get-context | CI でテストが失敗した理由を調べたり、修正したりするには、まずこれを呼び出してください。実行、スペックファイル (インスタンス)、または 1 つのテストの失敗したテストのエラー、ステップ、ファイルを返します。Currents ダッシュボードの Fix と同じ内容です。 |
currents-get-errors-explorer | 指定した期間内のプロジェクトの集計エラーメトリクスを取得します。 |
currents-get-test-evidence | CI 実行でテストが生成した証跡アーティファクト (スクリーンショット、動画、トレース、添付ファイル) を、テストごとにグループ化された署名付きダウンロード URL とともに収集します。 |
currents-create-evidence-links | テスト試行の証跡への共有可能なトレース API リンクを、その Playwright トレースから提供される形で作成し、そのリンク先の URL を返します。試行が何を行い何が失敗したかの markdown トレースサマリー (digest URL)、フィルムストリップ、アニメーション付きスクリーンキャスト、DOM スナップショット、ネットワークリクエスト、添付ファイルが含まれます。 |
currents-create-session | 自分で操作したブラウザセッションを Currents セッションとして記録し、その証跡を読み取り・共有できるようにします。 |
currents-add-attachments | currents-create-session からセッションに添付ファイルを追加する (sessionId を送信)、または CI 実行に追加する (runId を送信): スペックファイル、テスト、または実行自体のログ。 |
currents-list-webhooks | プロジェクトのすべての Webhook を一覧表示します。 |
currents-create-share-link | サインインせずに誰でも開けるテスト結果への公開リンクを、有効期限が切れるまで作成します。purpose "fix" は失敗のコンテキストで、テストを修正するエージェント向けです。currents-get-context と同じ内容で、不安定なテストも含まれ、不安定としてマークされます。purpose "report" は、人向けにすべてのテストをその試行とファイルとともに一覧表示します。セッションの場合はセッションページ (ステータス、エラー、添付ファイル、トレース) になります。 |
currents-create-webhook | プロジェクトの新しい Webhook を作成します。 |
currents-get-webhook | ID で単一の Webhook を取得します。 |
currents-update-webhook | 既存の Webhook を更新します。 |
currents-delete-webhook | Webhook を削除します。 |
スキル
AI エージェントに Currents のマルチステップワークフローを教えるエージェントスキル。
| スキル | 説明 |
|---|---|
browser-evidence | 実験的: 実行できるテストがない場合に、自分で操作したブラウザで変更が機能することを証明します。 |
collect-evidence | 実装した作業が実際に機能することを示す、またはデモするために、Currents 経由で CI で実行されたテストを使用します — トレースのサマリー、フィルムストリップ、アクセシビリティスナップショットがコメント内で読めるトレース API リンクに加え、スクリーンショット、添付ファイル、動画も含みます。 |
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 での使用
- Cursor Settings > MCP > Enable に移動します
- 以下を
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 の Web/モバイルアプリなどのリモートコネクタで使用できます。
ホスト型サーバーは独自の認証を一切行いません。各リクエストは 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 エージェントやサービスを精査し、データが安全に扱われることを確認するのはあなたの責任です。