Loadster MCP

Loadster MCP

Loadster 是一個雲端負載測試與監控平台。其內建的 Model Context Protocol (MCP) 伺服器可讓 Claude、ChatGPT、Codex、 Cursor 和 VS Code 等 AI 代理程式撰寫與播放負載測試腳本、建置負載測試情境、設定監控，並分析 您 Loadster 帳戶中的結果。

此儲存庫是連接該伺服器的公開據點：各用戶端的設定片段、Claude Code 外掛，以及 Loadster 在 MCP 目錄中刊登資訊背後的詮釋資料。伺服器本身由 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 以自訂連接器的方式連接到遠端 MCP 伺服器，這些連接器使用 OAuth。

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 橋接器通常可行。 省略 --header 引數，讓它執行 OAuth 流程而非使用權杖：

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

代理程式能透過 Loadster 做什麼

伺服器公開了 Loadster 儀表板的大部分功能。用戶端在連接時會擷取即時工具清單，因此此表 是功能面的概覽，而非唯一依據。Loadster 手冊中的 MCP 工具參考 是從工具定義本身產生的，包含每個工具的參數，以及它是 Read、Write 還是 Sensitive write。

群組	工具
專案與文件	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 負載測試的安全實務

• 代理程式會在您的帳戶中行事。 它會編輯您團隊所見的相同腳本、情境、資料集和監控。 腳本變更會建立可還原的修訂版本，但仍建議檢閱建議的變更，並將 實驗保留在各自的專案中。
• 只測試屬於您的系統。 僅將腳本指向您擁有或獲授權測試的系統。播放腳本會執行 單一機器人，但無論如何都是您的責任。
• 限縮您的存取範圍。 每個代理程式或機器使用一個權杖，清楚命名，並撤銷任何不再使用的權杖。 如果代理程式只需要讀取，請在核准 OAuth 連接時選擇 Read only 而非 Full access （mcp:read 範圍），或在建立權杖時勾選 Read only。如此一來它只能使用 讀取類工具，無法變更任何內容或播放腳本。在 Loadster 設定的 API & MCP 頁面檢閱 OAuth 連接。 請參閱您的助理如何驗證。

支援

• 設定協助與問題：help@loadster.com
• 安全性問題：請參閱 SECURITY.md
• 此儲存庫內容（README、外掛或目錄詮釋資料）的問題：在此開啟 issue

此儲存庫的內容

路徑	用途
server.json	Loadster 在官方 MCP Registry 中的項目
glama.json	Glama 刊登資訊的維護者詮釋資料
.claude-plugin/, .mcp.json, skills/	Claude Code 外掛、其市集資訊清單，以及 setup、setup-script、setup-scenario、setup-monitor、load-test 和 results 技能
.github/workflows/	每次推送時的驗證，以及發行時的登錄發布

授權

此儲存庫的內容依 MIT 授權條款發布。Loadster 服務本身 受 Loadster 服務條款規範。