Вы можете просматривать Результаты по Безопасности и принимать по ним решения в чат-помощнике или через свой собственный помощник. CoRoid в качестве сервера MCP: Claude Code, Codex, Cursor или другой клиент MCP. Эти инструменты следуют тем же правилам, что и портал, поэтому дают одинаковые ответы и отклоняют те же запросы.
Чтение
У Безопасности есть собственные области видимости, поэтому подключение, созданное для других задач, не
увидит Результаты. Для работы этих инструментов требуется роль Рецензента и mcp.security.read. Ни один
из них не нуждается в утверждении. Они следуют собственным правилам Безопасности CoRoid: вы видите проекты, доступные в портале. Подключение, ограниченное несколькими проектами, должно
указать один из них или соответствующий результат.
| Инструмент | Что он отвечает |
|---|---|
get_security_overview | По проекту: открытые Результаты с указанием степени серьёзности, просроченные сроки устранения, задачи, которые никто не подтвердил, тестовый код и количество пунктов, требующих вашего участия. |
list_security_findings | Результаты по проекту, типу, степени серьёзности и состоянию, сначала те, что были обнаружены первыми, затем — по степени серьёзности; needsYou отбирает только те, что требуют вашего участия. |
list_security_needs | Решения, ожидающие утверждения человеком — сначала самые срочные, каждое со своим ответом от CoRoid и ссылкой для открытия: тот же список, что и в разделе «Безопасность» → «Решения» |
get_security_finding | Один результат: его местоположение, подтверждён ли он, когда он должен быть устранён и какова работа по его исправлению. Никогда — стоимость секрета. |
get_security_settings | Каждая мера защиты проекта применяется в соответствии с правилами: отключена, в режиме наблюдения, принудительная или недоступна, с указанием причины и параметров, выбранных для проекта. |
list_security_runs | Запуски Безопасности, самые новые первыми, как указано в журнале запусков: выполняются, ожидают, завершены, завершились ошибкой или заменены, с объяснением причины сбоя. |
get_attack_surface | Точки входа каждого проекта и количество пунктов, ожидающих проверки; для одного проекта — все точки входа с описанием кода и решениями команды, предложения по развертыванию и результаты проверки pull request. |
get_threat_model | Версия модели угроз каждого проекта и количество пунктов, ожидающих рецензирования; для одного проекта — сама модель, предложение, находящееся на рассмотрении, и последние версии. |
list_security_packages | Актуальные списки зависимостей каждого проекта с указанием числа установленных пакетов и уязвимых из них; для одного проекта — страница с пакетами, сначала уязвимые. |
Каждый результат содержит ссылку на свою страницу в CoRoid.
Действия с результатами
Эти инструменты работают с результатами. Для этого им требуются mcp.security.write и владелец или
администратор, как и в портале.
| Инструмент | Что он делает | Утверждение |
|---|---|---|
start_security_fix | Исправление, как в портале: устранение уязвимой зависимости, задача с регрессионным тестом для найденной ошибки в коде, чек-лист ротации для скомпрометированного учётных данных. Вторая команда Fix отвечает на уже созданную задачу. | Нет |
run_security_scan | Просканировать один проект сейчас: все активные элементы, зависимости, историю секретов, поверхность атаки, аудит (где он активен) или сохранённые доказательства. | Нет |
confirm_real_secret | Подтвердить, что скомпрометированные учётные данные действительно существуют. Они остаются открытыми до тех пор, пока кто-то не подтвердит их ротацию. | Нет |
revoke_security_exception | Завершить исключение: результат снова станет открытым. | Нет |
dismiss_security_finding | Отметить результат как «Не проблема» с указанием причины. | Всегда |
add_security_exception | Принять риск, связанный с результатом, до определённой даты, с указанием причины. | Всегда |
attest_secret_rotated | Подтвердить, что скомпрометированные учётные данные были заменены или аннулированы, что закрывает результат. CoRoid никогда не проверяет найденные учётные данные. | Всегда |
Действия с поверхностью атаки и моделью угроз
Для этого также требуются mcp.security.write и владелец или администратор. Там, где одна настройка в портале одновременно усиливает и ослабляет контроль, существуют два инструмента: тот, что усиливает, отклоняет изменение, которое ослабляет контроль, поэтому такое изменение всегда
требует вашего участия.
| Инструмент | Что он делает | Утверждение |
|---|---|---|
raise_entry_point_exposure | Сделать точки входа более доступными, зафиксировать их для аудита или вернуть их в область видимости. | Нет |
lower_entry_point_exposure | Сделать точки входа менее доступными, снять фиксацию или исключить их из области видимости с указанием причины. | Всегда |
refresh_threat_model | Повторно проанализировать код проекта; полученные результаты будут представлены как предложения. | Нет |
add_threat_model_entries | Добавить элементы в модель угроз. | Нет |
accept_threat_model_proposal | Принять предложения, полученные после повторного анализа кода. | Нет |
update_threat_model_entries | Изменить заголовок или детали элемента. | Всегда |
remove_threat_model_entries | Удалить элементы из модели угроз. | Всегда |
dismiss_threat_model_proposal | Отклонить предложения, полученные после повторного анализа кода. | Всегда |
keep_security_proof | Сохранить доказательство, воспроизводящее результат, в качестве регрессионного теста. | Нет |
Изменение параметров защиты
Настройки защиты для конкретного проекта или параметры по умолчанию организации настраиваются в
двух одинаковых инструментах: tighten_security_protection усиливает параметры защиты и
отклоняет любые изменения, ослабляющие их, а relax_security_protection ослабляет их,
либо заставляет проект снова следовать параметрам по умолчанию организации, при этом всегда
требуется подтверждение человека. Изменение считается ослаблением, если уровень обнаружения или принудительного применения снижается,
порог серьезности увеличивается, количество открываемых исправляющих запросов уменьшается, аудит отключается или выполняется реже,
сканирование секретов охватывает меньше данных, сеть песочницы расширяется или разрешает больше хостов, либо точка входа типа «не задано» больше не считается доступной из интернета. Параметр «Собственная команда сканирования» задается в разделе «Контроль качества».
Контакты и раскрытие информации
Контакты по вопросам безопасности проекта обладают полномочиями на раскрытие информации наравне с владельцами и администраторами: они видят исправления CoRoid, сохраненные в закрытом виде для нераскрытых уязвимостей, могут публиковать или удалять их, составлять черновики рекомендаций по безопасности GitHub и фиксировать отчеты для разработчиков зависимостей. Через MCP и Чат эти действия выполняются владельцами и администраторами, при этом всегда требуется подтверждение человека: контакт может раскрыть информацию об уязвимости, и такое раскрытие уже нельзя отменить.
| Инструмент | Что он делает | Подтверждение |
|---|---|---|
list_security_contacts | Контакты по вопросам безопасности проекта и кто может ими быть | Нет |
get_security_disclosure | Закрытые исправления уязвимости (размер и состояние, но не их содержимое), рекомендация GitHub и отчеты, отправленные разработчикам, — всё это предоставляется обладателям полномочий на раскрытие информации | Нет |
add_security_contact | Назначить участника проекта контактом по вопросам безопасности | Всегда |
remove_security_contact | Удалить контакт по вопросам безопасности | Всегда |
publish_private_fix | Опубликовать сохраненное исправление: уязвимость становится раскрытой, и для задачи открывается раздел pull request | Всегда |
discard_private_fix | Удалить сохраненное исправление | Всегда |
draft_github_security_advisory | Составить черновик рекомендации по безопасности GitHub в репозитории, доступный для просмотра разработчикам | Всегда |
record_maintainer_report | Зафиксировать, куда вы сообщили о уязвимости разработчикам зависимостей. CoRoid ничего не отправляет. | Всегда |
Почему некоторые действия требуют подтверждения человека
Это не проблема: принятый риск и ротация учетных данных удаляют уязвимость из списка открытых без исправления; менее уязвимая точка входа и меньшая модель угроз исключают элементы из области аудита. Помощник не должен иметь возможность делать это самостоятельно, поэтому эти инструменты всегда требуют подтверждения человека, независимо от настроек соединения:
- Из клиента MCP запрос ожидает подтверждения от владельца или администратора Настройки → Подключения → CoRoid MCP сервер → Согласования, и им приходит уведомление. Запрос истекает через 10 минут.
- В Чате помощник запрашивает у вас подтверждение в чате перед выполнением действия.
В подтверждении простыми словами указывается, что произойдет, на основе записи CoRoid об уязвимости: «Отметить нарушение контроля доступа в src/routes/admin.ts:76 (Магазин)
«Не является проблемой», после чего приводится причина в кавычках. Текст вокруг причины
берется из CoRoid, а не от помощника, и значение учетных данных никогда
не отображается: CoRoid его не сохраняет.