Loadster MCP
oficialPruebas de carga y monitoreo sintético. Prueba tu sitio con Playwright, Browser Bots o Protocol Bots. Usa el MCP para crear y ejecutar scripts de prueba, configurar pruebas de carga, analizar resultados de pruebas y configurar monitores.
¿Qué puedes hacer con Loadster MCP?
- Listar proyectos e inspeccionar documentación — Pide ver tus proyectos de Loadster o consulta la documentación de la API mediante
list_projectsyget_documentation. - Crear y editar scripts de pruebas de carga — Haz que el asistente escriba, valide o actualice scripts usando
create_script,validate_scriptyupdate_script. - Gestionar conjuntos de datos y escenarios — Construye o modifica datos de prueba y configuraciones de escenarios con
create_datasetycreate_scenario. - Configurar y revisar monitores — Crea o verifica el estado de monitores e incidentes usando
create_monitorylist_incidents. - Analizar informes de pruebas de carga — Obtén resultados de pruebas anteriores y añade notas mediante
get_load_test_reportyupdate_load_test_notes.
Documentación
Loadster MCP
Loadster es una plataforma de pruebas de carga y monitoreo en la nube. Su servidor integrado de Model Context Protocol (MCP) permite que agentes de IA como Claude, ChatGPT, Codex, Cursor y VS Code escriban y ejecuten scripts de pruebas de carga, creen escenarios de pruebas de carga, configuren monitores y analicen resultados en tu cuenta de Loadster.
Este repositorio es el hogar público para conectarse a ese servidor: fragmentos de configuración para cada cliente, el plugin de Claude Code
y los metadatos detrás de los listados de Loadster en los directorios de MCP. El servidor en sí está alojado por Loadster en
https://api.loadster.com/mcp, y su código fuente no se publica aquí.
La guía completa y mantenida es el capítulo de Agentes de IA del manual de Loadster. Este README es la versión corta.
El endpoint de Loadster MCP
| URL | https://api.loadster.com/mcp |
| Transporte | HTTP transmisible |
| Autenticación | OAuth 2.1 (preferido), o un token MCP en un encabezado Authorization: Bearer |
| Nombre del registro | com.loadster/loadster-mcp |
OAuth es la forma más fácil de conectarse. Los clientes que admiten OAuth de MCP te envían a Loadster para aprobar la conexión en tu navegador, y puedes revisar o revocar agentes conectados en la página Agentes de IA en tu configuración de Loadster.
Los tokens MCP son para clientes que no pueden usar OAuth, y para trabajos de CI y agentes con scripts. Crea uno en el
panel de Loadster en Configuración → Agentes de IA → Tokens MCP, cópialo de inmediato (solo se muestra una vez) y envíalo como
Authorization: Bearer YOUR_TOKEN. Un token actúa como tú dentro del equipo donde lo creaste, así que trátalo como una
contraseña.
Conectando Claude Code a Loadster
La forma más rápida es el plugin de este repositorio, que agrega el servidor MCP de Loadster además de algunas habilidades que codifican un flujo de trabajo sensato de pruebas de carga:
/plugin marketplace add loadster/loadster-mcp
/plugin install loadster@loadster
Luego ejecuta /mcp, elige loadster y aprueba la conexión OAuth en tu navegador. Pregúntale a Claude algo como
"Lista mis proyectos de Loadster" para confirmar que puede acceder a tu cuenta.
Sin el plugin, agrega el servidor directamente y Claude Code te guiará a través de OAuth:
claude mcp add --transport http loadster https://api.loadster.com/mcp
O con un token MCP, para uso sin interfaz:
claude mcp add --transport http loadster https://api.loadster.com/mcp --header "Authorization: Bearer YOUR_TOKEN"
El equivalente a nivel de proyecto .mcp.json:
{
"mcpServers": {
"loadster": {
"type": "http",
"url": "https://api.loadster.com/mcp"
}
}
}
Conectando Claude Desktop y claude.ai a Loadster
Claude Desktop y claude.ai se conectan a servidores MCP remotos como conectores personalizados, que usan OAuth.
- Abre Configuración → Conectores y elige Agregar conector personalizado.
- Ingresa un nombre y la URL
https://api.loadster.com/mcp. - Elige Conectar y aprueba la conexión OAuth de Loadster cuando se abra tu navegador.
- En una conversación, abre el menú de herramientas y activa el conector de Loadster.
Conectando ChatGPT y Codex a Loadster
ChatGPT en la web se conecta a través de plugins creados en modo Desarrollador (Configuración → Seguridad e inicio de sesión).
Abre Plugins, agrega una conexión con la URL https://api.loadster.com/mcp, luego agrégalo a una nueva conversación
desde el menú de herramientas y aprueba la conexión OAuth.
Codex en la aplicación de escritorio de ChatGPT, la CLI de Codex y la extensión de IDE de Codex comparten una configuración:
codex mcp add loadster --url https://api.loadster.com/mcp
codex mcp login loadster
O con un token MCP en ~/.codex/config.toml:
[mcp_servers.loadster]
url = "https://api.loadster.com/mcp"
bearer_token_env_var = "LOADSTER_MCP_TOKEN"
Conectando Cursor a Loadster
O agrégalo a .cursor/mcp.json en tu proyecto (o ~/.cursor/mcp.json para todos los proyectos) y aprueba la conexión OAuth
cuando Cursor se conecte por primera vez:
{
"mcpServers": {
"loadster": {
"url": "https://api.loadster.com/mcp"
}
}
}
Para usar un token MCP en su lugar, agrega "headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" } y establece
LOADSTER_MCP_TOKEN en el entorno antes de iniciar Cursor.
Conectando VS Code a Loadster
O ejecuta MCP: Agregar servidor desde la Paleta de comandos, o agrégalo a .vscode/mcp.json:
{
"servers": {
"loadster": {
"type": "http",
"url": "https://api.loadster.com/mcp"
}
}
}
Para usar un token MCP, declara una entrada promptString con "password": true y haz referencia a ella en un
encabezado Authorization. El manual tiene el
ejemplo completo.
Conectando otros clientes MCP a Loadster
Cualquier cliente que admita servidores remotos sobre HTTP transmisible puede conectarse de la misma manera. Para clientes que solo
admiten servidores locales (stdio), el puente mcp-remote generalmente funciona.
Omite los argumentos --header para que ejecute el flujo OAuth en lugar de usar un token:
{
"mcpServers": {
"loadster": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.loadster.com/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
}
}
}
Lo que un agente puede hacer con Loadster
El servidor expone la mayor parte del panel de Loadster. Los clientes obtienen la lista de herramientas en vivo cuando se conectan, así que esta tabla es un mapa de la superficie más que la fuente de la verdad.
| Grupo | Herramientas |
|---|---|
| Proyectos y documentación | list_projects, get_documentation, get_scripting_api, get_example, list_command_types, get_command_schema, get_variable_schema |
| Scripts | list_scripts, get_script, create_script, update_script, duplicate_script, delete_script, import_script, validate_script, play_script, get_play_status, stop_script, get_step_detail, get_screenshot, list_script_revisions, get_script_revision, restore_script_revision, list_script_assets, get_script_asset, put_script_asset, delete_script_asset |
| Conjuntos de datos | list_datasets, get_dataset, create_dataset, update_dataset, append_dataset_rows, delete_dataset |
| Escenarios y motores | list_scenarios, get_scenario, create_scenario, update_scenario, delete_scenario, list_engines |
| Informes de pruebas de carga | list_load_tests, get_load_test_report, update_load_test_notes |
| Monitoreo | list_monitoring_locations, list_monitors, get_monitor, create_monitor, update_monitor, disable_monitor, delete_monitor, list_monitor_cycles, get_monitor_cycle_detail, get_monitoring_summary, list_incidents, get_incident |
| Comentarios | submit_feedback |
Algunas acciones están intencionalmente reservadas para humanos. Un agente no puede iniciar o detener una prueba de carga completa, habilitar un monitor, gestionar políticas de notificación o ventanas de mantenimiento, ni administrar tu equipo, facturación o Fuel. Prepara todo y te entrega el control para que presiones el botón de inicio.
Cada herramienta lleva anotaciones MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), por lo que
los clientes que las respetan pueden solicitar confirmación antes de escrituras y eliminaciones.
Prácticas de seguridad para pruebas de carga con IA
- El agente actúa en tu cuenta. Edita los mismos scripts, escenarios, conjuntos de datos y monitores que tu equipo ve. Los cambios en scripts crean revisiones que puedes restaurar, pero aun así es buena idea revisar los cambios propuestos y mantener los experimentos en su propio proyecto.
- Solo prueba lo que es tuyo. Apunta los scripts únicamente a sistemas que posees o estás autorizado a probar. Ejecutar un script ejecuta un solo bot, pero es tu responsabilidad de cualquier manera.
- Limita tu acceso. Usa un token por agente o máquina, nómbralos claramente y revoca cualquier token que ya no uses. Revisa las conexiones OAuth en la página de Agentes de IA.
Soporte
- Ayuda de configuración y preguntas: help@loadster.com
- Problemas de seguridad: consulta SECURITY.md
- Problemas con el contenido de este repositorio (el README, el plugin o los metadatos del directorio): abre un issue aquí
Qué hay en este repositorio
| Ruta | Propósito |
|---|---|
server.json | Entrada de Loadster en el Registro oficial de MCP |
glama.json | Metadatos de mantenedor para el listado de Glama |
.claude-plugin/, .mcp.json, skills/ | El plugin de Claude Code y su manifiesto de marketplace |
.github/workflows/ | Validación en cada push y publicación del registro en cada release |
Licencia
El contenido de este repositorio se publica bajo la Licencia MIT. El servicio de Loadster en sí está regido por los términos de servicio de Loadster.