Servidor MCP de Wopee

Pruebas autónomas impulsadas por IA para tus aplicaciones: conecta Claude, Cursor o cualquier agente de IA compatible con MCP a Wopee.io y genera casos de prueba, historias de usuario y ejecuta pruebas autónomas en segundos.

npx wopee-mcp

Documentación | Página de inicio | Panel de control

Configuración

Requisitos previos

• Node.js (se recomienda v18 o superior)

• Un IDE que soporte MCP (Model Context Protocol), como Cursor o VSCode

Configuración del servidor MCP

Añade este servidor a tu configuración de MCP.

Ejemplo de configuración

{
  "mcpServers": {
    "wopee": {
      "command": "npx wopee-mcp",
      "env": {
        "WOPEE_PROJECT_UUID": "your-project-uuid-here",
        "WOPEE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Variables de entorno requeridas

• WOPEE_PROJECT_UUID - El UUID de tu proyecto en Wopee. Identifica con qué proyecto estás trabajando.

• WOPEE_API_KEY - Tu clave de API de Wopee. Puedes crear una en cmd.wopee.io, en la configuración de tu proyecto.

Variables de entorno opcionales

• WOPEE_API_URL - La URL del endpoint de la API de Wopee. Solo debe especificarse para fines de prueba/desarrollo.

Configuración de proxy corporativo

Si estás detrás de un proxy/VPN corporativo y experimentas tiempos de espera en la conexión, puedes configurar los ajustes del proxy usando variables de entorno estándar:

{
  "mcpServers": {
    "wopee": {
      "command": "npx wopee-mcp",
      "env": {
        "WOPEE_PROJECT_UUID": "your-project-uuid-here",
        "WOPEE_API_KEY": "your-api-key-here",
        "HTTPS_PROXY": "http://your-proxy-server:8080"
      }
    }
  }
}

Variables de entorno de proxy soportadas

• HTTPS_PROXY o https_proxy - URL del servidor proxy para conexiones HTTPS (recomendado)

• HTTP_PROXY o http_proxy - URL del servidor proxy de respaldo

Cómo encontrar tus ajustes de proxy

Si no estás seguro de tus ajustes de proxy, revisa la configuración de tu VS Code (settings.json) para el valor http.proxy, o consulta a tu departamento de TI. Formatos comunes de proxy corporativo:

• http://proxy.company.com:8080

• http://10.x.x.x:8080

• http://usuario:contraseña@proxy.company.com:8080 (si se requiere autenticación)

Problemas de TLS / Certificados

Esto no es necesario para que MCP funcione. Si ves errores relacionados con HTTPS o certificados, eso indica un problema de confianza de TLS o certificados en tu entorno.

Si el servidor falla con errores como UNABLE_TO_VERIFY_LEAF_SIGNATURE o certificate has expired, puede deberse a:

• Certificados autofirmados (p. ej., cuando WOPEE_API_URL apunta a un servidor interno o de desarrollo)

• Proxy corporativo / Inspección SSL (tráfico re-encriptado con una CA corporativa en la que tu máquina no confía)

• Certificados CA faltantes en el almacén de confianza de Node

Soluciones preferidas (seguras)

1. Usa un certificado TLS válido – p. ej., Let’s Encrypt, o una CA interna – y asegúrate de que se sirva la cadena de certificados completa.

2. Instala la CA corporativa o interna para que Node confíe en ella:

   Ejemplo:

   export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/internal-ca.pem

   En la configuración env de MCP:

   "env": {
     "WOPEE_PROJECT_UUID": "your-project-uuid-here",
     "WOPEE_API_KEY": "your-api-key-here",
     "NODE_EXTRA_CA_CERTS": "/path/to/ca.pem"
   }

Solución alternativa insegura (no recomendada)

Solo para depuración local, puedes deshabilitar la verificación TLS en Node. Esto nunca debe usarse en producción, ya que deshabilita la seguridad HTTPS y expone el tráfico a interceptación.

export NODE_TLS_REJECT_UNAUTHORIZED=0

O en la configuración env de MCP:

"env": {
  "WOPEE_PROJECT_UUID": "your-project-uuid-here",
  "WOPEE_API_KEY": "your-api-key-here",
  "NODE_TLS_REJECT_UNAUTHORIZED": "0"
}

Trata esto como una vía de escape solo para depuración, no como un paso de configuración normal.

Nota: Algunos usuarios han reportado configurar también PYTHONHTTPSVERIFY=0. Este servidor MCP no usa Python; esa variable no tiene efecto en él. Solo aplicaría si ejecutas un host MCP basado en Python u otras herramientas que también realicen HTTPS en el mismo entorno, fuera del alcance de este servidor.

Related MCP server: Playwright MCP

Primeros pasos

La mayoría de las herramientas en este servidor MCP requieren un suiteUuid para operar. Tienes dos opciones para empezar:

Opción 1: Usar suites existentes

Comienza obteniendo tus suites de análisis existentes:

Use the wopee_fetch_analysis_suites tool to retrieve all available suites for your project.

Esto devolverá una lista de todas las suites de análisis con sus UUIDs, que luego podrás usar con otras herramientas.

Opción 2: Crear una nueva suite

Si aún no tienes ninguna suite, tienes dos opciones:

Análisis automático: Crea y envía una suite completa de análisis/rastreo:

Use the wopee_dispatch_analysis tool to create and dispatch a new analysis/crawling suite.

Suite en blanco: Crea una suite vacía para configuración manual:

Use the wopee_create_blank_suite tool to create a blank analysis suite.

Ambas opciones devolverán un UUID de suite, que puedes usar para operaciones posteriores.

Herramientas disponibles

Gestión de suites

wopee_fetch_analysis_suites

Obtiene todas las suites de análisis para tu proyecto. Este es un buen punto de partida para ver qué suites están disponibles.

• Retorna: Matriz de suites de análisis con sus UUIDs, nombres, estados y metadatos

Ejemplo de uso:

Fetch all existing analysis suites for my project

wopee_dispatch_analysis

Crea y envía una nueva suite de análisis/rastreo para tu proyecto, o vuelve a ejecutar una existente. Úsalo para iniciar una nueva sesión de análisis o para volver a activar un análisis previo.

• Parámetros:

  • additionalInstructions (opcional) - Instrucciones adicionales para guiar al agente durante la fase de análisis/rastreo (p. ej., áreas de enfoque, cosas a ignorar, pasos de inicio de sesión, etc.)

  • additionalVariables (opcional) - Variables de entorno adicionales para pasar al análisis. Matriz de objetos, cada uno con:

    • key - Nombre de la variable, debe estar en mayúsculas y solo con guiones bajos (p. ej., MY_VAR, BASE_URL)

    • value - Valor de la variable (cadena no vacía)

  • rerun (opcional) - Si se proporciona, vuelve a ejecutar una suite de análisis existente en lugar de crear una nueva. Objeto con:

    • suiteUuid - UUID de la suite existente a reejecutar

    • analysisIdentifier - Identificador de análisis de la suite existente

    • mode - Modo de reejecución: FULL (reejecuta todo el análisis incluyendo rastreo y generación) o CRAWLING (reejecuta solo la fase de rastreo)

• Retorna: Mensaje de éxito con la información de la suite creada/reejecutada

Ejemplo de uso:

Dispatch a new analysis suite

Dispatch a new analysis suite and focus on the checkout flow

Dispatch a new analysis suite with additional variables CARD_FILAMENT=123321123 and AUTH_TOKEN=abc123

Rerun the full analysis for suite <suiteUuid> with analysis identifier <analysisIdentifier>

Rerun only the crawling phase for suite <suiteUuid> with analysis identifier <analysisIdentifier>

wopee_create_blank_suite

Crea una suite de análisis en blanco para tu proyecto. Úsalo cuando quieras configurar y completar manualmente una suite en lugar de que sea analizada automáticamente.

• Retorna: La información de la suite creada incluyendo su UUID

Ejemplo de uso:

Create a blank analysis suite for my project

Herramientas de generación

Estas herramientas generan varios artefactos para una suite específica. Todas requieren un suiteUuid y un type para generar.

wopee_generate_artifact

Genera un archivo (artefacto) específico para la suite seleccionada.

• Parámetros:

  • suiteUuid - El UUID de la suite

  • type - "APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES_WITH_TEST_CASES" | "TEST_CASES" | "TEST_CASE_STEPS" | "REUSABLE_TEST_CASES" | "REUSABLE_TEST_CASE_STEPS"

• Retorna: Salida generada en caso de generación exitosa.

Ejemplo de uso:

Generate app context for my most recent analysis suite

Herramientas de obtención

Estas herramientas recuperan artefactos generados para una suite específica. Todas requieren un suiteUuid y un type.

wopee_fetch_artifact

Obtiene el archivo (artefacto) solicitado de la suite seleccionada.

• Parámetros:

  • suiteUuid - El UUID de la suite

  • type - "APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "PLAYWRIGHT_CODE" | "PROJECT_CONTEXT"

  • identifier - Identificador del caso de prueba para obtener el código de Playwright, ej. US003:TC004

• Retorna: El contenido del archivo en caso de obtención exitosa.

Ejemplo de uso:

Fetch user stories for the latest suite

Herramientas de actualización

Estas herramientas se utilizan para actualizar o establecer ciertos archivos (artefactos) para una suite específica. Se requiere suiteUuid, type y content.

wopee_update_artifact

Actualiza/reemplaza un archivo (artefacto) existente para una suite específica

• Parámetros:

  • suiteUuid - El UUID de la suite

  • type - "APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "PLAYWRIGHT_CODE" | "PROJECT_CONTEXT"

  • content - Contenido Markdown para app context, general user stories y project context, JSON estructurado para user stories

  • identifier - Identificador del caso de prueba para obtener el código de Playwright, ej. US003:TC004

• Retorna: Booleano basado en el estado de éxito de la llamada a la herramienta

Ejemplo de uso:

Update app context file for the most recent suite with this content: <YourMarkdown>

Pruebas de agente

wopee_dispatch_agent

Envía un agente de pruebas autónomo para ejecutar casos de prueba para una suite seleccionada.

• Parámetros:

  • suiteUuid - El UUID de la suite que contiene los casos de prueba

  • analysisIdentifier - El identificador de análisis para la suite

  • testCases - Matriz de objetos de casos de prueba a ejecutar, cada uno conteniendo:

    • testCaseId - El ID del caso de prueba

    • userStoryId - El ID de la historia de usuario asociada

• Retorna: Matriz de objetos de casos de prueba ejecutados con su estado de ejecución inicial (uuid, executionStatus, agentReportStatus, codeReportStatus, etc.)

Ejemplo de uso:

Dispatch agent for my latest suite's user story US001 and test case TC003

Resultados de las pruebas

wopee_fetch_executed_test_cases

Obtiene los casos de prueba ejecutados y sus resultados para una suite de análisis dada. Úsalo para verificar el estado y los informes de las ejecuciones de agentes enviadas.

• Parámetros:

  • suiteUuid - El UUID de la suite de análisis para obtener resultados

  • analysisIdentifier (opcional) - Identificador de análisis para limitar los resultados (p. ej., A068)

• Retorna: Matriz de resultados agrupados por historia de usuario, cada uno conteniendo casos de prueba ejecutados con estado de ejecución, informe del agente, estado del informe del agente, informe de código y estado del informe de código

Ejemplo de uso:

Fetch test results for suite <suiteUuid>

Show me the executed test cases for my latest analysis suite

Flujo de trabajo típico

1. Comienza con una suite:

   • Usa wopee_fetch_analysis_suites para ver las suites existentes, O

   • Usa wopee_dispatch_analysis para crear una nueva suite

2. Genera artefactos:

   • Genera contexto de la aplicación: wopee_generate_artifact con APP_CONTEXT y un suiteUuid específico

   • Genera historias de usuario generales: wopee_generate_artifact con GENERAL_USER_STORIES y un suiteUuid específico

   • Genera historias de usuario con casos de prueba: wopee_generate_artifact con USER_STORIES_WITH_TEST_CASES y un suiteUuid específico

   • Genera casos de prueba reutilizables: wopee_generate_artifact con REUSABLE_TEST_CASES y un suiteUuid específico

   • Genera pasos de casos de prueba reutilizables: wopee_generate_artifact con REUSABLE_TEST_CASE_STEPS y un suiteUuid específico

   • Genera pasos de casos de prueba: wopee_generate_artifact con TEST_CASE_STEPS y un suiteUuid específico

3. Obtén contenido generado:

   • Usa las herramientas de obtención para recuperar archivos markdown/JSON generados

4. Ejecuta pruebas:

   • Usa wopee_dispatch_agent para ejecutar casos de prueba con el agente de pruebas autónomo

5. Verifica resultados:

   • Usa wopee_fetch_executed_test_cases para verificar el estado y los informes de las ejecuciones de agentes enviadas

   • O usa el prompt fetch-test-results para un resumen formateado de todos los resultados de las pruebas

Prompts disponibles

fetch-project-summary

Obtiene las suites de análisis y sus historias de usuario/casos de prueba, luego muestra un resumen formateado con dos tablas markdown: una visión general de la suite y un desglose detallado de los casos de prueba.

fetch-test-results

Obtiene las suites de análisis y los resultados de sus casos de prueba ejecutados, luego muestra tablas markdown formateadas que muestran el estado de ejecución, el estado del informe del agente y el estado del informe de código para cada caso de prueba. También muestra detalles de los informes fallidos.

Notas

• La mayoría de las herramientas requieren un suiteUuid. Comienza siempre obteniendo o creando una suite.

• La herramienta wopee_dispatch_analysis pasará por todo el ciclo de procesamiento: rastrear la aplicación y generar todos los archivos (artefactos) uno por uno.

• Es recomendable usar cmd.wopee.io para una representación visual conveniente de los datos generados y los resultados de las ejecuciones del agente.