Burp MCP: расширение для Burp Suite и подключение к Claude и Codex

PortSwigger/mcp-server· Проверено 12.11.2026· 9на GitHub

Подключает агента к запущенному Burp Suite: искать в истории прокси, отправлять HTTP-запросы, открывать вкладки Repeater и Intruder, ловить обращения через Collaborator. Сервер работает внутри Burp как расширение.

2 реализации:

Расширение из BApp Store для Professional и Community: 27 инструментов, запросы и чтение истории идут через подтверждение в окне Burp.

Как подключить

Что сделать до подключения

Burp Suite Professional или Community

Расширение MCP Server из BApp Store или JAR, собранный из репозитория командой ./gradlew embedProxyJar (нужны java и jar в PATH)

В Burp: Extensions → Add → тип Java → выбрать build/libs/burp-mcp-all.jar, если ставите из исходников

Во вкладке MCP в Burp отметить Enabled; сервер слушает http://127.0.0.1:9876, адрес и порт меняются там же

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http burp-suite http://127.0.0.1:9876/mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.burp-suite]
url = "http://127.0.0.1:9876/mcp"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "burp-suite": {
      "url": "http://127.0.0.1:9876/mcp"
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "burp-suite": {
      "type": "http",
      "url": "http://127.0.0.1:9876/mcp"
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "burp-suite": {
      "httpUrl": "http://127.0.0.1:9876/mcp"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "burp-suite": {
      "httpUrl": "http://127.0.0.1:9876/mcp"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "burp-suite": {
        "type": "remote",
        "url": "http://127.0.0.1:9876/mcp"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:9876/mcp

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "burp-suite": {
      "url": "http://127.0.0.1:9876/mcp"
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_proxy_http_history_regexищет в истории прокси по regex

get_proxy_http_historyлистает историю прокси

get_proxy_websocket_historyчитает историю WebSocket

get_organizer_itemsчитает записи Organizer

send_http1_requestотправляет запрос HTTP/1.1

send_http2_requestотправляет запрос HTTP/2

create_repeater_tab_http2открывает вкладку Repeater

create_repeater_tabоткрывает Repeater для HTTP/1.1

send_to_intruderпередаёт запрос в Intruder

get_scanner_issuesпоказывает находки сканера

generate_collaborator_payloadсоздаёт payload Collaborator

get_collaborator_interactionsчитает обращения к Collaborator

set_proxy_intercept_stateвключает и выключает перехват

set_task_execution_engine_stateставит задачи Burp на паузу

output_project_optionsвыгружает настройки проекта

set_project_optionsменяет настройки проекта

get_active_editor_contentsчитает открытый редактор сообщения

set_active_editor_contentsзаменяет текст в редакторе

url_encodeкодирует строку для URL

base64_decodeдекодирует Base64

Показано 20 из 27.

Только для Burp Suite Professional: 150 инструментов, среди них фаззер, гонки запросов, атаки на JWT, проверка IDOR и свои проверки BCheck; подключение по SSE с токеном.

Как подключить

Что сделать до подключения

Burp Suite Professional 2025.x или новее

JAR со страницы Releases или сборка ./gradlew shadowJar на JDK 17–21

В Burp: Extensions → Add → выбрать JAR; во вкладке BurpMCP-Ultra появится статус Running и токен

Node.js с npx для моста supergateway; Claude Code подключается к SSE напрямую: type sse, адрес http://127.0.0.1:9876/ и заголовок Authorization

Authorization

токен со вкладки Server панели BurpMCP-Ultra в Burp, передаётся как Bearer <токен>

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio burpmcp-ultra \
  -- npx -y supergateway --sse http://127.0.0.1:9876/ --header 'Authorization: Bearer <токен со вкладки Server>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.burpmcp-ultra]
command = "npx"
args = ["-y", "supergateway", "--sse", "http://127.0.0.1:9876/", "--header", "Authorization: Bearer <токен со вкладки Server>"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "burpmcp-ultra": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://127.0.0.1:9876/",
        "--header",
        "Authorization: Bearer <токен со вкладки Server>"
      ]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "burpmcp-ultra": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://127.0.0.1:9876/",
        "--header",
        "Authorization: Bearer <токен со вкладки Server>"
      ]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "burpmcp-ultra": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://127.0.0.1:9876/",
        "--header",
        "Authorization: Bearer <токен со вкладки Server>"
      ]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "burpmcp-ultra": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://127.0.0.1:9876/",
        "--header",
        "Authorization: Bearer <токен со вкладки Server>"
      ]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "burpmcp-ultra": {
        "type": "local",
        "command": [
          "npx",
          "-y",
          "supergateway",
          "--sse",
          "http://127.0.0.1:9876/",
          "--header",
          "Authorization: Bearer <токен со вкладки Server>"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "burpmcp-ultra": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://127.0.0.1:9876/",
        "--header",
        "Authorization: Bearer <токен со вкладки Server>"
      ]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "burpmcp-ultra": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://127.0.0.1:9876/",
        "--header",
        "Authorization: Bearer <токен со вкладки Server>"
      ]
    }
  }
}

Инструменты сервера

proxy_historyчитает историю прокси с фильтрами

proxy_history_searchищет в истории по regex

http_send_requestотправляет HTTP-запрос

http_send_request_chainшлёт цепочку запросов с токенами

http_fuzzфаззит параметр по списку

http_raceотправляет запросы одновременно

repeater_sendпередаёт запрос в Repeater

scanner_start_crawlзапускает обход сайта

scanner_start_auditзапускает активное сканирование

scanner_get_all_issuesсобирает все находки

scanner_generate_reportвыгружает отчёт HTML или XML

collaborator_pollчитает обращения DNS, HTTP, SMTP

injection_probeпроверяет SQLi, SSTI и LFI

jwt_attackатакует и подбирает JWT

access_control_sweepищет IDOR под разными ролями

auth_diffсравнивает ответы по уровням доступа

api_import_openapiимпортирует OpenAPI и строит запросы

passive_intelищет ключи и токены в трафике

recon_js_endpointsсобирает адреса из JavaScript

bcheck_createсоздаёт проверку BCheck

Показано 20 из 150.

Что попросить агента

«Найди в истории прокси все запросы к api.<домен>/v2/users и покажи ответы, где есть email»Агент вызовет get_proxy_http_history_regex с regex по хосту и пути и постранично разберёт ответы

«Повтори этот запрос с id=<другой id>, сравни ответ и оставь его мне в Repeater»Агент отправит запрос через send_http2_request и откроет вкладку create_repeater_tab_http2 с понятным именем

«Проверь параметр url в запросе <запрос> на SSRF через Collaborator»Агент возьмёт payload через generate_collaborator_payload, отправит запрос send_http1_request и проверит get_collaborator_interactions

«Сравни ответ на GET /api/users/1 под токенами admin, user и без токена»BurpMCP-Ultra прогонит запрос через auth_diff или access_control_sweep и отметит IDOR и повышение прав

«Импортируй спецификацию <файл openapi.json> и отправь запросы по всем методам»BurpMCP-Ultra разберёт схему через api_import_openapi, отправит запросы и добавит их в карту сайта

Для каких задач

Найти в истории прокси запросы к нужному API по регулярному выражению

Повторить запрос с другими параметрами и оставить его во вкладке Repeater для ручной проверки

Проверить внеполосное взаимодействие через payload Burp Collaborator

Сравнить ответы под разными учётными записями и найти IDOR

Запустить обход и сканирование и выгрузить отчёт HTML или XML

Импортировать спецификацию OpenAPI и отправить запросы по всем методам

Ограничения

Сервер работает, только пока открыт Burp с загруженным и включённым расширением: агент сам Burp не запустит

Сканер и Collaborator у сервера PortSwigger есть только в Burp Suite Professional; BurpMCP-Ultra целиком требует Professional 2025.x

По умолчанию Burp спрашивает подтверждение перед каждым запросом и чтением истории: вызов висит, пока вы не ответите в окне Burp

Оба расширения по умолчанию занимают порт 9876: чтобы держать их вместе, перенесите BurpMCP-Ultra на другой порт

Если не работает

Клиент пишет Connection refused

Burp не запущен, расширение не загружено или во вкладке MCP снят флажок Enabled. Запустите Burp и включите сервер.

HTTP 400: sessionId query parameter is not provided

В адресе нет /mcp, и клиент попал на старый SSE-эндпоинт. Укажите http://127.0.0.1:9876/mcp.

Вызов инструмента висит без ответа

Burp ждёт вашего подтверждения в своём окне. Ответьте на диалог или добавьте хост в список автоодобрения во вкладке MCP.

codex exec отказывает: MCP tool call requires approval

Добавьте в запись [mcp_servers.burp] в ~/.codex/config.toml строку default_tools_approval_mode = "approve" вместе с url; запись без url падает с invalid transport.

BurpMCP-Ultra: SDK auth failed: HTTP 404: Invalid OAuth error response

Сервер вернул 401 без токена. Передайте токен со вкладки Server в заголовке Authorization: Bearer; адрес — корень /, без /sse.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Burp Suite MCP Serverразработчик сервиса	PortSwigger	9	HTTP	не нужен	27	5 ноября 2026
BurpMCP-Ultra	Cy-S3c	302	локально	токен	150	28 сентября 2026

Частые вопросы

Какой из двух серверов выбрать?

Сервер PortSwigger работает и в Community: история прокси, отправка запросов, Repeater, Intruder, Collaborator, 27 инструментов. BurpMCP-Ultra ставят в Professional, когда агенту нужны фаззер, гонки запросов, атаки на JWT и проверки доступа.

Можно отправлять запросы без подтверждения?

Да. Во вкладке MCP в Burp добавьте хосты в список автоодобрения, маски вида *.example.com работают. В окне подтверждения есть пункты Always Allow Host и Always Allow Host:Port.

Агент может менять настройки Burp?

Только если во вкладке MCP отмечен пункт Enable tools that can edit your config. Без него set_project_options и set_user_options отвечают, что правка выключена. При выгрузке настроек учётные данные скрываются.

Как подключить Burp MCP к Claude Desktop?

Claude Desktop понимает только stdio, поэтому расширение PortSwigger идёт с прокси mcp-proxy-all.jar. Кнопка установщика во вкладке MCP сама пропишет его в конфиг Claude Desktop, затем перезапустите приложение.

Как подключить Burp MCP к Codex?

Поставьте плагин: codex plugin marketplace add PortSwigger/mcp-server, затем codex plugin add burp-suite-mcp-server@portswigger. Без плагина хватит команды codex mcp add burp --url http://127.0.0.1:9876/mcp.

Где скачать Burp MCP?

Расширение PortSwigger называется MCP Server и лежит в BApp Store; исходники — в репозитории PortSwigger/mcp-server на GitHub. Готовый JAR BurpMCP-Ultra выкладывается на странице Releases репозитория Cy-S3c/BurpMCP-Ultra.

Burp MCP работает в Community Edition?

Расширение PortSwigger поддерживает Professional и Community, но инструменты сканера и Collaborator появляются только в Professional. BurpMCP-Ultra рассчитан только на Professional.

Работает ли сервер из России?

Расширение работает на вашем компьютере внутри Burp и слушает 127.0.0.1, ключи и зарубежные аккаунты для самого сервера не нужны.

Burp MCP: расширение для Burp Suite и подключение к Claude и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы