Loadster MCP

Loadster MCP

Loadster é uma plataforma de testes de carga e monitoramento em nuvem. Seu servidor Model Context Protocol (MCP) integrado 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 lar público para se conectar 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 nos diretórios MCP. O servidor em si é hospedado pelo Loadster em https://api.loadster.com/mcp, e seu código-fonte não é publicado aqui. O Loadster também é um plugin oficial no diretório de plugins do ChatGPT e Codex.

O guia completo e mantido é o capítulo AI Assistants & MCP do manual do Loadster. Este README é a versão resumida.

O endpoint MCP do Loadster

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

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

Tokens de acesso pessoal são para clientes que não conseguem usar OAuth, e para jobs de CI e agentes com script. O mesmo tipo de token também funciona para chamar a API REST do Loadster diretamente. Crie um no painel do Loadster em Settings → API & MCP → Personal Access Tokens, copie-o imediatamente (ele só é exibido uma vez) e envie-o como Authorization: Bearer YOUR_TOKEN. Um token age como você dentro da equipe em que 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 mais skills para um fluxo de trabalho de teste de carga sensato: setup para conectar, setup-script para um primeiro script, setup-scenario para um primeiro cenário de teste de carga, setup-monitor para um primeiro monitor sintético, load-test para um teste completo e results para ler o que aconteceu.

/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. Peça 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 de acesso pessoal, para uso headless:

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

O equivalente em nível de projeto no .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 se conectam a servidores MCP remotos como conectores personalizados, que usam OAuth.

1. Abra Settings → Connectors e escolha Add custom connector.
2. Insira um nome e a URL https://api.loadster.com/mcp.
3. Escolha Connect e aprove a conexão OAuth do Loadster quando o navegador abrir.
4. Em uma conversa, abra o menu de ferramentas e ative o conector Loadster.

Conectando o ChatGPT e o Codex ao Loadster

O Loadster é um plugin oficial no diretório de plugins do ChatGPT e Codex, com as skills setup, load-test e results. As novas skills setup-script, setup-scenario e setup-monitor o alcançam quando a listagem do diretório for atualizada.

• ChatGPT: abra o plugin Loadster, escolha Install plugin, depois Connect e aprove a conexão OAuth do Loadster. Inicie uma conversa com @Loadster. Em um workspace Business ou Enterprise, um administrador pode precisar torná-lo disponível em Workspace settings → Plugins primeiro.
• Codex: instale o Loadster na aba Plugins do aplicativo desktop do Codex, ou execute /plugins no Codex CLI, e então inicie uma nova sessão.

A extensão de IDE do Codex não suporta plugins, então ela se conecta pela configuração MCP do Codex, que o aplicativo desktop e a CLI compartilham:

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

Ou com um token de acesso pessoal em ~/.codex/config.toml:

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

Se o plugin não estiver disponível na sua conta ChatGPT, você ainda pode adicionar o Loadster como uma conexão personalizada no Modo desenvolvedor (Settings → Security and login). Abra Plugins, adicione uma conexão com a URL https://api.loadster.com/mcp, depois adicione-a a uma nova conversa pelo menu de ferramentas e aprove a conexão OAuth.

Conectando o Cursor ao Loadster

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

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

Para usar um token de acesso pessoal 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 Command Palette, ou adicione-o ao .vscode/mcp.json:

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

Para usar um token de acesso pessoal, declare uma entrada promptString com "password": true e referencie-a em um cabeçalho Authorization. O manual tem o exemplo completo.

Conectando outros clientes MCP ao Loadster

Qualquer cliente que suporte servidores remotos via Streamable HTTP pode se conectar da mesma forma. Para clientes que só suportam servidores locais (stdio), a ponte mcp-remote geralmente funciona. Omita 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 se conectam, então esta tabela é um mapa da superfície, e não a fonte da verdade. A referência de ferramentas MCP no manual do Loadster é gerada a partir das próprias definições das ferramentas, com os parâmetros de cada ferramenta e se ela é Read, Write ou Sensitive write.

Grupo	Ferramentas
Projetos e documentação	list_projects, create_project, 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
Datasets	list_datasets, get_dataset, create_dataset, update_dataset, append_dataset_rows, delete_dataset
Cenários e engines	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, nem administrar sua equipe, cobrança ou Fuel. Ele deixa tudo pronto e passa a bola para você apertar o botão de iniciar.

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

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

• O agente age na sua conta. Ele edita os mesmos scripts, cenários, datasets 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 você não use mais. Se um agente só precisa ler, escolha Read only em vez de Full access quando aprovar a conexão OAuth (o escopo mcp:read), ou marque Read only quando criar um token. Ele então poderá usar apenas as ferramentas que leem, e não poderá alterar nada nem executar scripts. Revise as conexões OAuth na página API & MCP nas configurações do seu Loadster. Veja How Your Assistant Authenticates.

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 (o README, o plugin ou os metadados do diretório): abra uma issue aqui

O que há neste repositório

Caminho	Finalidade
server.json	A 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, seu manifesto de marketplace e as skills setup, setup-script, setup-scenario, setup-monitor, load-test e results
.github/workflows/	Validação a cada push, e publicação no registro a cada release

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.