MaxoPerf MCP

https://app.maxoperf.com/mcp

Configuración

Es un servidor remoto y alojado — no hay nada que instalar ni ejecutar. Añádelo a la configuración de tu cliente MCP y establece MAXOPERF_API_KEY (crea una en la consola → Configuración → Claves de API):

{
  "mcpServers": {
    "maxoperf": {
      "type": "http",
      "url": "https://app.maxoperf.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MAXOPERF_API_KEY}"
      }
    }
  }
}

Tu clave se valida en cada llamada mediante la plataforma real (autenticación, tenencia, OpenFGA, auditoría) — el servidor no almacena nada y no añade ningún nuevo límite de confianza. Revoca la clave y el acceso muere al instante. Envía el encabezado X-MaxoPerf-MCP-Mode: read-only para una sesión de solo lectura (las herramientas de escritura quedan ocultas).

Instalación (elige tu cliente)

Claude Code — el plugin incluye el servidor y la habilidad del agente:

/plugin marketplace add MaxoPerf/mcp
/plugin install maxoperf

O añade solo el conector:

claude mcp add --transport http maxoperf https://app.maxoperf.com/mcp \
  --header "Authorization: Bearer ${MAXOPERF_API_KEY}"

Cursor · VS Code / Copilot · Codex · ChatGPT · Claude Desktop — enlaces profundos de un clic y configuración de copiar y pegar en packaging/. Todos usan el mismo bloque mcpServers de arriba.

Herramientas

29 herramientas seleccionadas. Las lecturas usan response_format: "concise" por defecto (pasa "detailed" para la carga completa); las herramientas de escritura requieren una sesión que no sea de solo lectura, y cancel_run está oculta en modo de solo lectura.

Contexto y tenencia

• whoami — Resuelve la cuenta + el espacio de trabajo predeterminado detrás de tu clave de API
• list_workspaces — Lista los espacios de trabajo visibles para la cuenta
• set_active_workspace — Establece el espacio de trabajo activo para la sesión
• list_projects — Lista los proyectos (con permisos de edición/eliminación)
• create_project — Crea un proyecto

Pruebas

• list_tests — Lista las pruebas (filtra por proyecto / espacio de trabajo / tipo)
• get_test — Obtén una prueba + su resumen de validación
• create_test — Crea un esqueleto de prueba (elige el motor/ejecutor)
• get_test_overview — Resumen del historial de ejecuciones de una prueba

Archivos de prueba

• upload_test_file — Sube un archivo de script/datos en una sola llamada (flujo real de 3 pasos con URL prefirmada)
• list_test_files — Lista los archivos de una prueba + estado de subida
• download_test_file — Obtén una URL de descarga de corta duración para un archivo

Ejecuciones

• start_run — Lanza una ejecución de carga/navegador en runners cloud gestionados (idempotente)
• get_run_status — Consulta el estado del ciclo de vida (en cola → en ejecución → aprobada/fallida/cancelada)
• list_runs — Historial de ejecuciones paginado con filtros
• cancel_run — Cancela una ejecución (destructivo; oculto en modo de solo lectura)
• rerun_run — Vuelve a ejecutar desde una instantánea o la prueba actual
• add_runners — Escala una ejecución en vivo en las ubicaciones existentes

Resultados

• get_run_results — Resumen de KPIs: rendimiento, percentiles de latencia, tasa de error
• query_run_metrics — Métricas de series temporales (latencia / rendimiento / errores / carga / salud)
• get_run_errors — Filas de error agrupadas (mensaje / recuento / código)

Diagnóstico — causa raíz y detección de anomalías

• get_run_summary — Resumen ejecutivo + qué criterios de fallo se activaron
• get_run_error_bodies — Cuerpos de solicitud/respuesta de error muestreados + códigos de estado
• get_run_logs — Líneas de registro de motor/sistema a nivel de error
• get_runner_health — Tendencia de CPU/memoria del runner + targetVus vs peakAchievedVus (vuShortfallPct)
• detect_run_anomalies — Escaneo determinista de valores atípicos robustos (mediana/MAD); limitado por terminal, baja tasa de falsos positivos

Vía de escape y descubrimiento

• call_platform_api — Alcanza cualquier endpoint público de /v1/* (secretos, entornos, programaciones, BYOC); admin/interno en lista de denegación, seguro contra SSRF
• get_openapi — El documento OpenAPI público
• search_endpoints — Búsqueda por palabras clave en la API para encontrar el endpoint correcto

Indicaciones

Recetas de texto que codifican la secuencia correcta de herramientas — ideales para clientes solo de chat que no pueden leer un repositorio:

• run-baseline-load-test — Inicia una ejecución de referencia y obsérvala hasta completarse
• diagnose-latency-regression — Compara el p95 entre dos ejecuciones
• summarize-run — Resumen en lenguaje sencillo de una ejecución
• plan-and-build-test — Convierte un objetivo en proyecto → prueba → subida → ejecución
• choose-executor — Recomienda un motor (k6 / JMeter / Playwright / Selenium)
• scan-endpoints-for-hotspots — Clasifica los posibles puntos críticos a partir de una especificación OpenAPI o una lista pegada
• setup-secrets-and-envs — Conecta los secretos del espacio de trabajo + multi-entorno antes de una ejecución
• diagnose-run-failure — Causa raíz clasificada para una ejecución fallida
• explain-run-anomalies — Explica cada valor atípico detectado

Recursos

• maxoperf://openapi — La especificación OpenAPI pública
• maxoperf://run/{id} — Un resumen de informe de ejecución

Pruébalo

• "Haz una prueba de carga de https://api.example.com/checkout con 500 usuarios durante 5 minutos y hazla fallar si el p95 supera los 800 ms."
• "Analiza mi repositorio en busca de los endpoints que más merecen una prueba de carga y luego crea y ejecuta una prueba para el más arriesgado."
• "¿Por qué falló la ejecución run-0000000001? Revisa los errores, los registros y si los runners alcanzaron realmente la carga objetivo."

Combínalo con el cerebro

El servidor MCP son las manos. La habilidad de agente MaxoPerf incluida (npx @maxoperf/agent-skill install, incluida en el plugin de Claude, o en agent-skill/ aquí) es el cerebro — lee tu código, encuentra los puntos críticos, crea y ejecuta la prueba, y diagnostica por qué falló, manejando estas herramientas automáticamente.

Qué hay en este repositorio