keypaste — хранилище секретов с одобрением для агентов
keypaste
CLI и MCP-мост поверх KeePass-совместимого хранилища: агент получает один секрет только после вашего ответа, а запросы идут в журнал
- 839 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Инструмент работает с паролями, токенами и ключами, а отданное агенту значение попадает в контекст модели и к ее поставщику
- Причину запроса пишет сам агент: человек, который отвечает на запрос, должен проверять ее каждый раз
- Опубликованные бинарники не подписаны и не нотаризованы, а версия до 1.0 содержит известные ограничения
Установка
- Работает в
Ручная установка
curl -fLO https://dl.keypaste.com/v0.3.0/keypaste-0.3.0-osx-arm64.tar.gz && curl -fLO https://dl.keypaste.com/v0.3.0/keypaste-0.3.0-osx-arm64.tar.gz.sha256 && shasum -a 256 -c keypaste-0.3.0-osx-arm64.tar.gz.sha256 && tar -xzf keypaste-0.3.0-osx-arm64.tar.gz && mkdir -p ~/.local/bin && mv keypaste keypaste-mcp ~/.local/bin/Пример для macOS на Apple Silicon. Для Linux и Windows команды другие: на Linux архив называется keypaste-0.3.0-linux-x64.tar.gz, на Windows это zip. Контрольная сумма не подтверждает издателя.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент работает с паролями, токенами и ключами, а отданное агенту значение попадает в контекст модели и к ее поставщику
- Причину запроса пишет сам агент: человек, который отвечает на запрос, должен проверять ее каждый раз
- Опубликованные бинарники не подписаны и не нотаризованы, а версия до 1.0 содержит известные ограничения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
keypaste держит логины и переменные окружения проектов в одном файле формата KDBX 4, который открывает и KeePassXC. Аккаунта и сети хранилищу не нужно. Команда `keypaste init` создает файл, `keypaste add` и `keypaste get` работают с записями, `keypaste env pull` забирает значения из `.env`, а `keypaste run dev -- npm start` запускает программу с этими значениями в окружении, не оставляя их на диске. К агенту хранилище подключает мост `keypaste-mcp`: его запускает MCP-клиент, а сам мост хранилища не держит. В отдельном терминале вы открываете хранилище и отвечаете на запросы. Агент просит одно поле одной записи и называет причину, а вы выбираете: отказать, разрешить один раз или разрешить на час. Каждый запрос попадает в журнал с цепочкой хэшей. Команда `keypaste setup --vault ~/vault.kdbx` сама настраивает найденных клиентов через их `mcp add` или печатает блок конфигурации. Есть генератор паролей длиной от 8 до 256 символов, ротация командой `keypaste rotate` без вывода нового пароля, история изменений и зашифрованные резервные копии рядом с файлом.
Для кого. Для разработчиков, которые дают Claude Code или Codex работать с деплоем и API и не хотят, чтобы ключи лежали в `.env` на виду у агента.
Подходит, если
- Агенту нужен ключ для деплоя или запроса к API, и вы хотите видеть, какой ключ он просит и зачем
- Нужно запускать команды с секретами в окружении и не хранить `.env` в проекте: `keypaste run` кладет значения только в процесс
- У проекта несколько окружений: ключи dev, staging и prod задаются раздельно, и для prod нужен живой ответ человека
- Вы уже пользуетесь KeePassXC и хотите оставить прежнее хранилище, а агента подключить к нему через одобрение
- В CI нужен токен с областью вроде `read:acme-api/staging/*`, который только подставляет значения и истекает через 30 дней
Не подходит, если
- Нужна готовая командная работа с общим хранилищем: слияния и управляемой синхронизации нет, файл можно переносить только обычной синхронизацией файлов
- Нужен весь набор функций KeePassXC: совместимость с форматом KDBX не означает, что покрыты все его возможности
- Вы используете Intel Mac, Alpine или Windows на ARM: для них нет собранных файлов, установка возможна только из исходников
- Нужен подписанный и нотаризованный дистрибутив: опубликованные бинарники не подписаны и не нотаризованы
Пример запроса к агенту
Задеплой сервис биллинга на staging. Если понадобится ключ Stripe, запроси его у keypaste и объясни, зачем он нуженMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
KEYPASTE_VAULT- Путь к файлу хранилища, если не передан флаг --vault
Ограничения
Опубликован CLI и MCP версии `v0.3.0`, это версия до 1.0. У настольного приложения публичного выпуска нет. Многие функции, например ссылки для передачи и фраза-пароль, пока есть только в исходниках и в загрузку не входят. Автор просит заменить `v0.1.0` и `v0.2.0`: первая могла удалить хранилище через `env export`, изменить другую запись через `env rm` и вернуть неверный пароль через `get`. Во второй параллельное сохранение могло откатить чужую правку.
Контрольная сумма защищает от битой загрузки и не доказывает издателя, потому что лежит на том же адресе, что и архив. Для `v0.3.0` есть аттестация сборки, которую проверяет GitHub CLI. Команда `rm` в `v0.3.0` удаляет запись вместе с историей навсегда. Запуск через `--allow-run` отдает агенту вывод с замененными значениями, но команда, которую он может править, все равно способна раскрыть значение.
Требования: macOS 14 и новее, Windows 10 1809 и новее, Linux на glibc 2.35. Лицензия AGPL-3.0.
Как отключить. Выполните `keypaste setup --remove`, чтобы убрать keypaste из настроек найденных клиентов, или удалите запись keypaste из настроек MCP вручную. Файл хранилища останется на диске, и KeePassXC откроет его как обычно.
Частые вопросы
Как подключить keypaste к Claude Code?
Скачайте архив для своей системы, положите `keypaste` и `keypaste-mcp` в `~/.local/bin` и выполните `keypaste setup --vault ~/vault.kdbx`. Команда сама вызовет `mcp add` у найденных клиентов. Затем в терминале запустите команду одобрения и отвечайте на запросы агента.
Видит ли агент мой мастер-пароль?
Нет. В конфигурации клиента мастер-пароля нет, мост хранилища не держит. Хранилище открывается в вашем терминале, а агент получает только то поле, которое вы разрешили.
Как заменить .env?
Создайте хранилище `keypaste init ~/vault.kdbx`, задайте `export KEYPASTE_VAULT=~/vault.kdbx`, затем `keypaste env pull dev` и запускайте `keypaste run dev -- npm start`. Файл `.env` после импорта можно удалить, но резервные копии и носитель стирание не гарантируют.
Совместим ли файл с KeePassXC?
Да, это один файл KDBX 4, и KeePassXC открывает и правит тот же файл. Автор проверяет совместимость в обе стороны с `keypassxc-cli` на Linux, macOS и Windows, но не обещает полное покрытие возможностей KeePassXC.
Что делает prod особым случаем?
Для профиля prod всегда нужен живой ответ человека. Для остальных профилей можно разрешить на час, а в версии из исходников появилась возможность сделать проект автоматическим для конкретного агента с записью в историю.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный менеджер паролей с MCP-сервером: агент входит на сайты, по SSH и в API, а скрытые секреты не попадают в контекст модели
Mac-хранилище ключей для агентов: Sallyport выполняет HTTP и SSH с вашими ключами по MCP, а сам ключ агент не получает
Обертка над 1Password CLI: агент находит, использует и сохраняет секреты, не видя значений, и реже просит одобрения
Локальная панель для Claude Code, Codex CLI и OpenCode: что грузит агент, сколько это токенов, и проверка MCP-серверов
Шлюз для MCP-серверов: плагины маскировки известных секретов в текстовых ответах, проверки репутации и записи вызовов
Официальный MCP дает агенту операции с хранилищем Bitwarden и, при отдельных правах, администрацию организации.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| keypaste — хранилище секретов с одобрением для агентов (эта карточка) | нет | не нужна | 839 | |
| 2password | нет | 320 | обертка над 1Password CLI, у нее нет собственного хранилища | |
| HOL Guard | да | 1 072 | проверяет действия агента, включая чтение файлов с ключами, но не хранит секреты |
Коротко о README
Раздел о возможностях делит их на менеджер паролей и инструменты для разработчиков и агентов. Дальше показаны консольное окно одобрения и запись демонстрации. Затем идут команды установки по трем системам, проверка скачанного файла и сборка из исходников.