aegis — MCP-сервер для Claude Code: изоляция секретов и запуск
Локальный прокси изолирует API-ключи от ИИ-агента. Сервер сам подставляет токены в исходящие запросы, сверяя домены по белому списку.
claude mcp add --env AEGIS_MASTER_KEY=<AEGIS_MASTER_KEY> --env AEGIS_SALT=<AEGIS_SALT> --env AEGIS_DATA_DIR=<AEGIS_DATA_DIR> --env AEGIS_PORT=<AEGIS_PORT> --env AEGIS_LOG_LEVEL=<AEGIS_LOG_LEVEL> --transport stdio aegis -- npx -y @getaegis/cliЧто делает aegis
Вместо передачи открытых ключей в контекст модели Aegis разворачивает локальный шлюз. Агент обращается к сервисам через инструмент aegis_proxy_request или адрес localhost:3100, а прокси сам добавляет авторизационные заголовки перед отправкой во внешнюю сеть. В итоге модель не работает с исходными токенами. Это защищает от утечек через вредоносные промпты.
Хранилище защищает данные шифрованием AES-256-GCM. Механизм Domain Guard блокирует отправку пакетов на непредусмотренные адреса, а инспектор тела запроса отслеживает утечки паролей наружу. Для запуска в Claude Code требуются переменные AEGIS_MASTER_KEY и AEGIS_SALT, без которых расшифровать хранилище невозможно.
Какие задачи решает
- заблокировать утечку API-ключей через контекст или промпт-инъекции
- ограничить список доменов для каждого внешнего сервиса
- записать полный журнал выполненных агентом сетевых запросов
- выдавать права на отдельные токены конкретным агентам
Примеры запросов агенту
- Вызови aegis_list_services и покажи доступные сервисы без секретов
- Отправь запрос в Slack через aegis_proxy_request на путь /api/auth.test
- Проверь статус локального шлюза через aegis_health
Как установить aegis
Командой платформы
claude mcp add --env AEGIS_MASTER_KEY=<AEGIS_MASTER_KEY> --env AEGIS_SALT=<AEGIS_SALT> --env AEGIS_DATA_DIR=<AEGIS_DATA_DIR> --env AEGIS_PORT=<AEGIS_PORT> --env AEGIS_LOG_LEVEL=<AEGIS_LOG_LEVEL> --transport stdio aegis -- npx -y @getaegis/cliВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
codex mcp add aegis --env AEGIS_MASTER_KEY=<AEGIS_MASTER_KEY> --env AEGIS_SALT=<AEGIS_SALT> --env AEGIS_DATA_DIR=<AEGIS_DATA_DIR> --env AEGIS_PORT=<AEGIS_PORT> --env AEGIS_LOG_LEVEL=<AEGIS_LOG_LEVEL> -- npx -y @getaegis/cliВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"aegis": {
"command": "npx",
"args": [
"-y",
"@getaegis/cli"
],
"env": {
"AEGIS_MASTER_KEY": "<AEGIS_MASTER_KEY>",
"AEGIS_SALT": "<AEGIS_SALT>",
"AEGIS_DATA_DIR": "<AEGIS_DATA_DIR>",
"AEGIS_PORT": "<AEGIS_PORT>",
"AEGIS_LOG_LEVEL": "<AEGIS_LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"aegis": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getaegis/cli"
],
"env": {
"AEGIS_MASTER_KEY": "<AEGIS_MASTER_KEY>",
"AEGIS_SALT": "<AEGIS_SALT>",
"AEGIS_DATA_DIR": "<AEGIS_DATA_DIR>",
"AEGIS_PORT": "<AEGIS_PORT>",
"AEGIS_LOG_LEVEL": "<AEGIS_LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e AEGIS_MASTER_KEY=<AEGIS_MASTER_KEY> -e AEGIS_SALT=<AEGIS_SALT> -e AEGIS_DATA_DIR=<AEGIS_DATA_DIR> -e AEGIS_PORT=<AEGIS_PORT> -e AEGIS_LOG_LEVEL=<AEGIS_LOG_LEVEL> aegis npx -y @getaegis/cliВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о aegis
Как установить aegis в Claude Code?
Выполните в терминале команду: claude mcp add aegis -e AEGIS_MASTER_KEY=<AEGIS_MASTER_KEY> -e AEGIS_SALT=<AEGIS_SALT> -- npx -y @getaegis/cli.
Какие инструменты предоставляет MCP-сервер?
Доступны три функции: aegis_proxy_request для отправки запросов к внешним API, aegis_list_services для просмотра подключённых сервисов и aegis_health для проверки состояния прокси.
Где хранятся мастер-ключи?
Команда aegis init по умолчанию помещает мастер-ключ в системную связку ключей ОС (macOS, Windows или Linux) с возможностью сохранения в локальный файл.
