Currents
oficialPermite que los Agentes de IA corrijan fallos en pruebas de Playwright reportados a Currents.
¿Qué puedes hacer con Currents MCP?
- Diagnosticar fallos de CI — Obtén los errores, los pasos y los archivos relacionados con las pruebas fallidas de una ejecución, un archivo de especificación o una prueba individual con
currents-get-context. - Inspeccionar ejecuciones y resultados — Enumera y filtra las ejecuciones del proyecto; luego, consulta los detalles de las ejecuciones, los resultados de las instancias de especificación y los resultados históricos de las pruebas por firma.
- Encontrar pruebas inestables y lentas — Consulta las métricas de rendimiento de las pruebas y los archivos de especificación, así como las tendencias agregadas de errores en un intervalo de fechas.
- Gestionar acciones de cuarentena — Crea, habilita, deshabilita o elimina acciones, y enumera las pruebas y ejecuciones a las que afectaron.
- Recopilar evidencias de pruebas — Recopila capturas de pantalla, vídeos, trazas y archivos adjuntos de las ejecuciones de CI, o crea enlaces compartibles a las trazas.
- Gestionar webhooks y Jira — Enumera, crea, actualiza o elimina webhooks del proyecto, y crea o vincula incidencias de Jira a partir de las pruebas de una ejecución.
Documentación
Currents MCP Server
Ofrece a tus agentes de programación con IA visibilidad completa de los resultados de las pruebas de CI. Currents MCP Server conecta herramientas como Cursor y Claude directamente con tu panel de Currents, para que los agentes puedan diagnosticar pruebas inestables, localizar fallos y actuar basándose en datos de ejecución reales, sin salir del editor.
- Consulta ejecuciones, archivos de especificaciones y resultados de pruebas individuales de CI
- Muestra tendencias de errores y métricas de rendimiento en todo el conjunto de pruebas
- Gestiona reglas de cuarentena, webhooks y ajustes del proyecto mediante programación
- Permite que los agentes corrijan lo que falla usando resultados reales de las pruebas, no conjeturas
Herramientas
| Herramienta | Descripción |
|---|---|
currents-list-actions | Enumera todas las acciones de un proyecto con filtros opcionales. |
currents-create-action | Crea una acción nueva para un proyecto. |
currents-get-action | Obtiene una acción por ID. |
currents-update-action | Actualiza una acción existente. |
currents-delete-action | Elimina (archiva) una acción. |
currents-enable-action | Habilita una acción deshabilitada. |
currents-disable-action | Deshabilita una acción activa. |
currents-list-affected-tests | Enumera las pruebas afectadas por acciones (cuarentena, omisión, etiqueta) de un proyecto dentro de un intervalo de fechas. |
currents-get-affected-test-executions | Con una prueba como referencia, enumera las ejecuciones de esa prueba a las que se aplicó una acción dentro de un intervalo de fechas, junto con la ejecución, la rama y el commit de cada una. |
currents-get-action-executions | Con una acción como referencia, enumera las ejecuciones de pruebas a las que se aplicó una regla en todas las pruebas afectadas, dentro de un intervalo de fechas. |
currents-get-projects | Recupera los proyectos disponibles en la plataforma Currents. |
currents-get-project | Obtiene un proyecto por ID. |
currents-get-project-insights | Obtiene métricas agregadas de ejecuciones y pruebas de un proyecto dentro de un intervalo de fechas. |
currents-list-pull-requests | Enumera las tarjetas de solicitudes de incorporación de cambios de un proyecto (ejecuciones agrupadas por meta.pr.id). |
currents-list-project-terms | Enumera términos del proyecto paginados mediante cursor para un tipo (tag, branch, authorName, etc.). |
currents-create-jira-issue | Crea una incidencia de Jira a partir de una prueba de una ejecución mediante la integración de Jira de la organización. |
currents-link-jira-issue | Vincula una incidencia de Jira existente a una prueba de una ejecución mediante la integración de Jira de la organización. |
currents-list-jira-projects | Enumera los proyectos de Jira disponibles para la integración de la organización. |
currents-list-jira-issue-types | Enumera los tipos de incidencias y los campos personalizados de Jira para un proyecto de Jira. |
currents-get-runs | Recupera una lista de ejecuciones de un proyecto específico con filtros opcionales. |
currents-get-run-details | Recupera una ejecución: su estado, commit, rama, grupos y archivos de especificación, cada uno con su instanceId, y cuántos archivos tiene la ejecución por nivel, tipo y origen (attachmentCounts). |
currents-find-run | Busca una ejecución mediante parámetros de consulta. |
currents-cancel-run | Cancela una ejecución en curso. |
currents-reset-run | Restablece los archivos de especificación fallidos de una ejecución para permitir que se vuelvan a ejecutar. |
currents-delete-run | Elimina una ejecución y todos los datos asociados. |
currents-cancel-run-github-ci | Cancela una ejecución mediante el ID de ejecución del flujo de trabajo de GitHub Actions y el número de intento. |
currents-get-spec-instance | Recupera el resultado sin procesar de la ejecución de un archivo de especificación mediante instanceId: el estado y los intentos de cada prueba, y las URL de los artefactos. |
currents-get-spec-files-performance | Recupera las métricas de rendimiento de los archivos de especificación de un proyecto específico dentro de un intervalo de fechas. |
currents-get-tests-performance | Recupera las métricas agregadas de pruebas de un proyecto específico dentro de un intervalo de fechas. |
currents-get-tests-signatures | Genera una firma de prueba única basada en el proyecto, la ruta del archivo de especificación y el título de la prueba. |
currents-get-test-results | Recupera los resultados históricos de ejecución de una prueba para una firma de prueba específica. |
currents-get-context | Llama a esto primero para averiguar por qué fallaron las pruebas en CI o para corregirlas: devuelve los errores, los pasos y los archivos de las pruebas fallidas de una ejecución, un archivo de especificación (instancia) o una prueba; el mismo contenido que Fix en el panel de Currents. |
currents-get-errors-explorer | Obtén métricas de errores agregadas de un proyecto dentro de un intervalo de fechas. |
currents-get-test-evidence | Recopila artefactos de evidencia (capturas de pantalla, vídeos, trazas, archivos adjuntos) generados por las pruebas en una ejecución de CI, con URL de descarga firmadas agrupadas por prueba. |
currents-create-evidence-links | Crea un enlace de API de traza compartible a la evidencia de un intento de prueba, servido desde su traza de Playwright, y las URL correspondientes: un resumen de traza en Markdown (la URL digest) de lo que hizo el intento y de lo que falló, una secuencia de imágenes, una grabación de pantalla animada, instantáneas del DOM, solicitudes de red y archivos adjuntos. |
currents-create-session | Registra una sesión del navegador que hayas controlado como una sesión de Currents, para que su evidencia se pueda leer y compartir. |
currents-add-attachments | Añade archivos adjuntos a una sesión de currents-create-session (envía sessionId) o a una ejecución de CI (envía runId): registros de un archivo de especificación, una prueba o la propia ejecución. |
currents-list-webhooks | Enumera todos los webhooks de un proyecto. |
currents-create-share-link | Crea un enlace público a los resultados de las pruebas que cualquiera puede abrir sin iniciar sesión, hasta que caduque. El propósito "fix" proporciona el contexto del fallo para un agente que corregirá las pruebas: el mismo contenido que currents-get-context, con las pruebas inestables incluidas y marcadas como tales. El propósito "report" enumera todas las pruebas con sus intentos y archivos, para una persona; para una sesión, muestra la página de la sesión: estado, error, archivos adjuntos y traza. |
currents-create-webhook | Crea un webhook nuevo para un proyecto. |
currents-get-webhook | Obtiene un webhook por su ID. |
currents-update-webhook | Actualiza un webhook existente. |
currents-delete-webhook | Elimina un webhook. |
Habilidades
Habilidades de agentes que enseñan a los agentes de IA flujos de trabajo de Currents de varios pasos.
| Habilidad | Descripción |
|---|---|
browser-evidence | Experimental: demuestra que un cambio funciona en un navegador que controlaste tú mismo, cuando no hay ninguna prueba que ejecutar. |
collect-evidence | Demuestra que el trabajo que implementaste realmente funciona, o haz una demostración, a partir de pruebas ejecutadas en CI mediante Currents: un enlace a la API de trazas cuyo resumen de traza, tira de fotogramas y capturas de accesibilidad se muestran dentro de un comentario, además de capturas de pantalla, archivos adjuntos y vídeos. |
fix-failing-tests | Corrige las pruebas que fallaron en CI usando los resultados registrados por Currents: errores, pasos, trazas, capturas de pantalla y salida de la consola. |
El servidor publica cada habilidad como un recurso MCP, por lo que un agente conectado puede enumerarlas y leerlas sin una copia local:
skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md
Los agentes que cargan habilidades solo desde el disco siguen necesitando una copia: coloca el directorio de habilidades
en la ubicación de habilidades del agente (p. ej., .claude/skills/ para Claude
Code).
Configuración
Clave de API
Obtén una clave de API de Currents siguiendo las instrucciones aquí.
Uso con Cursor
- Ve a Cursor Settings > MCP > Enable
- Añade lo siguiente a tu
mcp.json.
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
Claude
Ejecuta este comando para añadir Currents MCP a Claude Code
claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp
Añade lo siguiente para habilitar Currents MCP en Claude Desktop (edita el archivo claude_desktop_config.json):
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
VS Code y GitHub Copilot
Instalar en VS Code añade el servidor alojado. La primera vez que se conecta, VS Code abre una página de inicio de sesión de Currents; no es necesario introducir una clave de API.
Para instalar el complemento, que añade las habilidades además del servidor:
-
VS Code: abre
vscode://chat-plugin/install?source=currents-dev/currents-mcp -
Copilot CLI:
copilot plugin marketplace add currents-dev/currents-mcp copilot plugin install currents@currents
Para añadir solo el servidor a Copilot CLI:
copilot mcp add --transport http currents https://mcp.currents.dev/mcp
Endpoint MCP remoto (alojado)
Además del transporte stdio local anterior, el mismo servidor puede ejecutarse como un endpoint HTTP Streamable alojado (p. ej., https://mcp.currents.dev/mcp) para usarse con conectores remotos
como las aplicaciones web y móviles de Claude.
El servidor alojado no realiza ninguna autenticación propia. Cada solicitud debe incluir tu clave de API de Currents como token Bearer, que se reenvía a la API de Currents:
Authorization: Bearer <your-currents-api-key>
Ejemplo de configuración del cliente (conector remoto):
{
"mcpServers": {
"currents": {
"url": "https://mcp.currents.dev/mcp",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
}
Ejecutar el servidor HTTP por tu cuenta:
# 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
El servidor Node usa HTTP sin cifrar; TLS y el dominio público terminan en el
proxy inverso o balanceador de carga situado delante del contenedor. Se proporciona un endpoint GET /healthz
para comprobar que el servicio está activo.
⚠️ Aviso
Al conectar herramientas de IA (p. ej., mediante MCP) a Currents, les concedes acceso a tu clave de API, los resultados de las pruebas y los metadatos de CI. Es tu responsabilidad evaluar a los agentes o servicios de IA que utilices y asegurarte de que gestionen tus datos de forma segura.