@assert-click/mcp

Servidor MCP para Assert — permite que tu agente de programación de IA genere, ejecute e inspeccione pruebas E2E sin salir del chat.

Describe un flujo de usuario en lenguaje sencillo. Assert genera una prueba de Playwright, la ejecuta en un navegador real y devuelve resultados a nivel de paso y capturas de pantalla de errores, todo desde una única llamada de herramienta en Cursor, Claude, Windsurf o cualquier agente compatible con MCP.

Regístrate gratis en assert.click para obtener tu clave API y ID de proyecto antes de usar este paquete.

Qué puede hacer tu agente

• Generar — describe un flujo, obtén un escenario en Markdown listo para guardar y ejecutar

• Ejecutar — ejecuta un escenario guardado o Markdown ad-hoc en un navegador Chromium real

• Inspeccionar — obtén resultados de éxito/fallo a nivel de paso, mensajes de error y URLs de capturas de pantalla de fallos

• Listar — explora los escenarios guardados para el proyecto

Requisitos

• Node.js >=18.17

• Una clave de Assert con alcance de proyecto — obtén una en assert.click

Configuración

1. Crea assert.config.json en tu repositorio:

{
  "projectApiKey": "assert_project_key_here",
  "projectId": "project_123"
}

2. Añade el servidor MCP a la configuración de tu agente:

{
  "mcpServers": {
    "assert": {
      "command": "npx",
      "args": ["-y", "@assert-click/mcp"],
      "env": {
        "ASSERT_CONFIG": "/absolute/path/to/assert.config.json"
      }
    }
  }
}

Eso es todo. Tu agente ahora tiene acceso a las cuatro herramientas de Assert.

Variables de entorno

• ASSERT_API_KEY: Clave API (alternativa a guardarla en assert.config.json)

• ASSERT_PROJECT_ID: ID de proyecto predeterminado opcional

• ASSERT_CONFIG: Ruta opcional a un archivo o directorio de configuración

Archivos de configuración

El servidor MCP buscará estos archivos desde el directorio actual hacia arriba:

• assert.config.json

• assert.config.local.json

assert.config.local.json se fusiona sobre assert.config.json.

Si prefieres secretos basados en variables de entorno en lugar de confirmar la clave:

{
  "projectApiKeyEnv": "ASSERT_API_KEY",
  "projectId": "project_123"
}

Herramientas

assert_generate

Genera un escenario en Markdown a partir de una descripción en lenguaje sencillo.

Entrada:

• description: string — qué debería poder hacer el usuario

• url: string — la URL de inicio

• project_id?: string

• save?: boolean — guardar en el proyecto (predeterminado: true)

Devuelve:

{
  "scenario_id": "scenario_123",
  "markdown": "URL: https://example.com/login\nSCENARIO: Login\nPROCESS:\n  - Fill \"email\" with \"user@example.com\"\nEXPECT: Dashboard",
  "saved": true
}

assert_run

Ejecuta un escenario guardado o Markdown ad-hoc en un navegador real.

Entrada:

• scenario_id?: string

• markdown?: string

• project_id?: string

• request_id?: string

Se debe proporcionar exactamente uno de scenario_id o markdown.

Devuelve:

{
  "run_id": "run_123",
  "status": "queued",
  "estimated_duration_seconds": null
}

assert_status

Obtén resultados a nivel de paso para una ejecución.

Entrada:

• run_id: string

Devuelve:

{
  "run_id": "run_123",
  "status": "passed",
  "duration_ms": 4200,
  "steps": [
    {
      "description": "Fill email",
      "status": "passed",
      "error": null,
      "screenshot_url": null
    }
  ],
  "failure_summary": null,
  "full_log_url": null
}

assert_list

Lista los escenarios guardados para un proyecto.

Entrada:

• project_id?: string

• cursor?: string

• limit?: number

Devuelve:

{
  "scenarios": [
    {
      "id": "scenario_123",
      "name": "Login flow",
      "project_id": "project_123",
      "last_run_status": "passed",
      "last_run_at": "2026-03-31T10:00:00.000Z",
      "url": "https://example.com/login"
    }
  ],
  "next_cursor": null
}

Errores

Los errores se devuelven como JSON estructurado:

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The ASSERT_API_KEY is invalid or missing.",
    "field": null
  }
}

Códigos comunes:

• INVALID_API_KEY

• SCENARIO_NOT_FOUND

• RUN_NOT_FOUND

• VALIDATION_ERROR

• UPSTREAM_ERROR

Licencia

MIT