Currents

oficial

Permite 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

Unit Tests

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

Install MCP Server

Herramientas

HerramientaDescripción
currents-list-actionsEnumera todas las acciones de un proyecto con filtros opcionales.
currents-create-actionCrea una acción nueva para un proyecto.
currents-get-actionObtiene una acción por ID.
currents-update-actionActualiza una acción existente.
currents-delete-actionElimina (archiva) una acción.
currents-enable-actionHabilita una acción deshabilitada.
currents-disable-actionDeshabilita una acción activa.
currents-list-affected-testsEnumera las pruebas afectadas por acciones (cuarentena, omisión, etiqueta) de un proyecto dentro de un intervalo de fechas.
currents-get-affected-test-executionsCon 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-executionsCon 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-projectsRecupera los proyectos disponibles en la plataforma Currents.
currents-get-projectObtiene un proyecto por ID.
currents-get-project-insightsObtiene métricas agregadas de ejecuciones y pruebas de un proyecto dentro de un intervalo de fechas.
currents-list-pull-requestsEnumera las tarjetas de solicitudes de incorporación de cambios de un proyecto (ejecuciones agrupadas por meta.pr.id).
currents-list-project-termsEnumera términos del proyecto paginados mediante cursor para un tipo (tag, branch, authorName, etc.).
currents-create-jira-issueCrea 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-issueVincula 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-projectsEnumera los proyectos de Jira disponibles para la integración de la organización.
currents-list-jira-issue-typesEnumera los tipos de incidencias y los campos personalizados de Jira para un proyecto de Jira.
currents-get-runsRecupera una lista de ejecuciones de un proyecto específico con filtros opcionales.
currents-get-run-detailsRecupera 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-runBusca una ejecución mediante parámetros de consulta.
currents-cancel-runCancela una ejecución en curso.
currents-reset-runRestablece los archivos de especificación fallidos de una ejecución para permitir que se vuelvan a ejecutar.
currents-delete-runElimina una ejecución y todos los datos asociados.
currents-cancel-run-github-ciCancela 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-instanceRecupera 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-performanceRecupera 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-performanceRecupera las métricas agregadas de pruebas de un proyecto específico dentro de un intervalo de fechas.
currents-get-tests-signaturesGenera 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-resultsRecupera los resultados históricos de ejecución de una prueba para una firma de prueba específica.
currents-get-contextLlama 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-explorerObtén métricas de errores agregadas de un proyecto dentro de un intervalo de fechas.
currents-get-test-evidenceRecopila 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-linksCrea 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-sessionRegistra 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-attachmentsAñ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-webhooksEnumera todos los webhooks de un proyecto.
currents-create-share-linkCrea 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-webhookCrea un webhook nuevo para un proyecto.
currents-get-webhookObtiene un webhook por su ID.
currents-update-webhookActualiza un webhook existente.
currents-delete-webhookElimina un webhook.

Habilidades

Habilidades de agentes que enseñan a los agentes de IA flujos de trabajo de Currents de varios pasos.

HabilidadDescripción
browser-evidenceExperimental: demuestra que un cambio funciona en un navegador que controlaste tú mismo, cuando no hay ninguna prueba que ejecutar.
collect-evidenceDemuestra 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-testsCorrige 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

  1. Ve a Cursor Settings > MCP > Enable
  2. 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.

Referencias