Currents

официальный

Предоставьте AI-агентам возможность исправлять ошибки тестов Playwright, о которых сообщается в Currents.

Что можно делать с Currents MCP?

  • Диагностика сбоев CI — Получайте ошибки, шаги и файлы, связанные с неудачными тестами в запуске, файле спецификации или отдельном тесте, с помощью currents-get-context.
  • Просмотр запусков и результатов — Просматривайте и фильтруйте запуски проекта, а затем получайте сведения о запуске, результаты экземпляров спецификаций и исторические результаты тестов по сигнатуре.
  • Поиск нестабильных и медленных тестов — Запрашивайте метрики производительности тестов и файлов спецификаций, а также агрегированные тенденции ошибок за выбранный период.
  • Управление действиями карантина — Создавайте, включайте, отключайте или удаляйте действия, а также просматривайте тесты и выполнения, на которые они повлияли.
  • Сбор свидетельств тестирования — Собирайте скриншоты, видео, трассировки и вложения из запусков CI или создавайте ссылки на трассировки, которыми можно поделиться.
  • Управление вебхуками и Jira — Просматривайте, создавайте, обновляйте или удаляйте вебхуки проекта, а также создавайте задачи Jira или связывайте их с тестами из запусков.

Документация

Currents MCP Server

Unit Tests

Предоставьте своим ИИ-агентам для написания кода полный доступ к результатам CI-тестов. Currents MCP Server напрямую подключает такие инструменты, как Cursor и Claude, к вашей панели управления Currents, чтобы агенты могли диагностировать нестабильные тесты, выявлять причины сбоев и работать с реальными данными о выполнении — не покидая редактор.

  • Запрашивать запуски, файлы спецификаций и результаты отдельных тестов из CI
  • Отслеживать тенденции ошибок и показатели производительности всего набора тестов
  • Программно управлять правилами карантина, вебхуками и настройками проекта
  • Позволять агентам исправлять проблемы на основе фактических результатов тестов, а не догадок

Install MCP Server

Инструменты

ToolОписание
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Список терминов проекта с постраничной навигацией по курсору для одного типа (tag, branch, 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Получить сведения о запуске: его статус, коммит, ветку, группы и файлы спецификаций, каждый со своим instanceId, а также количество файлов запуска по уровню, типу и источнику (attachmentCounts).
currents-find-runНайти запуск по параметрам запроса.
currents-cancel-runОтменить выполняющийся запуск.
currents-reset-runСбросить неудачные файлы спецификаций в запуске, чтобы разрешить их повторное выполнение.
currents-delete-runУдалить запуск и все связанные с ним данные.
currents-cancel-run-github-ciОтменить запуск по ID запуска рабочего процесса GitHub Actions и номеру попытки.
currents-get-spec-instanceПолучить необработанный результат выполнения одного файла спецификации по instanceId: состояние и попытки каждого теста, а также URL артефактов.
currents-get-spec-files-performanceПолучить метрики производительности файлов спецификаций для определённого проекта за указанный период.
currents-get-tests-performanceПолучить агрегированные метрики тестов для определённого проекта за указанный период.
currents-get-tests-signaturesСоздать уникальную сигнатуру теста на основе проекта, пути к файлу спецификации и названия теста.
currents-get-test-resultsПолучить исторические результаты выполнения теста для определённой сигнатуры теста.
currents-get-contextСначала вызовите этот инструмент, чтобы выяснить, почему тесты завершились с ошибкой в CI, или исправить их: он возвращает ошибки, шаги и файлы для тестов, завершившихся с ошибкой в запуске, файле спецификации (экземпляре) или отдельном тесте — те же данные, что и Fix на панели Currents.
currents-get-errors-explorerПолучить агрегированные метрики ошибок для проекта за указанный период.
currents-get-test-evidenceСобрать артефакты с доказательствами (снимки экрана, видео, трассировки, вложения), созданные тестами в запуске CI, и получить подписанные URL для скачивания, сгруппированные по тестам.
currents-create-evidence-linksСоздать общедоступную ссылку на API трассировки с доказательствами попытки теста, предоставленными из трассировки Playwright, и URL для них: сводку трассировки в формате Markdown (URL digest), описывающую действия попытки и причину сбоя, киноленту, анимированную запись экрана, снимки DOM, сетевые запросы и вложения.
currents-create-sessionЗаписать управляемый вами сеанс браузера как сеанс Currents, чтобы его доказательства можно было просматривать и передавать другим.
currents-add-attachmentsДобавить вложения к сеансу из currents-create-session (передайте sessionId) или к запуску CI (передайте runId): журналы файла спецификации, теста или самого запуска.
currents-list-webhooksПеречислить все вебхуки проекта.
currents-create-share-linkСоздать общедоступную ссылку на результаты тестов, которую любой сможет открыть без входа в систему до истечения срока действия. Назначение "fix" предоставляет контекст сбоя для агента, который будет исправлять тесты, — те же данные, что и currents-get-context, включая нестабильные тесты с соответствующей пометкой. Назначение "report" перечисляет все тесты, их попытки и файлы для пользователя; для сеанса это страница сеанса: статус, ошибка, вложения и трассировка.
currents-create-webhookСоздать вебхук для проекта.
currents-get-webhookПолучить вебхук по ID.
currents-update-webhookОбновить существующий вебхук.
currents-delete-webhookУдалить вебхук.

Навыки

Навыки агентов, которые обучают ИИ-агентов многоэтапным рабочим процессам Currents.

НавыкОписание
browser-evidenceЭкспериментальный навык: докажите, что изменение работает в браузере, которым вы управляли самостоятельно, если тест для запуска отсутствует.
collect-evidenceПокажите, что реализованное вами решение действительно работает, или продемонстрируйте его на основе тестов, выполненных в CI через Currents: ссылка на trace API, сводка trace, filmstrip и снимки доступности которого отображаются в комментарии, а также скриншоты, вложения и видео.
fix-failing-testsИсправьте тесты, завершившиеся с ошибкой в CI, используя результаты, записанные Currents: ошибки, шаги, трассировки, скриншоты и вывод консоли.

Сервер публикует каждый навык как ресурс MCP, поэтому подключённый агент может просматривать список и читать их без локальной копии:

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

Агентам, которые загружают навыки только с диска, всё ещё нужна копия — поместите каталог навыка в расположение навыков агента (например, .claude/skills/ для Claude Code).

Настройка

Ключ API

Получите ключ API Currents, следуя инструкциям здесь.

Использование с 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

Выполните эту команду, чтобы добавить Currents MCP в Claude Code

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

Добавьте следующее, чтобы включить Currents MCP в Claude Desktop (отредактируйте файл 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.

Размещённый сервер не выполняет собственную аутентификацию. Каждый запрос должен содержать ваш ключ API Currents в качестве токена 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.

⚠️ Внимание

Подключая инструменты ИИ (например, через MCP) к Currents, вы предоставляете им доступ к своему ключу API, результатам тестов и метаданным CI. Вы несёте ответственность за проверку используемых ИИ-агентов и сервисов, а также за обеспечение безопасной обработки ими ваших данных.

Ссылки