Loadster

Loadster MCP

Loadster は、クラウド型の負荷テストおよびモニタリングプラットフォームです。組み込みの Model Context Protocol（MCP）サーバーを使うと、Claude、ChatGPT、Codex、 Cursor、VS Code などの AI エージェントが、Loadster アカウントで負荷テストスクリプトの作成と実行、負荷テストシナリオの構築、モニターの設定、結果の分析を行えます。

このリポジトリは、このサーバーへの接続に必要な情報を公開する場所です。各クライアント用のセットアップ手順、Claude Code プラグイン、MCP ディレクトリに掲載されている Loadster のエントリー情報を提供します。サーバー自体は Loadster が https://api.loadster.com/mcp でホストしており、そのソースはここでは公開されていません。Loadster は、 ChatGPT と Codex のプラグインディレクトリにも公式プラグインとして掲載されています。

最新の完全版ガイドは、Loadster マニュアルの「AI アシスタントと MCP」の章です。 この README は短縮版です。

Loadster MCP エンドポイント

URL	https://api.loadster.com/mcp
トランスポート	Streamable HTTP
認証	OAuth 2.1（推奨）、または Authorization: Bearer ヘッダー内の個人用アクセストークン
レジストリ名	com.loadster/loadster-mcp

OAuth が最も簡単な接続方法です。MCP OAuth に対応したクライアントでは、ブラウザーで Loadster に移動して接続を承認できます。また、Loadster の設定にある API & MCP ページで、接続済みのエージェントを確認したり、接続を取り消したりできます。

個人用アクセストークンは、OAuth に対応していないクライアントや、CI ジョブ、スクリプト化されたエージェント向けです。同じ種類のトークンを使って、Loadster REST API を直接呼び出すこともできます。Loadster ダッシュボードの Settings → API & MCP → Personal Access Tokens でトークンを作成し、すぐにコピーしてください（表示されるのは一度だけです）。Authorization: Bearer YOUR_TOKEN として送信します。トークンは、作成したチーム内であなたとして動作するため、パスワードと同様に扱ってください。

Claude Code を Loadster に接続する

最も手早い方法は、このリポジトリのプラグインを使うことです。Loadster MCP サーバーに加え、適切な負荷テストのワークフローに役立つスキルが追加されます。setup は接続用、setup-script は最初のスクリプト用、setup-scenario は最初の負荷テストシナリオ用、setup-monitor は最初の合成モニター用、load-test はテスト全体用、results は実行結果の確認用です。

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

次に /mcp を実行して loadster を選び、ブラウザーで OAuth 接続を承認します。Claude がアカウントにアクセスできることを確認するには、「Loadster のプロジェクトを一覧表示して」 などと尋ねてください。

プラグインを使わない場合は、サーバーを直接追加できます。Claude Code が OAuth の手順を案内します。

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

または、ヘッドレス環境で個人用アクセストークンを使う場合：

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

同等のプロジェクトレベルの .mcp.json：

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

Claude Desktop と claude.ai を Loadster に接続する

Claude Desktop と claude.ai は、OAuth を使うカスタムコネクタとしてリモート MCP サーバーに接続します。

1. Settings → Connectors を開き、Add custom connector を選択します。
2. 名前と URL https://api.loadster.com/mcp を入力します。
3. Connect を選択し、ブラウザーが開いたら Loadster の OAuth 接続を承認します。
4. 会話中にツールメニューを開き、Loadster コネクタを有効にします。

ChatGPT と Codex を Loadster に接続する

Loadster は、ChatGPT と Codex のプラグインディレクトリにある公式プラグインで、setup、load-test、results のスキルを利用できます。新しい setup-script、setup-scenario、setup-monitor のスキルは、ディレクトリの一覧が更新されると利用できるようになります。

• ChatGPT： Loadster プラグインを開き、Install plugin を選択してから Connect を選び、Loadster の OAuth 接続を承認します。@Loadster との会話を開始します。Business または Enterprise のワークスペースでは、管理者が最初に Workspace settings → Plugins で利用可能にする必要がある場合があります。
• Codex： Codex デスクトップアプリの Plugins タブから Loadster をインストールするか、Codex CLI で /plugins を実行してから、新しいセッションを開始します。

Codex IDE 拡張機能はプラグインをサポートしていないため、Codex の MCP 設定を通じて接続します。この設定はデスクトップアプリと CLI で共有されます。

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

または、~/.codex/config.toml で個人用アクセストークンを使用します。

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

ChatGPT アカウントでプラグインを利用できない場合でも、Developer mode（Settings → Security and login）で Loadster をカスタム接続として追加できます。Plugins を開き、URL https://api.loadster.com/mcp で接続を追加してから、ツールメニューから新しい会話に追加し、OAuth 接続を承認します。

Cursor を Loadster に接続する

または、プロジェクト内の .cursor/mcp.json（すべてのプロジェクトに適用する場合は ~/.cursor/mcp.json）に追加し、Cursor が初めて接続するときに OAuth 接続を承認します。

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

代わりに個人用アクセストークンを使用するには、"headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" } を追加し、Cursor を起動する前に環境変数 LOADSTER_MCP_TOKEN を設定します。

VS Code を Loadster に接続する

または、コマンドパレットから MCP: Add Server を実行するか、.vscode/mcp.json に追加します。

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

個人用アクセストークンを使用するには、"password": true を指定した promptString 入力を宣言し、Authorization ヘッダーで参照します。マニュアルに完全な例があります。

他の MCP クライアントを Loadster に接続する

Streamable HTTP 経由のリモートサーバーをサポートするクライアントであれば、同じ方法で接続できます。ローカル（stdio）サーバーのみをサポートするクライアントでは、通常、mcp-remote ブリッジが使えます。トークンを使用せず OAuth フローを実行するには、--header 引数を省略します。

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

エージェントが Loadster でできること

サーバーは Loadster ダッシュボードの大部分を公開します。クライアントは接続時に最新のツール一覧を取得するため、この表は正確な情報源ではなく、利用できる機能の概要です。Loadster のマニュアルにある MCP ツールリファレンス は、各ツールの定義をもとに生成されており、各ツールのパラメーターと、それが読み取り、書き込み、または機密情報の書き込みのいずれに該当するかが記載されています。

グループ	ツール
プロジェクトとドキュメント	list_projects, create_project, get_documentation, get_scripting_api, get_example, list_command_types, get_command_schema, get_variable_schema
スクリプト	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
データセット	list_datasets, get_dataset, create_dataset, update_dataset, append_dataset_rows, delete_dataset
シナリオとエンジン	list_scenarios, get_scenario, create_scenario, update_scenario, delete_scenario, list_engines
負荷テストレポート	list_load_tests, get_load_test_report, update_load_test_notes
モニタリング	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
フィードバック	submit_feedback

一部の操作は、意図的に人間に委ねられています。エージェントは、負荷テスト全体の開始や停止、モニターの有効化、通知ポリシーやメンテナンス時間帯の管理、チーム、請求、Fuel の管理を行うことはできません。準備をすべて整えて引き継ぐため、最後に開始ボタンを押すのはユーザーです。

各ツールには MCP アノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）が付与されています。これらに対応するクライアントでは、書き込みや削除の前に確認を求めることができます。

AI による負荷テストの安全な実施

• エージェントはユーザーのアカウントで操作します。 チームに表示されるものと同じスクリプト、シナリオ、データセット、モニターを編集します。スクリプトの変更はリビジョンとして保存され、復元できますが、提案された変更を確認し、実験は専用のプロジェクトで行うことをお勧めします。
• 自分が所有するものだけをテストしてください。 スクリプトの実行先は、自分が所有するシステム、またはテストを許可されているシステムに限ってください。スクリプトを再生するとボットが 1 つ実行されますが、いずれの場合も責任はユーザーにあります。
• アクセス範囲を限定してください。 エージェントまたはマシンごとにトークンを 1 つ使用し、わかりやすい名前を付け、使わなくなったトークンは失効させてください。エージェントに読み取りだけを許可する場合は、OAuth 接続の承認時に Full access ではなく Read only を選択して（mcp:read スコープ）、またはトークンの作成時に Read only を選択してください。そうすると、読み取りを行うツールだけを使用でき、変更やスクリプトの再生はできません。Loadster の設定にある API & MCP ページで OAuth 接続を確認してください。アシスタントの認証方法をご覧ください。

サポート

• セットアップのサポートと質問：[email protected]
• セキュリティ上の問題：SECURITY.mdをご覧ください
• このリポジトリの内容（README、プラグイン、ディレクトリのメタデータ）に関する問題：こちらで issue を作成してください

このリポジトリの内容

パス	目的
server.json	公式 MCP レジストリに登録された Loadster のエントリー
glama.json	Glama の掲載情報に関するメンテナーのメタデータ
.claude-plugin/、.mcp.json、skills/	Claude Code プラグイン、そのマーケットプレイスマニフェスト、および setup、setup-script、setup-scenario、setup-monitor、load-test、results の各スキル
.github/workflows/	プッシュごとの検証と、リリース時のレジストリへの公開

ライセンス

このリポジトリの内容は、MIT Licenseに基づいて公開されています。Loadster サービス自体は、 Loadster の利用規約に準拠します。