Соберите hackbot, часть 3: MCP-инструменты и CLI

Часть два собрала агента с двумя собственными инструментами. Этот пост подключает его к общим инструментам по Model Context Protocol, добавляет автоматическую проверку скоупа и запускает результат из терминала или вашего редактора. Если MCP для вас нов, сначала прочитайте что такое MCP, а для более широкой идеи что такое ИИ-агенты и tool use.

#От своих инструментов к общим

Два инструмента, которые вы написали, работают, и их перестаёт хватать в тот момент, когда вам нужны поиск по CVE, база знаний или чтение веба без кодирования каждого. MCP это стандартный способ для агента пользоваться инструментами, которые написал и запускает кто-то другой, так что ваш цикл может их вызывать без нового кода. Model Context Protocol задаёт формат, и многие клиенты и серверы уже на нём говорят.

#Что NotHoly даёт по MCP

NotHoly CLI поставляет локальный MCP-сервер. Он работает через стандартный ввод и вывод и использует ваш вход в CLI, поэтому ни один ключ не попадает в файлы конфигурации.

Запустите сервер и зарегистрируйте его у клиента. У собственного агента NotHoly CLI исследовательские инструменты уже на месте, поэтому это важнее всего, когда вы встраиваете инструменты NotHoly в другого агента.

claude mcp add notholy -- notholy mcp

Любой MCP-клиент читает одну и ту же форму JSON.

{"mcpServers": {"notholy": {"command": "notholy", "args": ["mcp"]}}}

Инструменты работают с любой моделью, так что агент на модели из каталога, или на любой другой, всё равно может дотянуться до данных NotHoly по CVE и базе знаний. Модель решает, когда их вызвать, и результаты приходят как данные для чтения циклом.

#Проверка скоупа через notholy engage

Ваш агент на Python доверяет вам читать каждую команду на предмет скоупа. CLI может проверить это за вас. notholy engage записывает, что программа разрешает трогать, и читает цель из каждой команды перед её запуском.

notholy engage init --name acme-web --scope "*.example.com,api.example.com" --exclude vpn.example.com
notholy connect claude

При активном engagement команда в скоупе проходит обычное подтверждение, а цель вне скоупа заставляет вас ввести хост и логирует обход. notholy connect claude ставит ту же проверку как hook на команды оболочки, где команда вне скоупа отклоняется сразу. Проверка читает текст команды и не резолвит имена, поэтому она ловит ошибки и песочницей не является. Это автоматическая версия привычки подтверждать из части два.

#Запуск из CLI и редактора

Теперь у вас три способа запустить агента, и у них один аккаунт. Ваш собственный цикл на Python это тот, что вы полностью понимаете и можете менять. NotHoly CLI запускает готового агента в терминале с этими ограничителями внутри. А notholy connect или notholy run направляет агента редактора на модели и инструменты NotHoly, так что тот же цикл работает там, где вы читаете код.

notholy run claude

notholy run задаёт окружение для одного процесса, не трогая глобальную конфигурацию. notholy connect пишет конфигурацию и может её откатить. В любом случае модель работает на NotHoly, команды работают на вашей машине, а исследовательские инструменты приходят по MCP.

#Когда что использовать

Своего агента используйте, чтобы учиться и точно контролировать, что запускается. Агента из CLI используйте, когда хотите ограничители без их поддержки. Интеграцию с редактором используйте, когда работа это чтение и изменение кода. Все три держат то же разделение из части один: модель планирует, ваша машина действует, и каждую команду подтверждаете вы.

#Дальше в этой серии

Агент находит и проверяет; получить за это оплату всё равно надо вам. Отчёты bug bounty с помощью ИИ превращают ваши заметки в отчёт, который triager принимает.