shaft-mcp — MCP-сервер для Claude Code: автоматизация браузера
MCP-сервер для автоматизации браузера и разбора упавших тестов без сети. Пригодится, когда агент пишет или чинит тесты SHAFT.
claude mcp add shaft-mcp -- docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024Что делает shaft-mcp
shaft-mcp подключает к ИИ-агенту инструменты SHAFT: запуск браузерных сценариев, снятие скриншотов и офлайн-разбор причин падения теста. Работает поверх движка SHAFT_ENGINE, который ведёт драйверы Selenium и Appium, синхронизирует действия и собирает отчёт Allure по каждому прогону.
Сервер запускается в контейнере, поэтому Docker нужен до первого вызова. Установка сводится к одной команде: агент сам поднимает образ и общается с ним через stdio. Внутри — те же инструменты, что описаны в справочнике MCP-инструментов SHAFT, плюс CLI-команды для тех, кто предпочитает терминал.
Диагностика падений идёт офлайн и детерминированно: результат не зависит от того, доступна ли сеть в момент разбора. Это удобно в CI, где внешние сервисы часто недоступны. Если тесты пишутся на Java и уже собираются Maven, отдельная настройка не нужна — сервер работает с тем же проектом.
Какие задачи решает
- запустить браузерный сценарий из диалога с агентом
- снять скриншот страницы на нужном шаге
- разобрать причину упавшего теста без доступа к сети
- собрать отчёт Allure по прогону
- подключить инструменты SHAFT к агенту в контейнере
Примеры запросов агенту
- Запусти браузерный тест SHAFT для страницы входа и покажи скриншот
- Разбери, почему упал последний тест, и предложи правку
- Собери Allure-отчёт по последнему прогону
mvn test
Как установить shaft-mcp
Командой платформы
claude mcp add shaft-mcp -- docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024Командой платформы
codex mcp add shaft-mcp -- docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024Файл настроек
{
"mcpServers": {
"shaft-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024"
]
}
}
}Файл настроек
{
"servers": {
"shaft-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024"
]
}
}
}Командой платформы
gemini mcp add shaft-mcp docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «Тесты и QA»
Всё по теме «Тесты и QA» →Вопросы о shaft-mcp
Как установить shaft-mcp в Claude?
Одной командой: claude mcp add shaft-mcp -- docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024. Docker должен быть установлен и запущен.
Что делает shaft-mcp?
Даёт агенту инструменты SHAFT для автоматизации браузера, снятия скриншотов и офлайн-разбора причин падения тестов.
Нужен ли SHAFT_ENGINE в проекте?
Да, сервер работает с движком SHAFT_ENGINE. Если тесты уже собираются Maven с зависимостью io.github.shafthq:shaft-engine, дополнительная настройка не требуется.
