Currents
официальныйПредоставьте AI-агентам возможность исправлять ошибки тестов Playwright, о которых сообщается в Currents.
Что можно делать с Currents MCP?
- Диагностика сбоев CI — Получайте ошибки, шаги и файлы, связанные с неудачными тестами в запуске, файле спецификации или отдельном тесте, с помощью
currents-get-context. - Просмотр запусков и результатов — Просматривайте и фильтруйте запуски проекта, а затем получайте сведения о запуске, результаты экземпляров спецификаций и исторические результаты тестов по сигнатуре.
- Поиск нестабильных и медленных тестов — Запрашивайте метрики производительности тестов и файлов спецификаций, а также агрегированные тенденции ошибок за выбранный период.
- Управление действиями карантина — Создавайте, включайте, отключайте или удаляйте действия, а также просматривайте тесты и выполнения, на которые они повлияли.
- Сбор свидетельств тестирования — Собирайте скриншоты, видео, трассировки и вложения из запусков CI или создавайте ссылки на трассировки, которыми можно поделиться.
- Управление вебхуками и Jira — Просматривайте, создавайте, обновляйте или удаляйте вебхуки проекта, а также создавайте задачи Jira или связывайте их с тестами из запусков.
Документация
Currents MCP Server
Предоставьте своим ИИ-агентам для написания кода полный доступ к результатам CI-тестов. Currents MCP Server напрямую подключает такие инструменты, как Cursor и Claude, к вашей панели управления Currents, чтобы агенты могли диагностировать нестабильные тесты, выявлять причины сбоев и работать с реальными данными о выполнении — не покидая редактор.
- Запрашивать запуски, файлы спецификаций и результаты отдельных тестов из CI
- Отслеживать тенденции ошибок и показатели производительности всего набора тестов
- Программно управлять правилами карантина, вебхуками и настройками проекта
- Позволять агентам исправлять проблемы на основе фактических результатов тестов, а не догадок
Инструменты
| 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
- Перейдите в Cursor Settings > MCP > Enable
- Добавьте следующее в
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. Вы несёте ответственность за проверку используемых ИИ-агентов и сервисов, а также за обеспечение безопасной обработки ими ваших данных.