Aegis — MCP-сервер для Claude Code: политики вызовов агента
MCP-сервер Aegis сверяет каждый вызов инструмента агента с YAML-правилами: пропускает, требует подтверждения или блокирует, а событие уходит в журнал аудита.
claude mcp add --env AEGIS_POLICY_PATH=<AEGIS_POLICY_PATH> --transport stdio aegis-ai-agent-governance -- uvx agent-aegisЧто делает Aegis — AI Agent Governance
Запускается по stdio командой uvx agent-aegis и работает прослойкой между агентом и его инструментами. Любое обращение — запуск команды, HTTP-запрос, вызов MCP — превращается в объект Action и проверяется по правилам из YAML. Вердикт у правила один из трёх: auto, approve или block. Путь к файлу политики задаёт переменная AEGIS_POLICY_PATH, без неё применять нечего.
Помимо имён инструментов учитываются цепочки делегирования с монотонным ограничением доверия: передать агенту больше прав, чем у него есть, не получится. События аудита ложатся в журнал только на добавление, связанный хешами Merkle, со стоками в SQLite, JSONL и webhook. Регулярные выражения ловят инъекции в промпт, PII, утечку промпта и токсичность. Второй модели в пути запроса нет, поэтому вердикт детерминированный и разбирается по логу, а не по вероятностям.
Для библиотечного режима есть aegis.auto_instrument(): он находит уже установленные фреймворки и оборачивает их без правок кода агента. Свои проверки добавляются в GuardrailEngine.add(). На машине понадобится uv — без него uvx не запустится. Лицензия MIT.
Какие задачи решает
- заблокировать вызов, который лезет в продовые данные
- затребовать подтверждение перед удалением каталога
- поймать инъекцию в промпт до того, как агент её выполнит
- скрыть PII в аргументах вызова инструмента
- собрать журнал вызовов, который нельзя тихо переписать
Примеры запросов агенту
- Покажи, какие правила Aegis сработают на вызов
bashс удалением каталога - Выведи последние события, которые Aegis записал в журнал аудита
- Ужесточи политику: любой
git pushдолжен уходить на подтверждение
Как установить Aegis — AI Agent Governance
Командой платформы
claude mcp add --env AEGIS_POLICY_PATH=<AEGIS_POLICY_PATH> --transport stdio aegis-ai-agent-governance -- uvx agent-aegisВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-aegis <команда>
Командой платформы
codex mcp add aegis-ai-agent-governance --env AEGIS_POLICY_PATH=<AEGIS_POLICY_PATH> -- uvx agent-aegisВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-aegis <команда>
Файл настроек
{
"mcpServers": {
"aegis-ai-agent-governance": {
"command": "uvx",
"args": [
"agent-aegis"
],
"env": {
"AEGIS_POLICY_PATH": "<AEGIS_POLICY_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-aegis <команда>
Файл настроек
{
"servers": {
"aegis-ai-agent-governance": {
"type": "stdio",
"command": "uvx",
"args": [
"agent-aegis"
],
"env": {
"AEGIS_POLICY_PATH": "<AEGIS_POLICY_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-aegis <команда>
Командой платформы
gemini mcp add -e AEGIS_POLICY_PATH=<AEGIS_POLICY_PATH> aegis-ai-agent-governance uvx agent-aegisВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-aegis <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Aegis — AI Agent Governance
Как установить Aegis в Claude Code?
Добавьте сервер командой claude mcp add --env AEGIS_POLICY_PATH=<AEGIS_POLICY_PATH> --transport stdio aegis-ai-agent-governance -- uvx agent-aegis, подставив путь к файлу политики вместо плейсхолдера.
Что делает Aegis?
Проверяет вызовы инструментов агента по декларативным правилам и решает, пропустить вызов, запросить подтверждение или отклонить его. Все решения ложатся в журнал с хеш-цепочкой, чтобы их нельзя было переписать задним числом.
Чем Aegis отличается от Guardrails AI и NeMo Guardrails?
Те подключают вручную в выбранной точке вызова и работают в основном с текстом. Aegis оборачивает уже установленные фреймворки целиком и оценивает сами вызовы инструментов: делегирование, расхождение между заявленным намерением и эффектом, исключённые варианты.
