Защита перед любым MCP-сервером.
Поменяйте одну строку в конфиге MCP. Каждый вызов инструмента сначала проходит через защиту: опасные действия ждут вас, ключи остаются дома, циклы останавливаются, а текст, который пытается перехватить управление агентом, помечается до того, как агент на него среагирует.
Запустите сервер под защитой
npx -y agentleisure-guard mcp -- npx -y @modelcontextprotocol/server-filesystem ./
# Windows PowerShell: для первого npx пишите npx.cmdНужен Node 18+. Пакет называется agentleisure-guard на npm. npm ↗ · GitHub ↗
Оберните команду сервера
Claude Desktop, Cursor, Windsurf, Cline
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "agentleisure-guard", "mcp", "--",
"npx", "-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "...",
"AGENTLEISURE_KEY": "al_..."
}
}
}
}Claude Code
claude mcp add --transport stdio --env GITHUB_PERSONAL_ACCESS_TOKEN=... --env AGENTLEISURE_KEY=al_... github -- \
npx -y agentleisure-guard mcp -- npx -y @modelcontextprotocol/server-githubVS Code
{
"servers": {
"github": {
"type": "stdio",
"command": "npx",
"args": ["-y", "agentleisure-guard", "mcp", "--",
"npx", "-y", "@modelcontextprotocol/server-github"]
}
}
}AGENTLEISURE_KEY необязателен: с ним рискованные вызовы ждут согласия в один клик, а не отклоняются. Добавьте AGENTLEISURE_NOTIFY_URL (webhook Slack или Discord), чтобы получать ссылку в чат, и --journal agent-journal.jsonl для журнала, который можно проверить в просмотрщике журнала.
Защита и для удалённых MCP-серверов
Для серверов, к которым подключаются по ссылке (Streamable HTTP), укажите шлюзу --url. Он по-прежнему работает на вашем компьютере и сам подключается наружу, поэтому проверки те же. Токен передаётся через --bearer-env (имя переменной окружения) или --header.
{
"mcpServers": {
"remote-tools": {
"command": "npx",
"args": ["-y", "agentleisure-guard", "mcp",
"--url", "https://mcp.example.com/mcp", "--bearer-env", "MCP_TOKEN",
"--remember-approval", "15"],
"env": { "MCP_TOKEN": "...", "AGENTLEISURE_KEY": "al_..." }
}
}
}--remember-approval 15: после вашего согласия точно такой же вызов проходит без вопроса 15 минут. Любой другой вызов всё равно спрашивает. По умолчанию выключено.
Правила проекта, режим наблюдения и защита, которая говорит с агентом
Положите agentleisure.policy.json в репозиторий, и шлюз добавит ваши правила к встроенным: запрещённые инструменты, инструменты, которые всегда требуют согласия, защищённые папки и единственные адреса, куда можно отправлять данные. Правила могут только ужесточать защиту. npx agentleisure-guard policy init создаёт файл-заготовку, policy check проверяет его.
{
"deny_tools": ["delete_repository", "*_admin"],
"ask_tools": ["send_email", "deploy"],
"protected_paths": ["./.git", "./infra", "~/.ssh"],
"allowed_hosts": ["api.github.com", "*.your-company.com"],
"observe": false
}Режим наблюдения (--observe или "observe": true): ничего не блокируется, каждый вызов, который был бы остановлен, записывается, а при выходе выводится сводка. Поработайте так неделю, потом включайте блокировку.
Защита говорит с агентом. Шлюз добавляет два инструмента: agentleisure_policy — агент заранее читает правила, а agentleisure_ask_human — агент задаёт вам вопрос «да/нет» в Telegram, Slack или по ссылке, когда сомневается, вместо того чтобы гадать.
Восемь видов сбоев, один шлюз и ваши правила
| Что | Когда срабатывает | Что происходит |
|---|---|---|
| Опасные вызовы | DROP, TRUNCATE, UPDATE или DELETE без WHERE, rm -rf и Remove-Item -Recurse, force push, curl | sh, сброс баз, удаление облачных ресурсов и репозиториев, HTTP DELETE и GraphQL-мутации на удаление. | Ждёт вашего согласия в один клик (ссылка в логе, Slack, Discord или Telegram). Без ключа вызов отклоняется с объяснением. |
| Файлы с ключами | .env, SSH-ключи, доступы к облакам, kube и docker, JSON сервисных аккаунтов. Шаблоны вроде .env.example проходят. | Ждёт согласия, как опасный вызов. |
| Утечка ключей | API-ключи, приватные ключи и содержимое .env в вызове, который уходит в сеть. | Всегда отклоняется. |
| Циклы | Один и тот же вызов больше 10 раз за 5 минут. | Отклоняется; агенту говорят остановиться и сообщить о проблеме. |
| Инструкции в ответах | Страница, issue, комментарий к PR или файл велит агенту забыть свои инструкции, отправить ключи или запустить скрипт. | Перед ответом ставится предупреждение: это данные, не команды. |
| Отравленные описания инструментов | MCP-инструмент, в описании которого спрятаны команды для агента. | Высокий риск: инструмент скрывается. Средний: помечается как недоверенный. |
| Инъекция, а затем отправка | После ответа с попыткой командовать агентом — любой вызов, который может отправить данные наружу: сетевые инструменты, команды, ссылки. | 10 минут требует согласия человека, источник указывается. Именно такая цепочка стояла за утечками через комментарии в PR и отравленные инструменты в этом году. |
| Удалённые или перезаписанные файлы | Вызов, который удаляет, перемещает или перезаписывает локальные файлы. | Сначала делается копия. agentleisure-guard undo возвращает файлы. |
Инциденты, ради которых это сделано
- Агент нашёл токен от инфраструктуры в постороннем файле и одним API-запросом удалил рабочую базу вместе с бэкапами.
- Скрытые комментарии в PR и отравленные описания инструментов заставляли ИИ-ревьюеров и агентов-программистов сливать данные.
- Агенты, оставленные на ночь, тысячи раз повторяли один и тот же падающий вызов и наматывали счёт.
Каждая строка таблицы выше закрывает один из этих случаев. Те же правила работают в Guard API, в хуке для Claude Code и в npm-модуле.
Частые вопросы
- Уходят ли мои данные в AgentLeisure?
- Нет. Шлюз работает на вашем компьютере и видит аргументы и ответы только там. Лишь если вы укажете AGENTLEISURE_KEY, он отправит краткое описание вызова, которому нужно согласие, чтобы его показала страница согласия.
- Какие MCP-серверы подходят?
- Любые stdio MCP-серверы (официальные GitHub, filesystem, Postgres и Slack, серверы сообщества через npx или uvx, ваши собственные) и удалённые серверы по Streamable HTTP через --url.
- Какие клиенты?
- Всё, что запускает MCP-серверы командой: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline и другие.
- Не будет ли он мешать обычной работе?
- Спрашивают только необратимые действия и файлы с ключами. Чтение, запросы с WHERE, создание и обычные команды проходят сразу. --remember-approval убирает повторные вопросы при повторе, а --ask allow пропускает рискованные вызовы с предупреждением вместо блокировки.
- Это песочница?
- Нет. Это слой правил, который ловит сбои, о которых постоянно пишут. Боевые ключи всё равно держите подальше от агента.
- Сколько стоит?
- Нисколько. Лицензия MIT, ноль зависимостей, ноль скриптов установки.