Loadster 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 매뉴얼의 AI 에이전트 챕터입니다. 이 README는 짧은 버전입니다.

Loadster MCP 엔드포인트

URL	https://api.loadster.com/mcp
전송 방식	Streamable HTTP
인증	OAuth 2.1(권장) 또는 Authorization: Bearer 헤더의 MCP 토큰
레지스트리 이름	com.loadster/loadster-mcp

OAuth는 연결하는 가장 쉬운 방법입니다. MCP OAuth를 지원하는 클라이언트는 브라우저에서 Loadster로 이동하여 연결을 승인하도록 안내하며, Loadster 설정의 AI 에이전트 페이지에서 연결된 에이전트를 검토하거나 해지할 수 있습니다.

MCP 토큰은 OAuth를 사용할 수 없는 클라이언트와 CI 작업 및 스크립트 에이전트를 위한 것입니다. Loadster 대시보드의 설정 → AI 에이전트 → MCP 토큰에서 생성하고, 즉시 복사하세요(한 번만 표시됩니다). 그런 다음 Authorization: Bearer YOUR_TOKEN으로 보내세요. 토큰은 생성한 팀 내에서 사용자를 대신하여 작동하므로 비밀번호처럼 취급하세요.

Claude Code를 Loadster에 연결하기

가장 빠른 방법은 이 저장소의 플러그인을 사용하는 것입니다. 이 플러그인은 Loadster MCP 서버와 합리적인 부하 테스트 워크플로우를 인코딩하는 몇 가지 스킬을 추가합니다:

/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

또는 헤드리스 사용을 위한 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. 설정 → 커넥터를 열고 사용자 지정 커넥터 추가를 선택하세요.
2. 이름과 URL https://api.loadster.com/mcp을 입력하세요.
3. 연결을 선택하고 브라우저가 열리면 Loadster OAuth 연결을 승인하세요.
4. 대화에서 도구 메뉴를 열고 Loadster 커넥터를 켜세요.

ChatGPT 및 Codex를 Loadster에 연결하기

웹의 ChatGPT는 개발자 모드(설정 → 보안 및 로그인)에서 생성된 플러그인을 통해 연결합니다. 플러그인을 열고 URL https://api.loadster.com/mcp로 연결을 추가한 다음, 도구 메뉴에서 새 대화에 추가하고 OAuth 연결을 승인하세요.

ChatGPT 데스크톱 앱의 Codex, Codex CLI, Codex IDE 확장 프로그램은 하나의 구성을 공유합니다:

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

또는 ~/.codex/config.toml의 MCP 토큰 사용:

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

Cursor를 Loadster에 연결하기

또는 프로젝트의 .cursor/mcp.json에 추가하거나(모든 프로젝트의 경우 ~/.cursor/mcp.json) Cursor가 처음 연결할 때 OAuth 연결을 승인하세요:

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

대신 MCP 토큰을 사용하려면 "headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" }을 추가하고 Cursor를 시작하기 전에 환경에 LOADSTER_MCP_TOKEN을 설정하세요.

VS Code를 Loadster에 연결하기

또는 명령 팔레트에서 MCP: 서버 추가를 실행하거나 .vscode/mcp.json에 추가하세요:

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

MCP 토큰을 사용하려면 promptString 입력을 "password": true로 선언하고 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 대시보드의 대부분을 노출합니다. 클라이언트는 연결 시 실시간 도구 목록을 가져오므로 이 표는 표면의 지도이지 진실의 원천이 아닙니다.

그룹	도구
프로젝트 및 문서	list_projects, 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 부하 테스트를 위한 안전 수칙

• 에이전트는 사용자의 계정에서 작동합니다. 팀이 보는 동일한 스크립트, 시나리오, 데이터셋, 모니터를 편집합니다. 스크립트 변경은 복원할 수 있는 개정을 생성하지만, 제안된 변경 사항을 검토하고 실험을 자체 프로젝트에 유지하는 것이 좋습니다.
• 자신의 것만 테스트하세요. 스크립트를 소유하거나 테스트 권한이 있는 시스템에만 지정하세요. 스크립트를 실행하면 단일 봇이 실행되지만, 어느 쪽이든 책임은 사용자에게 있습니다.
• 접근 범위를 제한하세요. 에이전트나 머신당 하나의 토큰을 사용하고, 명확하게 이름을 지정하고, 더 이상 사용하지 않는 토큰은 해지하세요. AI 에이전트 페이지에서 OAuth 연결을 검토하세요.

지원

• 설정 도움말 및 질문: help@loadster.com
• 보안 문제: SECURITY.md 참조
• 이 저장소의 내용(README, 플러그인 또는 디렉터리 메타데이터) 문제: 여기에 이슈를 여세요

이 저장소의 내용

경로	용도
server.json	공식 MCP 레지스트리의 Loadster 항목
glama.json	Glama 목록의 유지 관리자 메타데이터
.claude-plugin/, .mcp.json, skills/	Claude Code 플러그인 및 마켓플레이스 매니페스트
.github/workflows/	모든 푸시 시 검증 및 릴리스 시 레지스트리 게시

라이선스

이 저장소의 내용은 MIT 라이선스로 배포됩니다. Loadster 서비스 자체는 Loadster 서비스 약관의 적용을 받습니다.