Loadster MCP

oficial

Teste de carga e monitoramento sintético. Teste seu site com Playwright, Browser Bots ou Protocol Bots. Use o MCP para criar e executar scripts de teste, configurar testes de carga, analisar resultados de teste e configurar monitores.

GitHubExperimente este MCPPatrocinado

O que você pode fazer com Loadster MCP?

Listar projetos e consultar documentação — Peça para ver seus projetos Loadster ou abra a documentação da API via list_projects e get_documentation.
Criar e editar scripts de teste de carga — Peça ao assistente para escrever, validar ou atualizar scripts usando create_script, validate_script e update_script.
Gerenciar conjuntos de dados e cenários — Crie ou modifique dados de teste e configurações de cenário com create_dataset e create_scenario.
Configurar e revisar monitores — Crie ou verifique o status de monitores e incidentes usando create_monitor e list_incidents.
Analisar relatórios de teste de carga — Consulte resultados de testes anteriores e adicione notas via get_load_test_report e update_load_test_notes.

Documentação

Loadster MCP

O Loadster é uma plataforma de teste de carga e monitoramento em nuvem. Seu servidor integrado de Model Context Protocol (MCP) permite que agentes de IA como Claude, ChatGPT, Codex, Cursor e VS Code escrevam e executem scripts de teste de carga, criem cenários de teste de carga, configurem monitores e analisem resultados na sua conta Loadster.

Este repositório é o local público para conectar-se a esse servidor: trechos de configuração para cada cliente, o plugin do Claude Code e os metadados por trás das listagens do Loadster em diretórios MCP. O servidor em si é hospedado pela Loadster em https://api.loadster.com/mcp, e seu código-fonte não é publicado aqui.

O guia completo e atualizado é o capítulo AI Agents do manual do Loadster. Este README é a versão resumida.

O endpoint MCP do Loadster


URL	`https://api.loadster.com/mcp`
Transporte	HTTP Streamable
Autenticação	OAuth 2.1 (preferencial) ou um token MCP em um cabeçalho `Authorization: Bearer`
Nome no registro	`com.loadster/loadster-mcp`

OAuth é a forma mais fácil de conectar. Clientes que suportam OAuth MCP enviam você ao Loadster para aprovar a conexão no seu navegador, e você pode revisar ou revogar agentes conectados na página AI Agents nas suas configurações do Loadster.

Tokens MCP são para clientes que não suportam OAuth e para trabalhos de CI e agentes scriptados. Crie um no painel do Loadster em Configurações → AI Agents → MCP Tokens, copie-o imediatamente (ele só é exibido uma vez) e envie-o como Authorization: Bearer YOUR_TOKEN. Um token age como você na equipe onde foi criado, então trate-o como uma senha.

Conectando o Claude Code ao Loadster

A forma mais rápida é o plugin deste repositório, que adiciona o servidor MCP do Loadster além de algumas habilidades que codificam um fluxo de trabalho sensato de teste de carga:

/plugin marketplace add loadster/loadster-mcp
/plugin install loadster@loadster

Em seguida, execute /mcp, escolha loadster e aprove a conexão OAuth no seu navegador. Pergunte ao Claude algo como "Liste meus projetos do Loadster" para confirmar que ele consegue acessar sua conta.

Sem o plugin, adicione o servidor diretamente e o Claude Code guiará você pelo OAuth:

claude mcp add --transport http loadster https://api.loadster.com/mcp

Ou com um token MCP, para uso headless:

claude mcp add --transport http loadster https://api.loadster.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

O equivalente no nível de projeto .mcp.json:

{
  "mcpServers": {
    "loadster": {
      "type": "http",
      "url": "https://api.loadster.com/mcp"
    }
  }
}

Conectando o Claude Desktop e o claude.ai ao Loadster

O Claude Desktop e o claude.ai conectam-se a servidores MCP remotos como conectores personalizados, que usam OAuth.

Abra Configurações → Conectores e escolha Adicionar conector personalizado.
Digite um nome e a URL https://api.loadster.com/mcp.
Escolha Conectar e aprove a conexão OAuth do Loadster quando o navegador abrir.
Em uma conversa, abra o menu de ferramentas e ative o conector do Loadster.

Conectando o ChatGPT e o Codex ao Loadster

O ChatGPT na web conecta-se por meio de plugins criados no Modo desenvolvedor (Configurações → Segurança e login). Abra Plugins, adicione uma conexão com a URL https://api.loadster.com/mcp e adicione-a a uma nova conversa pelo menu de ferramentas e aprove a conexão OAuth.

O Codex no aplicativo de desktop do ChatGPT, o CLI do Codex e a extensão do Codex para IDE compartilham uma única configuração:

codex mcp add loadster --url https://api.loadster.com/mcp
codex mcp login loadster

Ou com um token MCP em ~/.codex/config.toml:

[mcp_servers.loadster]
url = "https://api.loadster.com/mcp"
bearer_token_env_var = "LOADSTER_MCP_TOKEN"

Conectando o Cursor ao Loadster

Ou adicione-o a .cursor/mcp.json no seu projeto (ou ~/.cursor/mcp.json para todos os projetos) e aprove a conexão OAuth quando o Cursor conectar pela primeira vez:

{
  "mcpServers": {
    "loadster": {
      "url": "https://api.loadster.com/mcp"
    }
  }
}

Para usar um token MCP em vez disso, adicione "headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" } e defina LOADSTER_MCP_TOKEN no ambiente antes de iniciar o Cursor.

Conectando o VS Code ao Loadster

Ou execute MCP: Add Server na Paleta de Comandos, ou adicione-o a .vscode/mcp.json:

{
  "servers": {
    "loadster": {
      "type": "http",
      "url": "https://api.loadster.com/mcp"
    }
  }
}

Para usar um token MCP, declare uma entrada promptString com "password": true e faça referência a ela em um cabeçalho Authorization. O manual tem o exemplo completo.

Conectando outros clientes MCP ao Loadster

Qualquer cliente que suporte servidores remotos via HTTP Streamable pode conectar da mesma forma. Para clientes que só suportam servidores locais (stdio), a ponte mcp-remote geralmente funciona. Deixe de fora os argumentos --header para que ele execute o fluxo OAuth em vez de usar um token:

{
  "mcpServers": {
    "loadster": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.loadster.com/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

O que um agente pode fazer com o Loadster

O servidor expõe a maior parte do painel do Loadster. Os clientes buscam a lista de ferramentas ao vivo quando conectam, então esta tabela é um mapa da superfície, não a fonte da verdade.

Grupo	Ferramentas
Projetos e documentação	`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 dados	`list_datasets`, `get_dataset`, `create_dataset`, `update_dataset`, `append_dataset_rows`, `delete_dataset`
Cenários e motores	`list_scenarios`, `get_scenario`, `create_scenario`, `update_scenario`, `delete_scenario`, `list_engines`
Relatórios de teste de carga	`list_load_tests`, `get_load_test_report`, `update_load_test_notes`
Monitoramento	`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`
Feedback	`submit_feedback`

Algumas ações são intencionalmente deixadas para humanos. Um agente não pode iniciar ou parar um teste de carga completo, ativar um monitor, gerenciar políticas de notificação ou janelas de manutenção, ou administrar sua equipe, cobrança ou Fuel. Ele prepara tudo e faz a entrega para que você aperte o botão de iniciar.

Cada ferramenta carrega anotações MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), então clientes que as respeitam podem solicitar confirmação antes de gravações e exclusões.

Práticas de segurança para teste de carga com IA

O agente age na sua conta. Ele edita os mesmos scripts, cenários, conjuntos de dados e monitores que sua equipe vê. Alterações em scripts criam revisões que você pode restaurar, mas ainda é uma boa ideia revisar as alterações propostas e manter experimentos em seu próprio projeto.
Teste apenas o que é seu. Aponte scripts apenas para sistemas que você possui ou está autorizado a testar. Executar um script roda um único bot, mas a responsabilidade é sua de qualquer forma.
Limite seu acesso. Use um token por agente ou máquina, nomeie-os claramente e revogue qualquer um que não use mais. Revise as conexões OAuth na página AI Agents.

Suporte

Ajuda com configuração e dúvidas: help@loadster.com
Problemas de segurança: veja SECURITY.md
Problemas com o conteúdo deste repositório (README, plugin ou metadados de diretório): abra uma issue aqui

O que há neste repositório

Caminho	Finalidade
`server.json`	Entrada do Loadster no registro oficial MCP
`glama.json`	Metadados de mantenedor para a listagem no Glama
`.claude-plugin/`, `.mcp.json`, `skills/`	O plugin do Claude Code e seu manifesto de marketplace
`.github/workflows/`	Validação a cada push e publicação no registro em releases

Licença

O conteúdo deste repositório é distribuído sob a Licença MIT. O serviço Loadster em si é regido pelos termos de serviço do Loadster.