Loadster MCP

Loadster MCP

Loadster — это облачная платформа для нагрузочного тестирования и мониторинга. Встроенный Model Context Protocol (MCP) сервер позволяет ИИ-агентам, таким как Claude, ChatGPT, Codex, Cursor и VS Code, писать и запускать скрипты нагрузочных тестов, создавать сценарии нагрузочного тестирования, настраивать мониторы и анализировать результаты в вашем аккаунте Loadster.

Этот репозиторий — публичное место для подключения к этому серверу: примеры настройки для каждого клиента, плагин Claude Code и метаданные, лежащие в основе списков Loadster в каталогах MCP. Сам сервер размещается Loadster по адресу https://api.loadster.com/mcp, и его исходный код здесь не публикуется.

Поддерживаемое полное руководство — это глава «AI Agents» из руководства Loadster. Этот README — краткая версия.

Конечная точка MCP Loadster

URL	https://api.loadster.com/mcp
Транспорт	Streamable HTTP
Аутентификация	OAuth 2.1 (предпочтительно) или MCP-токен в заголовке Authorization: Bearer
Имя в реестре	com.loadster/loadster-mcp

OAuth — самый простой способ подключения. Клиенты, поддерживающие MCP OAuth, отправляют вас в Loadster для одобрения подключения в вашем браузере, и вы можете просматривать или отзывать подключенных агентов на странице AI Agents в настройках Loadster.

MCP-токены предназначены для клиентов, которые не поддерживают OAuth, а также для CI-задач и скриптовых агентов. Создайте токен в панели управления Loadster в разделе Settings → AI Agents → MCP Tokens, скопируйте его сразу же (он показывается только один раз) и отправляйте его как Authorization: Bearer YOUR_TOKEN. Токен действует от вашего имени в команде, где вы его создали, поэтому обращайтесь с ним как с паролем.

Подключение Claude Code к Loadster

Самый быстрый способ — плагин из этого репозитория, который добавляет MCP-сервер Loadster, а также несколько навыков, кодирующих разумный рабочий процесс нагрузочного тестирования:

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

Затем запустите /mcp, выберите loadster и одобрите OAuth-подключение в браузере. Спросите Claude что-то вроде "List my Loadster projects", чтобы убедиться, что он может получить доступ к вашему аккаунту.

Без плагина добавьте сервер напрямую, и 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 подключаются к удаленным MCP-серверам как пользовательские коннекторы, которые используют OAuth.

1. Откройте Settings → Connectors и выберите Add custom connector.
2. Введите имя и URL https://api.loadster.com/mcp.
3. Выберите Connect и одобрите OAuth-подключение Loadster, когда откроется браузер.
4. В разговоре откройте меню инструментов и включите коннектор Loadster.

Подключение ChatGPT и Codex к Loadster

ChatGPT в вебе подключается через плагины, созданные в Developer mode (Settings → Security and login). Откройте Plugins, добавьте подключение с URL https://api.loadster.com/mcp, затем добавьте его в новый разговор из меню инструментов и одобрите OAuth-подключение.

Codex в настольном приложении ChatGPT, Codex CLI и расширении Codex IDE используют одну конфигурацию:

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

Или с MCP-токеном в ~/.codex/config.toml:

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

Подключение Cursor к Loadster

Или добавьте его в .cursor/mcp.json в вашем проекте (или ~/.cursor/mcp.json для всех проектов) и одобрите OAuth-подключение, когда Cursor подключится впервые:

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

Чтобы использовать MCP-токен, добавьте "headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" } и установите LOADSTER_MCP_TOKEN в окружении перед запуском Cursor.

Подключение VS Code к Loadster

Или запустите MCP: Add Server из палитры команд, или добавьте его в .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. Опустите аргументы --header, чтобы запустить OAuth-поток вместо использования токена:

{
  "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), поэтому клиенты, которые их поддерживают, могут запрашивать подтверждение перед записью и удалением.

Практики безопасности для ИИ-нагрузочного тестирования

• Агент действует в вашем аккаунте. Он редактирует те же скрипты, сценарии, наборы данных и мониторы, которые видит ваша команда. Изменения скриптов создают ревизии, которые можно восстановить, но все равно лучше проверять предлагаемые изменения и держать эксперименты в отдельном проекте.
• Тестируйте только то, что принадлежит вам. Направляйте скрипты только на системы, которыми вы владеете или на тестирование которых у вас есть разрешение. Запуск скрипта выполняет одного бота, но ответственность в любом случае лежит на вас.
• Ограничьте доступ. Используйте один токен на агента или машину, называйте их понятно и отзывайте те, которые больше не используете. Проверяйте OAuth-подключения на странице AI Agents.

Поддержка

• Помощь по настройке и вопросы: help@loadster.com
• Проблемы безопасности: см. SECURITY.md
• Проблемы с содержимым этого репозитория (README, плагин или метаданные каталога): откройте issue здесь

Что в этом репозитории

Путь	Назначение
server.json	Запись Loadster в официальном MCP-реестре
glama.json	Метаданные сопровождающего для списка Glama
.claude-plugin/, .mcp.json, skills/	Плагин Claude Code и его манифест маркетплейса
.github/workflows/	Проверка при каждом push и публикация в реестре при релизе

Лицензия

Содержимое этого репозитория выпущено под лицензией MIT. Сам сервис Loadster регулируется условиями обслуживания Loadster.