Loadster MCP

Loadster MCP

Loadster ist eine Cloud-Plattform für Lasttests und Monitoring. Der integrierte Model Context Protocol-Server (MCP) ermöglicht KI-Agenten wie Claude, ChatGPT, Codex, Cursor und VS Code, Lasttest-Skripte zu schreiben und abzuspielen, Lasttest-Szenarien zu erstellen, Monitore einzurichten und Ergebnisse in deinem Loadster-Konto zu analysieren.

Dieses Repository ist die öffentliche Anlaufstelle für die Verbindung mit diesem Server: Einrichtungs-Snippets für jeden Client, das Claude-Code- Plugin und die Metadaten hinter den Loadster-Einträgen in MCP-Verzeichnissen. Der Server selbst wird von Loadster unter https://api.loadster.com/mcp gehostet, und sein Quellcode wird hier nicht veröffentlicht. Loadster ist außerdem ein offizielles Plugin im ChatGPT- und Codex-Plugin-Verzeichnis.

Die gepflegte, ausführliche Anleitung ist das Kapitel „AI Assistants & MCP“ im Loadster-Handbuch. Diese README ist die Kurzfassung.

Der Loadster-MCP-Endpunkt

URL	https://api.loadster.com/mcp
Transport	Streamable HTTP
Authentifizierung	OAuth 2.1 (bevorzugt) oder ein persönliches Zugriffstoken in einem Authorization: Bearer-Header
Registry-Name	com.loadster/loadster-mcp

OAuth ist der einfachste Weg, sich zu verbinden. Clients, die MCP-OAuth unterstützen, leiten dich zu Loadster weiter, damit du die Verbindung in deinem Browser genehmigen kannst, und du kannst verbundene Agenten auf der Seite API & MCP in deinen Loadster- Einstellungen überprüfen oder widerrufen.

Persönliche Zugriffstoken sind für Clients gedacht, die kein OAuth können, sowie für CI-Jobs und skriptgesteuerte Agenten. Dieselbe Art von Token funktioniert auch für direkte Aufrufe der Loadster-REST-API. Erstelle eines im Loadster-Dashboard unter Einstellungen → API & MCP → Persönliche Zugriffstoken, kopiere es sofort (es wird nur einmal angezeigt) und sende es als Authorization: Bearer YOUR_TOKEN. Ein Token handelt in deinem Namen innerhalb des Teams, in dem du es erstellt hast, also behandle es wie ein Passwort.

Claude Code mit Loadster verbinden

Am schnellsten geht es mit dem Plugin aus diesem Repository, das den Loadster-MCP-Server sowie Skills für einen sinnvollen Lasttest-Workflow hinzufügt: setup zum Verbinden, setup-script für ein erstes Skript, setup-scenario für ein erstes Lasttest-Szenario, setup-monitor für einen ersten synthetischen Monitor, load-test für einen vollständigen Test und results zum Nachlesen, was passiert ist.

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

Führe dann /mcp aus, wähle loadster und genehmige die OAuth-Verbindung in deinem Browser. Frage Claude etwas wie „Liste meine Loadster-Projekte auf“, um zu bestätigen, dass es auf dein Konto zugreifen kann.

Ohne das Plugin fügst du den Server direkt hinzu, und Claude Code führt dich durch OAuth:

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

Oder mit einem persönlichen Zugriffstoken für den Headless-Betrieb:

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

Die entsprechende .mcp.json auf Projektebene:

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

Claude Desktop und claude.ai mit Loadster verbinden

Claude Desktop und claude.ai verbinden sich als benutzerdefinierte Konnektoren mit entfernten MCP-Servern, die OAuth verwenden.

1. Öffne Einstellungen → Konnektoren und wähle Benutzerdefinierten Konnektor hinzufügen.
2. Gib einen Namen und die URL https://api.loadster.com/mcp ein.
3. Wähle Verbinden und genehmige die Loadster-OAuth-Verbindung, wenn sich dein Browser öffnet.
4. Öffne in einer Unterhaltung das Werkzeugmenü und aktiviere den Loadster-Konnektor.

ChatGPT und Codex mit Loadster verbinden

Loadster ist ein offizielles Plugin im ChatGPT- und Codex-Plugin-Verzeichnis, mit den Skills setup, load-test und results. Die neuen Skills setup-script, setup-scenario und setup-monitor erreichen es, sobald der Verzeichnis- Eintrag aktualisiert wird.

• ChatGPT: Öffne das Loadster-Plugin, wähle Plugin installieren, dann Verbinden und genehmige die Loadster-OAuth-Verbindung. Starte eine Unterhaltung mit @Loadster. In einem Business- oder Enterprise-Workspace muss ein Administrator es möglicherweise zuerst unter Workspace-Einstellungen → Plugins verfügbar machen.
• Codex: Installiere Loadster über den Tab Plugins in der Codex-Desktop-App oder führe /plugins in der Codex-CLI aus und starte dann eine neue Sitzung.

Die Codex-IDE-Erweiterung unterstützt keine Plugins, daher verbindet sie sich über die MCP-Konfiguration von Codex, die sich die Desktop- App und die CLI teilen:

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

Oder mit einem persönlichen Zugriffstoken in ~/.codex/config.toml:

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

Wenn das Plugin in deinem ChatGPT-Konto nicht verfügbar ist, kannst du Loadster trotzdem als benutzerdefinierte Verbindung im Entwicklermodus (Einstellungen → Sicherheit und Anmeldung) hinzufügen. Öffne Plugins, füge eine Verbindung mit der URL https://api.loadster.com/mcp hinzu, füge sie dann aus dem Werkzeugmenü zu einer neuen Unterhaltung hinzu und genehmige die OAuth- Verbindung.

Cursor mit Loadster verbinden

Oder füge es zu .cursor/mcp.json in deinem Projekt hinzu (oder zu ~/.cursor/mcp.json für alle Projekte) und genehmige die OAuth- Verbindung, wenn Cursor sich zum ersten Mal verbindet:

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

Um stattdessen ein persönliches Zugriffstoken zu verwenden, füge "headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" } hinzu und setze LOADSTER_MCP_TOKEN in der Umgebung, bevor du Cursor startest.

VS Code mit Loadster verbinden

Oder führe MCP: Server hinzufügen über die Befehlspalette aus oder füge es zu .vscode/mcp.json hinzu:

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

Um ein persönliches Zugriffstoken zu verwenden, deklariere eine promptString-Eingabe mit "password": true und referenziere sie in einem Authorization-Header. Das Handbuch enthält das vollständige Beispiel.

Andere MCP-Clients mit Loadster verbinden

Jeder Client, der entfernte Server über Streamable HTTP unterstützt, kann sich auf dieselbe Weise verbinden. Für Clients, die nur lokale (stdio) Server unterstützen, funktioniert in der Regel die Brücke mcp-remote. Lass die --header-Argumente weg, damit sie stattdessen den OAuth-Ablauf ausführt, anstatt ein Token zu verwenden:

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

Was ein Agent mit Loadster tun kann

Der Server stellt den größten Teil des Loadster-Dashboards bereit. Clients rufen die aktuelle Werkzeugliste beim Verbinden ab, daher ist diese Tabelle eine Übersicht der Oberfläche und nicht die maßgebliche Quelle. Die MCP-Werkzeugreferenz im Loadster-Handbuch wird aus den Werkzeugdefinitionen selbst generiert, mit den Parametern jedes Werkzeugs und der Angabe, ob es ein Read, Write oder Sensitive write ist.

Gruppe	Werkzeuge
Projekte und Dokumentation	list_projects, create_project, get_documentation, get_scripting_api, get_example, list_command_types, get_command_schema, get_variable_schema
Skripte	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
Datensätze	list_datasets, get_dataset, create_dataset, update_dataset, append_dataset_rows, delete_dataset
Szenarien und Engines	list_scenarios, get_scenario, create_scenario, update_scenario, delete_scenario, list_engines
Lasttest-Berichte	list_load_tests, get_load_test_report, update_load_test_notes
Monitoring	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

Einige Aktionen sind bewusst Menschen vorbehalten. Ein Agent kann keinen vollständigen Lasttest starten oder stoppen, keinen Monitor aktivieren, keine Benachrichtigungsrichtlinien oder Wartungsfenster verwalten und auch nicht dein Team, deine Abrechnung oder Fuel administrieren. Er bereitet alles vor und übergibt, damit du den Startknopf drückst.

Jedes Werkzeug trägt MCP-Annotationen (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), sodass Clients, die diese berücksichtigen, vor Schreib- und Löschvorgängen nachfragen können.

Sicherheitspraktiken für KI-Lasttests

• Der Agent handelt in deinem Konto. Er bearbeitet dieselben Skripte, Szenarien, Datensätze und Monitore, die dein Team sieht. Skriptänderungen erzeugen Revisionen, die du wiederherstellen kannst, aber es ist trotzdem ratsam, vorgeschlagene Änderungen zu prüfen und Experimente in einem eigenen Projekt zu halten.
• Teste nur, was dir gehört. Richte Skripte nur auf Systeme, die dir gehören oder die du testen darfst. Das Abspielen eines Skripts führt einen einzelnen Bot aus, aber die Verantwortung liegt in jedem Fall bei dir.
• Beschränke deinen Zugriff. Verwende ein Token pro Agent oder Maschine, benenne sie klar und widerrufe alle, die du nicht mehr verwendest. Wenn ein Agent nur lesen muss, wähle Nur Lesen statt Vollzugriff, wenn du die OAuth- Verbindung genehmigst (der Scope mcp:read), oder aktiviere Nur Lesen, wenn du ein Token erstellst. Es kann dann nur die Werkzeuge verwenden, die lesen, und kann nichts ändern oder Skripte abspielen. Überprüfe OAuth-Verbindungen auf der Seite API & MCP in deinen Loadster-Einstellungen. Siehe Wie sich dein Assistent authentifiziert.

Support

• Hilfe bei der Einrichtung und Fragen: help@loadster.com
• Sicherheitsprobleme: siehe SECURITY.md
• Probleme mit den Inhalten dieses Repositorys (die README, das Plugin oder die Verzeichnis-Metadaten): eröffne hier ein Issue

Was in diesem Repository enthalten ist

Pfad	Zweck
server.json	Loadsters Eintrag in der offiziellen MCP-Registry
glama.json	Maintainer-Metadaten für den Glama-Eintrag
.claude-plugin/, .mcp.json, skills/	Das Claude-Code-Plugin, sein Marketplace-Manifest und die Skills setup, setup-script, setup-scenario, setup-monitor, load-test und results
.github/workflows/	Validierung bei jedem Push und Veröffentlichung in der Registry bei einem Release

Lizenz

Die Inhalte dieses Repositorys werden unter der MIT-Lizenz veröffentlicht. Der Loadster-Dienst selbst unterliegt den Nutzungsbedingungen von Loadster.