Loadster MCP

공식

부하 테스트 및 합성 모니터링. Playwright, Browser Bots 또는 Protocol Bots로 사이트를 테스트하세요. MCP를 사용하여 테스트 스크립트를 작성하고 실행하며, 부하 테스트를 구성하고, 테스트 결과를 분석하고, 모니터를 설정할 수 있습니다.

GitHub

Loadster MCP(으)로 무엇을 할 수 있나요?

스크립트 작성 및 실행 — Loadster 부하 테스트 스크립트를 생성, 업데이트, 검증 및 실행하고, 실행 상태와 단계 세부 정보를 확인합니다.
시나리오 구축 — 부하 테스트 시나리오를 생성 및 업데이트하고 사용 가능한 엔진을 나열합니다.
모니터 설정 — 합성 모니터를 생성 및 업데이트하고, 모니터링 위치를 나열하며, 모니터 주기와 인시던트를 검토합니다.
결과 분석 — 부하 테스트를 나열하고, 부하 테스트 보고서를 읽으며, 부하 테스트 노트를 업데이트합니다.
데이터셋 관리 — 데이터셋을 생성하고, 행을 추가하며, 기존 데이터셋을 업데이트하거나 삭제합니다.
연결 및 액세스 확인 — OAuth 또는 개인 액세스 토큰을 사용하여 https://api.loadster.com/mcp를 통해 연결한 다음, 에이전트에게 프로젝트 목록을 요청합니다.

문서

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 서버에 연결합니다.

Settings → Connectors를 열고 Add custom connector를 선택합니다.
이름과 URL https://api.loadster.com/mcp을 입력합니다.
Connect를 선택하고 브라우저가 열리면 Loadster OAuth 연결을 승인합니다.
대화에서 도구 메뉴를 열고 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 확장은 플러그인을 지원하지 않으므로, 데스크톱 앱과 CLI가 공유하는 Codex의 MCP 구성을 통해 연결합니다:

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 계정에서 플러그인을 사용할 수 없는 경우에도 개발자 모드(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 도구 참조는 도구 정의 자체에서 생성되며, 각 도구의 매개변수와 해당 도구가 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 연결을 승인할 때 Full access 대신 Read only를 선택하거나 (mcp:read 스코프), 토큰을 생성할 때 Read only를 선택하세요. 그러면 읽기만 하는 도구만 사용할 수 있고, 아무것도 변경하거나 스크립트를 재생할 수 없습니다. Loadster 설정의 API & MCP 페이지에서 OAuth 연결을 검토하세요. 어시스턴트의 인증 방식을 참고하세요.

지원

설정 도움말 및 질문: help@loadster.com
보안 문제: SECURITY.md 참고
이 저장소의 내용(README, 플러그인, 디렉터리 메타데이터) 관련 문제: 이곳에 이슈를 등록하세요

이 저장소의 내용

경로	용도
`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 라이선스에 따라 배포됩니다. Loadster 서비스 자체는 Loadster 서비스 약관의 적용을 받습니다.