Currents
公式AIエージェントがCurrentsに報告されたPlaywrightテストの失敗を修正できるようにします。
Currents MCPで何ができますか?
- クエリの実行とテスト結果 —
currents-get-runsとcurrents-get-test-resultsを使用して、最近のCI実行や過去の結果を確認します。 - コンテキスト付きで失敗を診断 —
currents-get-contextを使用して、実行、インスタンス、またはテストレベルでAIデバッグ用の失敗コンテキストを取得します。 - テスト証拠の収集 —
currents-get-test-evidenceを使用して、CI実行からスクリーンショット、ビデオ、トレース、添付ファイルを取得します。 - 検疫とアクションの管理 —
currents-list-actionsとcurrents-create-actionを使用して、検疫ルールなどのアクションを一覧表示、作成、更新、または無効化します。 - Webhookの管理 —
currents-list-webhooksとcurrents-create-webhookを使用して、プロジェクトのWebhookを一覧表示、作成、更新、または削除します。
ドキュメント
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 | 日付範囲内のプロジェクトについて、アクション(検疫、スキップ、タグ)の影響を受けたテストを一覧表示します。 |
currents-get-affected-test-executions | 日付範囲内の特定の影響を受けたテスト(シグネチャによる)の実行詳細を取得します。 |
currents-get-affected-executions | 日付範囲内で特定のアクション/ルールが適用されたテスト実行を一覧表示します。 |
currents-get-projects | Currentsプラットフォームで利用可能なプロジェクトを取得します。 |
currents-get-project | IDで単一のプロジェクトを取得します。 |
currents-get-project-insights | 日付範囲内のプロジェクトの集計された実行およびテストメトリクスを取得します。 |
currents-list-pull-requests | プロジェクトのプルリクエストカードを一覧表示します(meta.pr.idでグループ化された実行)。 |
currents-list-project-terms | 1つのタイプ(タグ、ブランチ、authorNameなど)のカーソルページネーションされたプロジェクト用語を一覧表示します。 |
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 | 実行、インスタンス、またはテストレベルでAIデバッグ用のテスト失敗コンテキストを取得します。 |
currents-get-errors-explorer | 日付範囲内のプロジェクトの集計エラーメトリクスを取得します。 |
currents-get-test-evidence | CI実行でテストによって生成された証拠アーティファクト(スクリーンショット、ビデオ、トレース、添付ファイル)を、テストごとにグループ化された署名付きダウンロードURLとともに収集します。 |
currents-list-webhooks | プロジェクトのすべてのWebhookを一覧表示します。 |
currents-create-webhook | プロジェクトの新しいWebhookを作成します。 |
currents-get-webhook | IDで単一のWebhookを取得します。 |
currents-update-webhook | 既存のWebhookを更新します。 |
currents-delete-webhook | Webhookを削除します。 |
スキル
AIエージェントに複数ステップのCurrentsワークフローを教えるエージェントスキル。
| スキル | 説明 |
|---|---|
collect-evidence | 実装した作業が機能することを、CIテストアーティファクト(変更前/後のスクリーンショット、テキスト添付ファイル、ビデオ、トレース)を使用して示すか、デモします。 |
サーバーはすべてのスキルをMCPリソースとして公開するため、接続されたエージェントはローカルコピーなしでそれらを一覧表示して読み取ることができます:
skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md
ディスクからのみスキルを読み込むエージェントにはコピーが必要です — スキルディレクトリをエージェントのスキル場所(例:Claude Codeの場合は.claude/skills/)に配置してください。
セットアップ
APIキー
こちらの手順に従ってCurrents APIキーを取得してください。
Cursorでの使用
- Cursor設定 > MCP > 有効にする に移動します
- 以下を
mcp.jsonに追加します。
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
Claude
このコマンドを実行してCurrents MCPをClaude Codeに追加します
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 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エージェントやサービスを審査し、データを安全に取り扱うことを確認する責任はあなたにあります。